我在开发的时候经常遇到一个问题:有时突然冒出一个新需求,优先级一插队,之前记着“以后再修”的技术债就慢慢忘掉了。或者休假回来,一时想不起开发到哪了。 于是我想,有没有什么办法能让 agent 知道当前的开发状态——就做了这样一个 skill:通过维护一个 state 文档,记录当前的开发位置。 指令核心就两句: 开工:先读 docs/ STATE.md 。 收工:把 docs/ STATE.md 同步到实际进展。 STATE.md 是单文件状态页,分六节: 节 放什么 GOAL 大方向,一句话(可选——没定过就不写) NOW 现在在干嘛,卡在哪 NEXT 接下来做什么,每条带验收标准 DEBT 欠的债,每条带“为什么不修 + 什么情况该修” LOG 走过了什么,每行带一句为什么 MAP 相关的文件路径 GOAL 是大方向,NOW 是当前焦点——一个是去哪,一个是走到了哪。只记用户原话,agent 不自己发明目标。 ...