用途
create-tech-design 是一个按名称显式调用才触发的技能,用于编写技术设计文档(TDD)。它承接已有的产品背景(PRD、工单、研究文档,甚至只有几句话的描述),回答“如何构建”,而不负责“做什么”或“为什么”,产品需求与 UX 留给上游材料处理。文档会引用而非复制上游内容;若产品背景单薄,不臆造需求,而是在对话中把缺口作为问题提出,由用户补充。
主要能力
- 两阶段有序推进:先做系统设计(组件之间如何组合),再做程序设计(代码内部如何组织)。系统设计获得用户确认后才开启程序设计。
- 引导式对话:每条消息只问一个问题,给出选项、取舍与自己的推荐,然后等待回答。即使同时有多个未决点,也只问最能解锁其余问题的那个。
- 决策闭环后再改文档:对话中的澄清、反驳、思考都属于讨论而非结论;只有决策真正确定后才把结论写回文档。
- 重写而非追加:每次吸收决策都重写相关章节,可重绘图表、调整顺序、删除旧内容,使文档始终像一份刻意设计过的连贯文档,并随决策演进保持图表、签名等产物最新。
- 展示优先于叙述:用 Mermaid 图表达控制流、数据流与组件交互;用类型签名、端点/消息结构、数据表定义表达接口约定;必要时可写一个聚焦的 HTML 工件(写入 .humanlayer/tasks/{task-slug}/diagram-{description}.html,并参照 {SKILLBASE}/references/artifact_template.html)。
- 程序设计阶段强调代码形态可视化:几乎每条消息都带代码块,用调用栈树、diff、前端组件树、文件树 diff、依赖注入图、内部函数签名、伪代码等呈现选项,每个选项单独成块以便并排比较。
- 需要更多上下文时,可先在给出选项前发起 Agent() 调用(codebase-analyzer、codebase-pattern-finder、web-search-researcher 或库调研),再把发现折回研究工件。
使用方式
调用后先建立最简骨架:frontmatter 写 type: design-tdd 与顶层标题,保留空的 System Design、Program Design 两个标题和一个 Patterns to Follow 标题,然后立即以第一个系统设计问题开场(至多一句引导语加一个问题)。之后在每个阶段内沿设计决策树逐一下钻,一次只解决一个决策,再据其推进下一个。当系统设计完成后,请用户通读确认整体是否自洽,获得批准并吸收修改后,才进入程序设计;程序设计完成后同样请用户确认代码形态。文档中的 markdown 若需再包含代码围栏,外层用四个反引号。
适用场景
已有一定产品上下文、需要把方案落成可实施的技术设计,并希望团队能据此对齐与调整实现方向时使用。设计应追求“杠杆”而非面面俱到,用最少的图、签名与草图揭示关键决策和取舍。
限制
仅在用户按名称显式调用时使用。不负责产品需求与 UX 决策;若技术决策影响产品范围或体验,会提示用户并(若存在 PRD)同步更新。分类方面资料未给出明确分类字段。