用途:在需求分析完成之后,帮助独立开发者把已验证的需求转成架构决策、组件设计与接口定义,防止过度工程,也防止漏掉关键集成点。核心理念是设计源于约束,每个架构决策都是取舍,取舍要在变成 bug 之前明确写出。
主要能力:通过状态诊断定位设计问题,包括 SD0 需求不清晰、SD1 设计不足、SD2 过度设计、SD3 缺少集成点、SD4 未识别高风险决策、SD5 没有走通骨架、SD6 设计已验证。针对每个状态给出关键提问与干预手段,如数据流映射、错误场景枚举、YAGNI 审查、复杂度预算、规则之三、接口优先设计、依赖盘点、集成清单(认证、配置、日志、错误、部署)、架构决策记录 ADR、可逆成本评估、假设日志,以及最小端到端路径(走通骨架)定义与集成顺序规划。同时列出反模式:架构宇航员、隐性决策、大爆炸集成、金锤子、过早优化、依赖否认、简历驱动开发。
使用方式:先确认需求已明确(否则回到 requirements-analysis),判断当前处于哪个设计状态,从最早的问题状态开始,用该状态的问题提问并执行干预,产出设计上下文简报、ADR、组件图、走通骨架定义和已验证设计文档。输出默认持久化到文件,需先检查项目中的 context/output-config.md,若无配置则询问保存位置,建议 docs/design/ 或 docs/architecture/,命名如 design-{project-name}.md 与 adr/001-*.md。
适用场景:独立开发者的软件项目架构决策、组件与接口设计、集成规划。
限制:不写实现代码,不跳过需求,不为假设性未来做设计,不允许隐性决策不留档,未定义走通骨架不批准设计;该技能只做诊断、提问与引导,最终由开发者决定。