refactor: keep plans goal-focused and date discussion assets
This commit is contained in:
@@ -15,6 +15,7 @@ description: 通过代码调查和每轮 1–3 个问题对齐工程目标,纠
|
||||
4. MEMORY 只保存必要定位信息,例如:
|
||||
|
||||
```markdown
|
||||
<!-- 决策日期:YYYY-MM-DD -->
|
||||
## 讨论资产
|
||||
- 讨论资产目录:/用户指定的绝对路径
|
||||
```
|
||||
@@ -22,6 +23,8 @@ description: 通过代码调查和每轮 1–3 个问题对齐工程目标,纠
|
||||
写入前检查 MEMORY 是否被 Git 跟踪;已跟踪则说明与“不提交本地记忆”的冲突,先解决冲突,不自行取消跟踪。未跟踪时在 `git rev-parse --git-path info/exclude` 指向的本地排除文件中幂等加入 `/.agent/MEMORY.md`,不改共享 `.gitignore`。非 Git 项目仍保留本地记忆,并说明当前无法设置 Git 排除。
|
||||
5. 在外部根目录中建立 `<项目标识>/<日期-任务主题>/`。项目标识结合仓库名和路径区分同名项目,任务目录冲突时使用新名称,不覆盖其他任务。核心文件为 `current.md` 和确认后生成的 `plan-v1.md`;后续确认版本另存,不覆盖旧批准版本。
|
||||
|
||||
每份生成资产(当前决策、计划、实施记录及其他讨论文档,包括 MEMORY)第一行使用 Markdown 支持的 HTML 注释:`<!-- 决策日期:YYYY-MM-DD -->`。填入用户当地日期,表示该资产所依据决策的日期;尚无确认决策的草稿先记创建日期,正文仍标记待确认。确认或新决策改变当前资产内容时更新日期;纯排版、补证据或执行进度更新不改变决策日期。已批准计划保留原日期,新版本记录新确认日期;实施记录使用其所依据的计划决策日期。
|
||||
|
||||
宿主限制写入时,遵从限制,在对话中维护当前状态并明确尚未落盘;不要把未保存资产说成已保存。资产维护是规划阶段唯一的写入范围,不能开始项目实现。
|
||||
|
||||
## 调查与问答
|
||||
@@ -48,9 +51,12 @@ description: 通过代码调查和每轮 1–3 个问题对齐工程目标,纠
|
||||
|
||||
当目标、边界、关键实现选择和验收都明确,且没有影响实施的未决问题时停止提问。不为凑问题继续访谈。
|
||||
|
||||
展示完整候选计划,一次让用户确认。计划至少包含以下信息,简单任务可合并段落,不填充无意义章节:
|
||||
展示完整候选计划,一次让用户确认。计划以文件的修改目标、原因和验收要求为主,不写完整函数、逐行补丁或详细实现代码。仅当核心算法需要代码帮助用户审查时,保留少量代码或伪代码片段,并说明其表达的算法约束;片段不是必须照抄的实现。具体编码、内部组织等细节交给执行 agent 在已批准边界内决策,不把缺少详细代码当作计划未完成。
|
||||
|
||||
计划至少包含以下信息,简单任务可合并段落,不填充无意义章节:
|
||||
|
||||
```markdown
|
||||
<!-- 决策日期:YYYY-MM-DD -->
|
||||
# 任务名称
|
||||
|
||||
## 定位与确认
|
||||
@@ -67,8 +73,8 @@ description: 通过代码调查和每轮 1–3 个问题对齐工程目标,纠
|
||||
无变化的类别明确注明;必要事实来源;已确认的假设。
|
||||
|
||||
## 文件与步骤
|
||||
预计新增、修改、删除的仓库相对路径及各自目的。
|
||||
按依赖顺序列实施任务,每项关联验收条件。
|
||||
预计新增、修改、删除的仓库相对路径、修改目标与原因。
|
||||
按必要依赖顺序列目标级任务,每项关联验收条件,不预写详细代码。
|
||||
允许为已批准目标补充必要测试或配置文件,须记录理由;
|
||||
其他范围扩展、业务行为、公共接口或架构变化需重新确认。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user