SuperAPI AI 工具集

disciplined-design

编程与开发

查看项目

更新于 10-16 05:59

技能介绍

用途

disciplined-design 是纪律化开发流程中的第二阶段技能,定位为设计专家角色。其核心任务是基于第一阶段已批准的研究文档,创建详细的实现计划。该阶段不进行任何编码实现,只专注于设计。

主要能力

  • 计划先行:所有变更在编写代码前必须经过规划。
  • 明确步骤:将工作拆分为可评审的小块。
  • 测试策略优先:在实现之前定义验证方式。
  • 人工批准:未经签署确认不得进入实现。
  • 消除优先:设计主要关注移除而非添加,体现极简主义中的“消除”原则。
  • 5/25 规则:应用类似巴菲特的范围管理方法,列出最多 25 项功能,圈出前 5 项作为范围内,其余 20 项列为“不惜一切代价避免”的危险干扰项。

使用方式

该技能要求具备以下前提条件:

  • 第一阶段已批准的研究文档
  • 已解决的开放问题
  • 明确的范围和成功标准

第二阶段产出“实现计划”,其模板包含以下部分:

  • 概述(摘要、方法、范围,包括范围内、范围外和“不惜一切代价避免”列表)
  • 架构(组件图、数据流、关键设计决策、已消除选项、简单性检查)
  • 文件变更(新增文件、修改文件、删除文件)
  • API 设计(公共类型、公共函数、错误类型,含代码示例)
  • 测试策略(单元测试、集成测试、属性测试)
  • 实现步骤(分步说明,含文件、描述、测试、依赖和预估时间)
  • 回滚计划
  • 迁移(如适用)
  • 依赖(新增依赖、依赖更新)
  • 性能考量(预期性能、基准测试)
  • 开放事项
  • 批准清单

设计技术包括接口优先设计(先定义 trait 接口)和测试驱动设计(先写测试签名)。

进入第三阶段(实现)前需满足门禁标准:

  • 标准门禁:所有文件变更已列出、所有公共 API 已定义、测试策略完整、步骤已按依赖排序、性能目标已设定、已获得人工批准。
  • 极简主义门禁:范围内主要组件/功能不超过 5 个、“已消除选项”部分已填写、“不惜一切代价避免”列表已记录、简单性检查已回答、5/25 规则已应用。

完成设计后,需使用 disciplined-quality-evaluation 技能请求评估,再进入第三阶段。

适用场景

适用于需要严格设计评审的软件开发流程,特别是希望避免范围蔓延、强调测试先行、要求人工审批的团队。适合在已有研究文档后,需要产出可执行、可评审的实现计划的场景。

限制

  • 仅限设计,不进行实现。
  • 必须有人工批准环节。
  • 依赖第一阶段已批准的研究文档。
  • 需要明确的范围和成功标准。
  • 该技能的具体平台支持、收费模式、价格等信息暂未提供。