用途
/work 是 cskwork/backend-dev-skills 中的主开发技能,用于实现已批准的 backend exploration plan。它消费 /explore 技能产出的探索契约,把它转化为已交付的代码,同时避免重新决定范围、重新发现模式或扩大影响面(blast radius)。
核心原则:探索报告即契约,实现遵循契约。如果契约有误或不充分,应停止并更新契约,而不是在代码中即兴发挥。
何时使用
当以下三个条件同时满足时调用 /work:
- 已针对当前请求运行过 /explore。
- 探索报告存在于 <artifact-root>/.backend/<YYYYMM>/<slug>/explore.md。
- 用户已审阅并批准该计划,或已明确要求继续。
若缺少任一条件,不应运行 /work:尚无报告则先运行 /explore;报告存在但批准状态不明确,则询问 slug 并确认实现意图;用户只想改一行或修错别字,则直接做,跳过这两个技能。
主要能力
该技能围绕“契约”执行严格的六阶段流程:
- 阶段 0 —— 加载并验证契约:完整读取 explore.md,确认 kind(Bug / Feature / Refactor)与范围,验证 §7 提出具体文件行、§9 测试计划指名具体文件或测试类、§10 无未解决的 [BLOCK] 项。
- 阶段 1 —— 复用与纪律复查:重新验证 §6 的复用决策,对新增工具/DTO/服务重新搜索;对 extend 项重新列出调用者;对共享工具修改要求显式调用者普查。
- 阶段 2 —— TDD 实现:行为变更遵循 Red → Green → Verify → Refactor,行为保持型重构建立通过的刻画性覆盖。
- 阶段 3 —— 精细审查:审查每处 diff,确认每行可追溯到 §7,清理仅用于支撑已删除内容的导入/变量/助手。
- 阶段 4 —— 证据优先的验证:记录命令、实际结果与证据位置。
- 阶段 5 —— 配对文档:写入 work.md 与面向人的 docs 条目。
使用方式
该技能要求输入包括:explore.md(提取 §2 元信息、§5 根因或模式、§6 复用清单、§7 提出变更、§8 影响面、§9 测试计划、§10 未决问题、§11 回滚)、用户最新消息、服务自身的 CLAUDE.md、项目根 CLAUDE.md。
完成时要求三类输出:依据 §7 的代码变更;工作日志 <artifact-root>/.backend/<YYYYMM>/<slug>/work.md;面向人的变更说明 <artifact-root>/docs/features/<YYYY-MM-DD>-<slug>.md(功能/重构)或 <artifact-root>/docs/bugs/<YYYY-MM-DD>-<slug>.md(缺陷修复)。
适用场景
适用于已通过 /explore 完成探索并获得批准的 backend 开发任务,包括缺陷修复、功能实现与重构。可与同管道中的 explore(必需前驱)、verify(典型后继)配合使用。
限制
该技能定义了铁律:未加载并内化探索报告前不得改动代码;未掌握新鲜验证证据前不得声称完成;未写入 work.md 与 docs 条目前不得退出技能。质量门禁要求:完成 = explore.md §7 每一行已实现或显式跳过并说明原因,§9 测试/检查有新鲜输出,work.md 与 docs 条目存在;范围 = 仅限 §7 文件/工作单元加已批准的胶水代码,§7 之外的新文件/符号属于范围漂移,需用户或计划批准。失败类型包括 FAIL-SCOPE、FAIL-TEST、FAIL-ENV、FAIL-CONTRACT,其中 FAIL-SCOPE/FAIL-CONTRACT 需停止编码并返回 /explore 或用户批准,不得静默扩大实现。范围内包括 §7 列出的代码变更、§9 命名的测试、技能结束、运行测试/检查/构建、以互不重叠的所有权派发子代理;范围外包括 §7 之外的任何重构、无关文件的覆盖率提升、样式重命名/重排、运行迁移/触碰生产数据库/部署等。技能结束后不提交、不推送、不开启 PR,除非用户明确要求。
关于具体堆栈护栏、复用纪律程序与收尾模板,资料指向本目录中的 reuse-discipline.md、implementation-playbook.md、wrap-up-template.md,但未提供其内容。