refactor: keep plans goal-focused and date discussion assets

2026-09-10 10:14:47 +08:00
parent a6c2da2d87
commit 1846cb90ca
3 changed files with 23 additions and 4 deletions
@@ -30,6 +30,8 @@ npx skills add . --skill align-plan --skill execute-plan

 Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简的当前决策。范围明显变大时，会提出分阶段建议供用户选择。关键问题解决后，展示完整计划，由用户确认后保存。

+计划列出修改文件、目标、原因和验收要求，不预写详细实现代码。核心算法可附少量代码或伪代码帮助审查；具体实现由执行 agent 在已批准的行为和架构边界内自主决定。
+
 随后自行开启新会话，指定保存的计划：

 ```text
@@ -57,6 +59,14 @@ Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简

 新的批准版本另存。当前决策随讨论更新，不累计聊天全文；执行记录不能覆盖已批准计划。目录失效或无法写入时会报告，不自行改存代码库。个人绝对路径不写入可分发的 skill。

+每份生成的 Markdown 资产（包括本地 MEMORY）第一行保留决策日期注释：
+
+```markdown
+<!-- 决策日期：2026-09-10 -->
+```
+
+日期对应资产所依据的决策，使用用户当地日期。未确认草稿先记创建日期，正文标明待确认；确认后更新为确认日期。已批准计划保留原日期，新版本使用新确认日期；实施记录沿用计划决策日期，执行时间单独记录。纯进度或排版更新不改决策日期。
+
 ## 验证

 结构检查：
@@ -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 个问题对齐工程目标，纠
 无变化的类别明确注明；必要事实来源；已确认的假设。

 ## 文件与步骤
-预计新增、修改、删除的仓库相对路径及各自目的。
-按依赖顺序列实施任务，每项关联验收条件。
+预计新增、修改、删除的仓库相对路径、修改目标与原因。
+按必要依赖顺序列目标级任务，每项关联验收条件，不预写详细代码。
 允许为已批准目标补充必要测试或配置文件，须记录理由；
 其他范围扩展、业务行为、公共接口或架构变化需重新确认。

@@ -15,12 +15,15 @@ description: 在新会话中读取用户指定的已确认工程计划，按范
 4. 记录实施前分支、HEAD（或尚无提交）、暂存、未暂存和未跟踪文件，保留足够的基线信息区分用户已有改动。不能覆盖、回退或替用户提交无关内容。若与任务重叠且无法可靠隔离，先解决冲突。
 5. 实施记录默认写在指定计划旁的独立 `execution-日期时间.md`，包含计划版本、基线、进度和证据，不覆盖已有记录。该位置必须符合用户的外部资产约定；位置不明时读取 `.agent/MEMORY.md` 或询问。目录不可用时报告问题，不回退到代码目录，不把资产混入 Git 提交。

+每份生成资产的第一行使用 `<!-- 决策日期：YYYY-MM-DD -->`。实施记录沿用所依据计划的决策日期，执行时间另记正文；补充计划或新批准版本用用户当地的实际确认日期。纯进度、证据或排版更新不改决策日期。旧计划缺少顶部注释时，优先从真实确认依据确定日期并记录在新资产中，不擅自改写批准计划；日期无法确定时注明待核实，不编造日期或用执行当天冒充。日期缺失本身不等于缺少批准。
+
 若当前会话还保留规划讨论，提醒用户新会话约定；不能假称已经清空上下文。无论宿主是否能识别会话边界，都以计划和重新读取的代码为依据。宿主处于只读或计划模式时遵从限制，不执行变更。

 ## 实施边界

 - 按计划依赖顺序推进；每项改动必须能解释为完成一个批准任务或验收条件。优先复用代码库、标准库和平台现有能力。
- 在批准范围内自主解决实现细节、修复本任务引入的问题，不每一步都索要许可。
+- 根据计划中的文件修改目标、原因和验收要求，自主决定具体实现代码、内部组织和局部实现方式；计划不需要包含详细代码，不因缺少代码而要求用户补齐。核心算法片段用于理解已批准算法约束，可采用满足同一约束的实现，不要求逐字照抄。
+- 在批准范围内自主解决实现细节、修复本任务引入的问题，不每一步都索要许可；实现自由度不改变已批准的业务、接口、架构与范围约束。
 - 可补充达成已批准目标所必需的测试或配置文件，在实施记录中说明文件、原因及对应验收条件。文件扩展不能成为更改业务行为、公共接口、架构、升级依赖或扩大验收范围的借口。
 - 其他未计划的文件改动或实质范围变化，先展示所需变化与原因，取得确认后保存补充计划或新版本，再继续受影响工作。保留原批准版本，不为解释已发生的越界改动而重写计划。
 - 发现无关问题时只在记录中注明“本次未处理”；不要顺手重构、清理、格式化整个仓库或修复旁支问题。