用途
这个技能用于在已有技术设计文档(TDD)的基础上迭代完善设计,不做从零访谈,而是基于用户反馈逐项解决设计决策。技能说明要求仅在用户明确点名时调用。
主要能力
- 延续追问模式:读取TDD,识别系统设计与程序设计中尚未解决或内容稀疏的部分,逐个提出决策点。
- 单问题推进:每条消息只提出一个问题,可附带2-3个选项及取舍,并基于代码库模式给出推荐。系统设计问题以图示、高层类型或RPC方法签名呈现选项;程序设计问题以调用栈树、组件树、文件树差异或依赖注入图呈现。
- 决策确定后再改文档:讨论过程中的反问、思考与辩驳不触发修改;只有决策真正确定后,才就地编辑文档相关章节。
- 保持文档整体一致:每次修改后重写受影响的章节,使内容读起来是一份有意设计、前后一致、当前有效的文档,而不是问答记录或变更日志。为章节和小节设置能表达结论的标题,段落简短,图表紧邻相关文字。
- 区分系统设计与程序设计:系统设计说明跨组件行为(时序图、流程图、服务边界、数据流、外部接口、端点与schema及方法契约);程序设计说明代码内形态(调用栈、前端组件树、文件树差异、依赖注入映射、方法签名)。
- 按需研究:可并行派生研究代理(如codebase-locator、codebase-analyzer、codebase-pattern-finder)查找文件、理解实现细节、寻找可借鉴的模式。
- 图表表达:使用Mermaid语法在Markdown中绘制flowchart、sequenceDiagram、erDiagram、classDiagram;复杂概念可写成HTML制品并存放在任务目录下。
- 文档优先级:文档冲突时以最新者为准,顺序为TDD > PRD > 设计讨论 > 研究 > 工单。若存在PRD,以引用方式关联,不重复其内容;技术决策影响产品范围或体验时,同步更新PRD或原型。
- 结束输出:设计完整后读取最终输出模板,按模板回复。
使用方式
用户调用时若未提供指令或反馈,技能会询问接下来要做哪一项:补充具体反馈、继续逐个决策追问设计、或让技能提出更多技术设计问题。使用过程中会读取任务目录(如 .humanlayer/tasks/TASKNAME)中的全部相关文件(TDD、任务单、研究、设计讨论、PRD等),完整读取不截断,并避免对可能为符号链接的目录使用Glob或Grep。编辑文档后,写入操作会附带云永久链接,可用于最终输出。
适用场景
适合已有TDD草稿、需要继续打磨架构或补齐程序设计细节的研发流程;适合需要逐项确认设计取舍、避免一次性大改造成混乱的情况;也适合需要以图示辅助讨论、并让文档保持可快速浏览的团队协作场景。
限制
- 仅在用户明确点名调用时使用。
- 每次只推进一个决策,需用户逐步参与。
- 未在讨论中确定的决策,不应写入文档。
- 具体的运行环境、安装方式、收费与平台支持情况,资料暂未提供。