fix: use YAML asset metadata and flat plan directories
This commit is contained in:
@@ -15,15 +15,19 @@ description: 通过代码调查和每轮 1–3 个问题对齐工程目标,纠
|
||||
4. MEMORY 只保存必要定位信息,例如:
|
||||
|
||||
```markdown
|
||||
<!-- 决策日期:YYYY-MM-DD -->
|
||||
---
|
||||
系统: 项目或系统名称
|
||||
时间: YYYY-MM-DD
|
||||
目标: 保存讨论资产位置
|
||||
---
|
||||
## 讨论资产
|
||||
- 讨论资产目录:/用户指定的绝对路径
|
||||
```
|
||||
|
||||
写入前检查 MEMORY 是否被 Git 跟踪;已跟踪则说明与“不提交本地记忆”的冲突,先解决冲突,不自行取消跟踪。未跟踪时在 `git rev-parse --git-path info/exclude` 指向的本地排除文件中幂等加入 `/.agent/MEMORY.md`,不改共享 `.gitignore`。非 Git 项目仍保留本地记忆,并说明当前无法设置 Git 排除。
|
||||
5. 在外部根目录中建立 `<项目标识>/<日期-任务主题>/`。项目标识结合仓库名和路径区分同名项目,任务目录冲突时使用新名称,不覆盖其他任务。核心文件为 `current.md` 和确认后生成的 `plan-v1.md`;后续确认版本另存,不覆盖旧批准版本。
|
||||
5. 严格使用用户指定目录作为资产根目录,可直接在其中建立 `<日期-计划主题>/`,不再插入项目名、系统名等中间目录。若用户已指定本次计划目录,直接使用,不再次嵌套。恢复同一计划时复用已有目录;新计划名称冲突时只调整计划目录名,不覆盖其他计划。核心文件为 `current.md` 和确认后生成的 `plan-v1.md`;后续确认版本另存,不覆盖旧批准版本。
|
||||
|
||||
每份生成资产(当前决策、计划、实施记录及其他讨论文档,包括 MEMORY)第一行使用 Markdown 支持的 HTML 注释:`<!-- 决策日期:YYYY-MM-DD -->`。填入用户当地日期,表示该资产所依据决策的日期;尚无确认决策的草稿先记创建日期,正文仍标记待确认。确认或新决策改变当前资产内容时更新日期;纯排版、补证据或执行进度更新不改变决策日期。已批准计划保留原日期,新版本记录新确认日期;实施记录使用其所依据的计划决策日期。
|
||||
每份生成资产(当前决策、计划、实施记录及其他讨论文档,包括 MEMORY)顶部使用下方模板中的 YAML frontmatter,按顺序包含 `系统`、`时间`、`目标`,不使用 HTML 注释。系统填写项目或系统名称,目标用一句话概括该资产对应的目标;无法确定的字段留空,不编造。时间采用用户当地的 `YYYY-MM-DD` 日期,表示该资产所依据决策的日期;尚无确认决策的草稿先记创建日期,正文仍标记待确认。确认或新决策改变当前资产内容时更新日期;纯排版、补证据或执行进度更新不改变决策日期。已批准计划保留原日期,新版本记录新确认日期;实施记录使用其所依据的计划决策日期。字段值包含 YAML 特殊字符时使用引号,保证元数据可解析。
|
||||
|
||||
宿主限制写入时,遵从限制,在对话中维护当前状态并明确尚未落盘;不要把未保存资产说成已保存。资产维护是规划阶段唯一的写入范围,不能开始项目实现。
|
||||
|
||||
@@ -56,7 +60,11 @@ description: 通过代码调查和每轮 1–3 个问题对齐工程目标,纠
|
||||
计划至少包含以下信息,简单任务可合并段落,不填充无意义章节:
|
||||
|
||||
```markdown
|
||||
<!-- 决策日期:YYYY-MM-DD -->
|
||||
---
|
||||
系统: 项目或系统名称
|
||||
时间: YYYY-MM-DD
|
||||
目标: 本次计划要达成的目标
|
||||
---
|
||||
# 任务名称
|
||||
|
||||
## 定位与确认
|
||||
|
||||
Reference in New Issue
Block a user