refactor: clarify skill completion and require verified local commits

This commit is contained in:
mujing
2026-09-16 14:11:00 +08:00
parent e126bd4f00
commit f2443a4855
3 changed files with 15 additions and 11 deletions
+8 -6
View File
@@ -1,15 +1,17 @@
---
name: execute-plan
description: 用户明确要求使用 execute-plan 时启用。执行已批准工程计划,验证目标与范围并完成本地 Git 提交。
description: 仅用户指定 execute-plan 时启用;实施已批准计划,验证、review 并完成本地 Git 提交。
---
# 执行已确认计划
在新会话按计划实施;不依赖旧讨论,也不强制子代理、worktree、TDD 或新依赖
完成条件:批准目标已实现,必要验证及 review 通过,本次变更已完成本地 Git 提交,并给出真实 commit hash。首次实现或测试通过不是终点,不以“可提交”或询问是否提交代替执行
在批准范围内自主完成实现、检查、修复和提交,不在各步骤间重复索要许可。保留下述范围变更与重大偏差的确认边界;具体实现和工具安排自行决定,不强制子代理、worktree 或 TDD。按新会话约定执行,不依赖旧讨论。
## 读取与核对
1. 完整读取用户指定计划;路径不明则询问,不猜最新文件。从计划定位或 `.agent/MEMORY.md` 确定资产根目录,读取根目录 `CONTEXT.md`,再核实项目约束、相关代码和测试。不推断根目录、不扫描历史计划;定位冲突或系统不符先澄清无 CONTEXT 时依靠计划与代码,不编造约束
1. 完整读取用户指定计划;路径不明则询问。从计划定位或 `.agent/MEMORY.md` 确定根目录并读 `CONTEXT.md`,再按任务核实代码、测试与项目约束;架构、数据、部署资料仅在涉及对应改动时读取,不扫描历史计划,避免无关的全仓库扫描。定位冲突或系统不符先澄清,不猜根目录;无 CONTEXT 时依靠计划与代码。
2. 核对计划批准依据、目标、范围与验收。基线变化先调查影响,无关更新不阻塞;关键缺口、未批准或实质冲突先澄清。已批准的规则迁移按计划执行,不因仍有旧规则重复确认。
3. 记录仓库身份、分支、HEAD(或无提交)及暂存/未暂存/未跟踪状态,足以区分用户已有修改。保护用户内容;重叠且不能隔离时先解决,不回退或混合提交。
@@ -51,8 +53,8 @@ Markdown 正文中代码、命令和多行配置用带语言标记的围栏代
1. 完成后重新完整读取原目标与批准计划,对照任务 diff:验收是否满足、保留行为是否成立、是否越界、是否影响调用方与错误路径。
2. 先从原始目标和验收推导正常、边界、异常及保留行为测试,断言依据需求而非复制实现逻辑;核对用例能否发现目标偏离,不只验证修改的代码是否按自身逻辑运行。复用已有测试、补真实缺口,不堆重复用例或追求覆盖率数字。运行计划要求及必要回归检查,文档变更用适当结构检查;记录实际证据,无变化且无新疑点时不重复运行。
3. Review 范围、正确性、模块职责/依赖边界及失效代码清理,修复本任务问题后重跑受影响检查。越界内容仅撤销能可靠隔离的自身改动。解决失败或环境阻碍如实报告,不宣称通过、不绕过检查提交;用户调整验证要求时记录差异。
3. 自行完成范围、正确性、模块边界及失效代码清理的 review;范围内问题直接修复,再跑受影响检查,不把首次 review 当作等待用户的关卡。越界内容仅撤销能可靠隔离的自身改动。无法在范围内解决失败或环境阻碍报告为未完成,不绕过检查提交;用户调整验证要求时记录差异。
根据实际 diff 与证据复核接口、数据、配置及新旧版本兼容性。需要特殊上线操作时列出前置条件、步骤顺序、验证点及必要回退限制;否则明确“无需特殊上线步骤或顺序”。未知或未验证部分如实标注,不把本地测试通过等同于上线兼容。涉及计划外迁移或行为变化时先更新计划并确认;评估不授权实际部署。
4. 仅暂存本任务文件/片段,检查完整暂存 diff,确保不含用户原有改动、MEMORY 或讨论资产。无法隔离或 MEMORY 已被跟踪时先解决,不擅自取消跟踪。
5. 按项目规范创建本地 commit;不 push、amend、跳过 hooks 或改 Git 身份。Hook 改动须重新检查验证。无差异不空提交,非 Git 项目不自行初始化;提交失败报告原因
6. 核实 commit hash提交文件工作区残余更新外部记录;简报交付、验证、兼容性结论、特殊上线步骤及顺序(或无需)、配套变化/批准偏差、限制及 hash(或未提交原因)。详细上线说明留在记录中并给链接。
5. 检查通过后,必须按项目规范执行本地 `git commit`;不 push、amend、跳过 hooks 或改 Git 身份。Hook 改动须重新检查验证。可在范围内修复的提交失败应修复重试;身份、权限等需用户处理的阻碍报告为“未完成提交”,保留现场。非 Git 项目不自行初始化;确实无任务差异时说明目标已满足及证据,不创建空提交
6. 读取实际 commit hash提交文件,确认本次变更均已提交、无混入用户内容;检查工作区残余更新外部记录。最终简报结果、验证、兼容性及上线顺序、偏差与 hash。若有本任务变更未提交,不得宣称执行完成;无关用户改动不影响本任务完成。详细结果给记录链接。