diff --git a/README.md b/README.md index ac885ab..352b906 100644 --- a/README.md +++ b/README.md @@ -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 + +``` + +日期对应资产所依据的决策，使用用户当地日期。未确认草稿先记创建日期，正文标明待确认；确认后更新为确认日期。已批准计划保留原日期，新版本使用新确认日期；实施记录沿用计划决策日期，执行时间单独记录。纯进度或排版更新不改决策日期。 + ## 验证 结构检查： diff --git a/skills/align-plan/SKILL.md b/skills/align-plan/SKILL.md index 8b9e589..f0a006d 100644 --- a/skills/align-plan/SKILL.md +++ b/skills/align-plan/SKILL.md @@ -15,6 +15,7 @@ description: 通过代码调查和每轮 1–3 个问题对齐工程目标，纠 4. MEMORY 只保存必要定位信息，例如： ```markdown + ## 讨论资产 - 讨论资产目录：/用户指定的绝对路径 ``` @@ -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 注释：``。填入用户当地日期，表示该资产所依据决策的日期；尚无确认决策的草稿先记创建日期，正文仍标记待确认。确认或新决策改变当前资产内容时更新日期；纯排版、补证据或执行进度更新不改变决策日期。已批准计划保留原日期，新版本记录新确认日期；实施记录使用其所依据的计划决策日期。 + 宿主限制写入时，遵从限制，在对话中维护当前状态并明确尚未落盘；不要把未保存资产说成已保存。资产维护是规划阶段唯一的写入范围，不能开始项目实现。 ## 调查与问答 @@ -48,9 +51,12 @@ description: 通过代码调查和每轮 1–3 个问题对齐工程目标，纠 当目标、边界、关键实现选择和验收都明确，且没有影响实施的未决问题时停止提问。不为凑问题继续访谈。 -展示完整候选计划，一次让用户确认。计划至少包含以下信息，简单任务可合并段落，不填充无意义章节： +展示完整候选计划，一次让用户确认。计划以文件的修改目标、原因和验收要求为主，不写完整函数、逐行补丁或详细实现代码。仅当核心算法需要代码帮助用户审查时，保留少量代码或伪代码片段，并说明其表达的算法约束；片段不是必须照抄的实现。具体编码、内部组织等细节交给执行 agent 在已批准边界内决策，不把缺少详细代码当作计划未完成。 + +计划至少包含以下信息，简单任务可合并段落，不填充无意义章节： ```markdown + # 任务名称 ## 定位与确认 @@ -67,8 +73,8 @@ description: 通过代码调查和每轮 1–3 个问题对齐工程目标，纠 无变化的类别明确注明；必要事实来源；已确认的假设。 ## 文件与步骤 -预计新增、修改、删除的仓库相对路径及各自目的。 -按依赖顺序列实施任务，每项关联验收条件。 +预计新增、修改、删除的仓库相对路径、修改目标与原因。 +按必要依赖顺序列目标级任务，每项关联验收条件，不预写详细代码。 允许为已批准目标补充必要测试或配置文件，须记录理由； 其他范围扩展、业务行为、公共接口或架构变化需重新确认。 diff --git a/skills/execute-plan/SKILL.md b/skills/execute-plan/SKILL.md index c1bc8ca..d347f62 100644 --- a/skills/execute-plan/SKILL.md +++ b/skills/execute-plan/SKILL.md @@ -15,12 +15,15 @@ description: 在新会话中读取用户指定的已确认工程计划，按范 4. 记录实施前分支、HEAD（或尚无提交）、暂存、未暂存和未跟踪文件，保留足够的基线信息区分用户已有改动。不能覆盖、回退或替用户提交无关内容。若与任务重叠且无法可靠隔离，先解决冲突。 5. 实施记录默认写在指定计划旁的独立 `execution-日期时间.md`，包含计划版本、基线、进度和证据，不覆盖已有记录。该位置必须符合用户的外部资产约定；位置不明时读取 `.agent/MEMORY.md` 或询问。目录不可用时报告问题，不回退到代码目录，不把资产混入 Git 提交。 +每份生成资产的第一行使用 ``。实施记录沿用所依据计划的决策日期，执行时间另记正文；补充计划或新批准版本用用户当地的实际确认日期。纯进度、证据或排版更新不改决策日期。旧计划缺少顶部注释时，优先从真实确认依据确定日期并记录在新资产中，不擅自改写批准计划；日期无法确定时注明待核实，不编造日期或用执行当天冒充。日期缺失本身不等于缺少批准。 + 若当前会话还保留规划讨论，提醒用户新会话约定；不能假称已经清空上下文。无论宿主是否能识别会话边界，都以计划和重新读取的代码为依据。宿主处于只读或计划模式时遵从限制，不执行变更。 ## 实施边界 - 按计划依赖顺序推进；每项改动必须能解释为完成一个批准任务或验收条件。优先复用代码库、标准库和平台现有能力。 -- 在批准范围内自主解决实现细节、修复本任务引入的问题，不每一步都索要许可。 +- 根据计划中的文件修改目标、原因和验收要求，自主决定具体实现代码、内部组织和局部实现方式；计划不需要包含详细代码，不因缺少代码而要求用户补齐。核心算法片段用于理解已批准算法约束，可采用满足同一约束的实现，不要求逐字照抄。 +- 在批准范围内自主解决实现细节、修复本任务引入的问题，不每一步都索要许可；实现自由度不改变已批准的业务、接口、架构与范围约束。 - 可补充达成已批准目标所必需的测试或配置文件，在实施记录中说明文件、原因及对应验收条件。文件扩展不能成为更改业务行为、公共接口、架构、升级依赖或扩大验收范围的借口。 - 其他未计划的文件改动或实质范围变化，先展示所需变化与原因，取得确认后保存补充计划或新版本，再继续受影响工作。保留原批准版本，不为解释已发生的越界改动而重写计划。 - 发现无关问题时只在记录中注明“本次未处理”；不要顺手重构、清理、格式化整个仓库或修复旁支问题。