用途
disciplined-design 是纪律化开发流程中的第二阶段技能,定位为设计专家角色。其核心任务是基于第一阶段已批准的研究文档,创建详细的实现计划。该阶段不进行任何编码实现,只专注于设计。
主要能力
- 计划先行:所有变更在编写代码前必须经过规划。
- 明确步骤:将工作拆分为可评审的小块。
- 测试策略优先:在实现之前定义验证方式。
- 人工批准:未经签署确认不得进入实现。
- 消除优先:设计主要关注移除而非添加,体现极简主义中的“消除”原则。
- 5/25 规则:应用类似巴菲特的范围管理方法,列出最多 25 项功能,圈出前 5 项作为范围内,其余 20 项列为“不惜一切代价避免”的危险干扰项。
使用方式
该技能要求具备以下前提条件:
- 第一阶段已批准的研究文档
- 已解决的开放问题
- 明确的范围和成功标准
第二阶段产出“实现计划”,其模板包含以下部分:
- 概述(摘要、方法、范围,包括范围内、范围外和“不惜一切代价避免”列表)
- 架构(组件图、数据流、关键设计决策、已消除选项、简单性检查)
- 文件变更(新增文件、修改文件、删除文件)
- API 设计(公共类型、公共函数、错误类型,含代码示例)
- 测试策略(单元测试、集成测试、属性测试)
- 实现步骤(分步说明,含文件、描述、测试、依赖和预估时间)
- 回滚计划
- 迁移(如适用)
- 依赖(新增依赖、依赖更新)
- 性能考量(预期性能、基准测试)
- 开放事项
- 批准清单
设计技术包括接口优先设计(先定义 trait 接口)和测试驱动设计(先写测试签名)。
进入第三阶段(实现)前需满足门禁标准:
- 标准门禁:所有文件变更已列出、所有公共 API 已定义、测试策略完整、步骤已按依赖排序、性能目标已设定、已获得人工批准。
- 极简主义门禁:范围内主要组件/功能不超过 5 个、“已消除选项”部分已填写、“不惜一切代价避免”列表已记录、简单性检查已回答、5/25 规则已应用。
完成设计后,需使用 disciplined-quality-evaluation 技能请求评估,再进入第三阶段。
适用场景
适用于需要严格设计评审的软件开发流程,特别是希望避免范围蔓延、强调测试先行、要求人工审批的团队。适合在已有研究文档后,需要产出可执行、可评审的实现计划的场景。
限制
- 仅限设计,不进行实现。
- 必须有人工批准环节。
- 依赖第一阶段已批准的研究文档。
- 需要明确的范围和成功标准。
- 该技能的具体平台支持、收费模式、价格等信息暂未提供。