规范驱动开发

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

概述

在编写任何代码之前先编写结构化规范。规范是您和人类工程师之间共享的事实来源——它定义了我们正在构建什么、为什么以及我们如何知道它已经完成。没有规范的代码是猜测。

何时使用

开始新项目或功能 需求不明确或不完整 更改涉及多个文件或模块 您将要做出架构决策 该任务需要 30 多分钟才能实施

门控工作流程

规范驱动的开发有四个阶段。在当前阶段得到验证之前,请勿进入下一阶段。

第一阶段:指定

从高层次的愿景开始。向人类提出澄清性问题,直到需求具体化为止。立即提出假设。在编写任何规范内容之前,请列出您的假设:不要默默地填写不明确的要求。该规范的全部目的是在编写代码之前*揭露误解——假设是最危险的误解形式。编写涵盖这六个核心领域的规范文档:

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@addyosmani · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第一阶段:指定

从高层次的愿景开始。询问人类澄清问题,直到需求具体化。立即提出假设。在编写任何规范内容之前,请列出您的假设:不要默默地填写不明确的要求。该规范的全部目的是在编写代码之前*揭露误解——假设是最危险的误解形式。编写涵盖这六个核心领域的规范文档:

02
第二阶段:计划

使用经过验证的规范,生成技术实施计划: 确定主要组件及其依赖关系 确定实施顺序(必须首先构建什么) 注意风险和缓解策略 确定可以并行构建的内容与必须顺序构建的内容

03
第三阶段:任务

将计划分解为离散的、可实施的任务: 每个任务都应该在单个重点会话中完成 每个任务都有明确的验收标准 每个任务都包含一个验证步骤(测试、构建、手动检查) 任务按依赖性排序,而不是按感知的重要性排序

04
第四阶段:实施

按照`skills/incremental-implementation/SKILL.md`(`incremental-implementation`)和`skills/test-driven-development/SKILL.md`(`test-driven-development`)一次执行一个任务。使用 `skills/context-engineering/SKILL.md` (`context-engineering`) 在每一步加载正确的规范部分和源文件,而不是用整个规范淹没代理。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。