用途:该技能仅在用户明确按名称调用时使用,用于进入 HumanLayer 工作流中的“设计讨论”阶段,在已有工单与研究结果基础上与用户共同做出设计决策。
主要能力:读取任务产物目录中与任务相关的文档,包括工单文件和研究文档,不读取研究问题文档;在读取前不派生子任务,且使用 Read 工具完整读取文件,不使用 Grep、Glob 或 ls -l,因为任务目录可能是符号链接。必要时可并发派生 Agent 进行补充调研,可选代理包括 codebase-locator、codebase-analyzer、codebase-pattern-finder,用于定位文件、分析实现细节和寻找可参照的实现模式。
使用方式:读取技能自带的 design_discussion_template.md 与 show-me.md,遵循 show-me 的可视化指引,使用最小必要视图说明当前状态、目标状态与关键设计选择,并将视图放在对应文字旁边。随后将设计讨论写入 .humanlayer/tasks/ENG-XXXX-description/NN-design-discussion-DESCRIPTION.md,编号按目录中已有最大编号顺延,文件名使用 2–4 个词的 kebab-case 描述。若有工单则目录带工单号,无工单则使用任务名。文档内容包括高层产品规格(当前状态、目标状态、不做的部分)、目标架构示意、逐项设计决策(选项与优缺点、基于代码库惯例的建议)、相关测试方式参考,以及应遵循的现有代码模式(含文件位置与多行代码片段)。所有设计问题须置于“Design Questions”下并保持开放状态,不得自行解决;“Resolved Design Questions”初始为空,仅当用户明确反馈后才迁移并记录决策理由与未选方案。
输出与限制:按 design_discussion_final_answer.md 模板输出;若钩子上下文表明所有问题已解决,则改用 design_discussion_final_answer_resolved.md 模板,不额外添加摘要。文档写入后钩子可能返回云永久链接,可用于最终输出导航。写入包含其他 Markdown 代码块的 Markdown 文件时,外层使用四个反引号。文档冲突时以最新文档为准:设计讨论 > 研究 > 工单。该技能依赖 HumanLayer 任务目录结构与相关工具,具体环境配置与平台支持暂未提供。