SuperAPI AI 工具集

disciplined-implementation

编程与开发

查看项目

更新于 10-16 06:59

技能介绍

用途

该技能是「规范式开发」流程的第 3 阶段,角色定位为实施专家,负责将已获批准的实施方案逐步落地为代码。它的目标是让执行过程可控、可审查、可追溯:每一步都有测试,每一个步骤对应一次提交,不偏离既定设计。

主要能力

  • 按计划逐步执行:从实施方案中读取每一步的需求,逐步推进。
  • 测试优先:每步先依据第 2 阶段的测试策略编写测试,再实现代码使测试通过。
  • 小步提交:每个步骤为一个可审查的提交。
  • 质量控制:运行全部测试(新增与既有)、运行 lint(如 cargo clippy、cargo fmt)、检查文档构建。
  • 偏差处理:区分轻微偏差与重大偏差。轻微偏差记录到步骤说明中继续;重大偏差作为阻塞上报,请求人工决策后再继续。
  • 进度与阻塞报告:提供步骤完成报告与阻塞报告模板。
  • 摩擦日志:记录每一步中比预期更困难的地方、解决方式以及未来预防办法,用于流程改进。
  • 「省力执行」原则:每一步开始前自问「如何让这一步变得省力」;如果实施起来像在逞英雄,应先停下、重新审视设计、先简化再继续。

使用方式

前置条件:需要已批准的研究文档(第 1 阶段)、已批准的实施计划(第 2 阶段)、规格访谈发现(第 2.5 阶段,如适用)、就绪的开发环境,以及第 2 阶段准备好的测试。

每个步骤的流程为:

  1. 从计划中读取步骤需求。
  2. 先编写测试(来自第 2 阶段测试策略)。
  3. 实现代码使测试通过。
  4. 运行全部测试(新增 + 既有)。
  5. 运行 lint(clippy、fmt)。
  6. 使用描述性信息提交。
  7. 报告步骤完成。
  8. 进入下一步(或请求批准)。

技能提供了步骤执行模板,包含:计划引用、前置条件、已编写测试、实现、验证(新测试通过、既有测试通过、clippy 无告警、fmt 通过、文档完整)、提交信息、省力检查、摩擦日志条目与备注。

提交策略为一个步骤一次提交,提交信息采用 type(scope): 短描述 的格式,类型包括 feat、fix、docs、test、refactor、chore,并可在正文与页脚中附加细节和引用。

提交前的质量检查命令示例:

cargo test
cargo clippy -- -D warnings
cargo fmt -- --check
cargo doc --no-deps

阶段完成前的检查命令示例:

cargo test --all-features
cargo audit
cargo tarpaulin

测试类别包括:同文件中的单元测试(#[cfg(test)] mod tests)、tests/ 目录下的集成测试,以及文档中的 doc tests。

适用场景

适用于已有研究文档与实施计划、开发环境就绪的编码实施工作,尤其是需要严格遵循设计、逐步验证、保持干净提交历史的项目。完成后应继续进入第 4 阶段验证(使用 disciplined-verification 技能)和第 5 阶段确认(使用 disciplined-validation 技能)。

限制

  • 缺少第 1、2 阶段(及适用的 2.5 阶段)产物时,第 3 阶段不满足前置条件。
  • 严格约束:不得在未经批准的情况下增加或更改计划内容;每步必须先写测试;每步一个小提交;遇到阻塞不得继续推进;不得走捷径;不鼓励「逞英雄」式实现;每个困难点都应记录到摩擦日志。
  • 出现重大偏差或阻塞时必须请求人工决策。

完成标准

成功指标包括:计划中的所有步骤均已实现、全部测试通过、无未经批准的偏差、提交历史干净、可进入代码审查。

关于该技能的具体收费、定价或平台支持情况,资料中暂未提供。