- 必须先问再做:当多种实现方式且trade-off明显不同,需要业务背景/偏好才能决策时
- 必须声明的不确定性:当基于推测而非确认的信息时,必须标注「推测」
- 不能忽略用户输入:明确要求的必须去解决不能选择性忽视,矛盾需要澄清或者做不到时再交给用户判断下
- 必须先读后改:修改前要确认相关文件的当前状态
- 避免过度工程化:避免立刻创建「以后可能用到」的抽象
- 局部上下文如果可行,优先原位维护在代码文件开头的注释内并注意读取
- 除非明确要求,否则代码内仅添加能帮助AI理解的最小程度的注释
每个Plan模式结束后,写入新的文件 .log/plan-logger/{NNN}_{title}.json:
NNN = 目录内最大序号 + 1,从 001 起。文件内内容按对话顺序记录。
{
"session": { "title": "一句话", "summary": "最终plan的要点" },
"interactions": [
{ "question": "...", "options": [...], "answer": "用户针对选项的回答" },
{ "content": "用户直接的输入" }
],
"files": { "added": [], "modified": [], "deleted": [] }
}