名称: ctx-实施 描述: “按步骤执行计划并进行验证。当您有计划文档并需要有条理、有检查点的实施时使用。”
获取一个计划(内联文本、文件路径或来自对话) 并按步骤执行,在步骤之间进行构建/测试验证。
何时使用
- 当用户提供计划文档或文件并说“实施这个”时
- 当多步骤任务已规划好并需要有条理地执行时
- 当用户希望有检查点进度并在每个步骤进行验证时
- 在
/brainstorm或计划模式产生批准的计划之后
何时不使用
- 对于单步任务——直接执行即可
- 当计划模糊或不完整时——先使用
/brainstorm进行完善 - 当用户想要探索或讨论,而不是执行时
- 当更改是微不足道的(拼写错误修复、配置调整)
使用示例
/ctx-implement
/ctx-implement path/to/plan.md
/ctx-implement (我们上面讨论的计划)
流程
1. 加载计划
- 如果提供了文件路径,则读取它
- 如果提供了内联文本,则直接使用
- 如果两者都没有,则在对话中查找最近期的计划或批准的设计
- 如果找不到任何计划,请向用户询问
2. 分解为步骤
将计划解析为离散的、可检查的步骤。每个步骤应满足:
- 原子性:一个逻辑更改(一个文件、一个函数、一个测试)
- 可验证性:有明确的通过/失败检查
- 有序性:尊重依赖关系(先创建后使用,先实现后测试)
向用户呈现步骤列表以进行确认:
实施计划 (N 步):
- [步骤描述] — 验证: [检查]
- [步骤描述] — 验证: [检查]
- …
准备开始了吗?
3. 按步骤执行
对于每个步骤:
- 宣布 您要做什么(一行)
- 思考 在编写代码之前仔细考虑更改——它涉及什么,可能破坏什么,最简单的正确路径是什么?
- 实施 更改
- 验证 使用适当的检查:
- Go 代码更改 →
CGO_ENABLED=0 go build -o /dev/null ./cmd/ctx - 受影响的测试 →
CGO_ENABLED=0 go test ./... - 配置/模板更改 → 构建以验证嵌入
- 仅文档 → 无需验证
- Go 代码更改 →
- 报告 步骤结果:通过或失败
- 如果失败:停止、诊断、修复、重新验证,然后再进入下一步
请勿跳过验证。请勿在没有检查的情况下批量执行多个步骤。
4. 检查点进度
每完成 3-5 个步骤(或达到一个重要里程碑)后:
- 总结已完成的内容
- 注意与计划的任何偏差
- 询问用户是否希望继续、调整或停止
5. 收尾
所有步骤完成后:
- 运行最终全面验证 (
make check或CGO_ENABLED=0 go build && go test ./...) - 总结已实施的内容
- 注意与原始计划的任何偏差
- 建议需要持久化的上下文(决策、经验教训、任务)
步骤验证映射表
| 更改类型 | 验证命令 |
|---|---|
| Go 源代码 | CGO_ENABLED=0 go build -o /dev/null ./cmd/ctx |
| 测试文件 | CGO_ENABLED=0 go test ./... |
| 模板/嵌入 | CGO_ENABLED=0 go build -o /dev/null ./cmd/ctx |
| Makefile | 运行新的/更改的目标 |
| 技能文件 | 构建(以验证嵌入)+ 检查实时副本是否匹配 |
| 仅文档/标记语言 | 无需验证 |
| Shell 脚本 | bash -n script.sh (语法检查) |
处理失败
当步骤验证失败时:
- 不要惊慌——仔细阅读错误输出
- 逐步推理 失败原因,然后再尝试修复;理解原因,而不仅仅是症状
- 修复 当前步骤中的问题
- 重新验证 修复
- 只有这样 才能进入下一步
- 如果修复更改了计划,请注意偏差
如果一个步骤反复失败(3 次以上尝试),请停止并向用户寻求指导,而不是盲目尝试。
输出格式
进度更新应简明扼要:
步骤 1/6: 创建 ctx-next 技能目录 .......... 通过
步骤 2/6: 编写 SKILL.md 模板 .................. 通过
步骤 3/6: 复制到实时技能目录 ............. 通过
步骤 4/6: 构建以验证模板嵌入 .......... 通过
步骤 5/6: 运行测试 ................................ 通过
步骤 6/6: 在 TASKS.md 中标记任务 .................... 通过
所有 6 个步骤完成。构建和测试通过。
示例
良好实施
步骤 3/8: 向 Makefile 添加
check目标 在audit目标后添加了check: build audit。 验证:make check… 构建通过,审计通过。 结果: 通过
不良实施
“我现在就实施整个计划” [一次性进行所有更改,没有验证] “完成!一切应该都能工作。”
(没有逐步执行,没有验证,没有检查点——这违背了该技能的目的。)
质量检查清单
开始前,请验证:
- [ ] 计划存在且足够清晰可以执行
- [ ] 步骤已分解并呈现给用户
- [ ] 用户确认准备就绪
执行期间,请验证:
- [ ] 每个步骤在继续之前都经过验证
- [ ] 失败在原地修复,不推迟
- [ ] 每 3-5 个步骤进行一次检查点
完成后,请验证:
- [ ] 最终全面验证通过
- [ ] 注意与计划的偏差
- [ ] 呈现已实施内容的摘要
- [ ] 如果合理,建议持久化上下文