ctx-实施Skill ctx-implement

ctx-实施技能是一个用于软件开发流程管理的工具,专注于将复杂的实施计划分解为可验证的原子步骤,并在每个步骤后进行构建和测试验证。该技能强调有条理、有检查点的执行方式,确保代码质量,防止错误累积,适用于需要高可靠性的软件开发、DevOps流程和持续集成场景。关键词:软件开发、实施计划、步骤验证、构建测试、DevOps、代码质量、原子步骤、检查点、流程管理。

DevOps 0 次安装 0 次浏览 更新于 2/27/2026

名称: ctx-实施 描述: “按步骤执行计划并进行验证。当您有计划文档并需要有条理、有检查点的实施时使用。”

获取一个计划(内联文本、文件路径或来自对话) 并按步骤执行,在步骤之间进行构建/测试验证。

何时使用

  • 当用户提供计划文档或文件并说“实施这个”时
  • 当多步骤任务已规划好并需要有条理地执行时
  • 当用户希望有检查点进度并在每个步骤进行验证时
  • /brainstorm 或计划模式产生批准的计划之后

何时不使用

  • 对于单步任务——直接执行即可
  • 当计划模糊或不完整时——先使用 /brainstorm 进行完善
  • 当用户想要探索或讨论,而不是执行时
  • 当更改是微不足道的(拼写错误修复、配置调整)

使用示例

/ctx-implement
/ctx-implement path/to/plan.md
/ctx-implement (我们上面讨论的计划)

流程

1. 加载计划

  • 如果提供了文件路径,则读取它
  • 如果提供了内联文本,则直接使用
  • 如果两者都没有,则在对话中查找最近期的计划或批准的设计
  • 如果找不到任何计划,请向用户询问

2. 分解为步骤

将计划解析为离散的、可检查的步骤。每个步骤应满足:

  • 原子性:一个逻辑更改(一个文件、一个函数、一个测试)
  • 可验证性:有明确的通过/失败检查
  • 有序性:尊重依赖关系(先创建后使用,先实现后测试)

向用户呈现步骤列表以进行确认:

实施计划 (N 步):

  1. [步骤描述] — 验证: [检查]
  2. [步骤描述] — 验证: [检查]

准备开始了吗?

3. 按步骤执行

对于每个步骤:

  1. 宣布 您要做什么(一行)
  2. 思考 在编写代码之前仔细考虑更改——它涉及什么,可能破坏什么,最简单的正确路径是什么?
  3. 实施 更改
  4. 验证 使用适当的检查:
    • Go 代码更改 → CGO_ENABLED=0 go build -o /dev/null ./cmd/ctx
    • 受影响的测试 → CGO_ENABLED=0 go test ./...
    • 配置/模板更改 → 构建以验证嵌入
    • 仅文档 → 无需验证
  5. 报告 步骤结果:通过或失败
  6. 如果失败:停止、诊断、修复、重新验证,然后再进入下一步

请勿跳过验证。请勿在没有检查的情况下批量执行多个步骤。

4. 检查点进度

每完成 3-5 个步骤(或达到一个重要里程碑)后:

  • 总结已完成的内容
  • 注意与计划的任何偏差
  • 询问用户是否希望继续、调整或停止

5. 收尾

所有步骤完成后:

  • 运行最终全面验证 (make checkCGO_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 (语法检查)

处理失败

当步骤验证失败时:

  1. 不要惊慌——仔细阅读错误输出
  2. 逐步推理 失败原因,然后再尝试修复;理解原因,而不仅仅是症状
  3. 修复 当前步骤中的问题
  4. 重新验证 修复
  5. 只有这样 才能进入下一步
  6. 如果修复更改了计划,请注意偏差

如果一个步骤反复失败(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 个步骤进行一次检查点

完成后,请验证:

  • [ ] 最终全面验证通过
  • [ ] 注意与计划的偏差
  • [ ] 呈现已实施内容的摘要
  • [ ] 如果合理,建议持久化上下文