fix: use YAML asset metadata and flat plan directories

2026-09-10 10:29:21 +08:00
parent 07f1e7f7f3
commit c0ec550309
3 changed files with 37 additions and 16 deletions
@@ -35,7 +35,7 @@ Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简
 随后自行开启新会话，指定保存的计划：

 ```text
-使用 execute-plan 执行 /绝对路径/工程讨论/项目/任务/plan-v1.md
+使用 execute-plan 执行 /绝对路径/工程讨论/2026-09-10-pagination-fix/plan-v1.md
 ```

 支持命令式调用的宿主也可使用对应的 skill 命令，具体语法以宿主为准。Skill 不负责自动创建新会话，也不能保证检测或清除旧上下文。
@@ -46,26 +46,29 @@ Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简

 首次未指定资产目录时会询问；之后从项目 `.agent/MEMORY.md` 复用。这个文件只保存必要定位信息，通过 Git 本地 exclude 排除，不修改项目共享 `.gitignore`。已被跟踪时会先报告冲突，不自行取消跟踪。

-讨论资产默认位于用户选择的代码库外部目录：
+讨论资产严格使用用户选择的代码库外部目录，可按计划建立一层子目录，不添加项目名或系统名中间层。用户已指定本次计划目录时直接使用：

 ```text
 资产根目录/
-  项目标识/
-    日期-任务主题/
-      current.md                 当前目标、确认决策、约束与未决问题
-      plan-v1.md                 已确认、自包含的计划
-      execution-日期时间.md       实施与验证记录
+  日期-计划主题/
+    current.md                   当前目标、确认决策、约束与未决问题
+    plan-v1.md                   已确认、自包含的计划
+    execution-日期时间.md         实施与验证记录
 ```

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

-每份生成的 Markdown 资产（包括本地 MEMORY）第一行保留决策日期注释：
+每份生成的 Markdown 资产（包括本地 MEMORY）顶部保留以下 YAML 元数据：

 ```markdown
-<!-- 决策日期：2026-09-10 -->
+---
+系统:
+时间: 2026-09-08
+目标:
+---
 ```

-日期对应资产所依据的决策，使用用户当地日期。未确认草稿先记创建日期，正文标明待确认；确认后更新为确认日期。已批准计划保留原日期，新版本使用新确认日期；实施记录沿用计划决策日期，执行时间单独记录。纯进度或排版更新不改决策日期。
+系统填写项目或系统名称，目标概括对应计划的目标，无法确定时留空。时间对应资产所依据的决策，使用用户当地日期。未确认草稿先记创建日期，正文标明待确认；确认后更新为确认日期。已批准计划保留原日期，新版本使用新确认日期；实施记录沿用计划决策日期，执行时间单独记录。纯进度或排版更新不改决策日期。

 ## 验证