SuperAPI AI 工具集

iterate-design-discussion

编程与开发

查看项目

更新于 10-20 06:54

技能介绍

用途

该技能用于在用户反馈的基础上,迭代已有的设计讨论文档。它属于开发流程中的设计讨论环节,帮助团队根据新信息或评审意见持续完善设计决策。

主要能力

  • 读取任务上下文:定位并读取任务目录(如 .humanlayer/tasks/TASKNAME)中的所有相关文档,包括当前设计讨论文档、工单(ticket.md 或 task.md)、研究材料等。
  • 验证用户反馈:不盲目接受用户的修正意见,而是读取用户提到的具体文件或目录,必要时启动 Agent 调用进行核实,确认事实后再继续。
  • 并行研究:在上下文不足时,可并行启动 codebase-locator、codebase-analyzer、codebase-pattern-finder 等 Agent,分别用于查找特定文件、分析实现细节、寻找可借鉴的代码模式。
  • 更新设计讨论文档:在原路径更新文档,包括当前状态/期望状态/提议架构、将已回答的问题移至“Resolved Design Questions”章节、补充新发现的代码模式与示例、添加新出现的设计问题。
  • 按模板输出:读取 {SKILLBASE}/references/design_discussion_final_answer.md(或所有问题已解决时读取 design_discussion_final_answer_resolved.md),严格按模板回复,并附上云永久链接(如可用)。

使用方式

用户需明确以技能名称调用该技能。若用户未提供反馈或指令,技能会先询问用户希望纳入哪些反馈或修改,然后等待用户输入再继续。技能会要求用户提供任务目录(如果不清楚),并使用 ls -La .humanlayer/tasks/TASKNAME 查找相关文档;注意该目录可能是符号链接,因此不应使用 Grep、Glob 或 ls -l。读取文件时应使用 Read 工具且不设 limit/offset,完整读取。

适用场景

  • 已有设计讨论文档需要根据评审意见或新发现进行修订。
  • 需要将设计决策、代码模式与问题解决状态同步到文档中。
  • 在编码实现前,通过多轮讨论收敛设计方案。

限制

  • 仅在用户明确调用该技能时使用。
  • 需要已知任务目录;文档冲突时以最新文档为准(设计讨论 > 研究 > 工单)。
  • 云永久链接的可用性取决于环境是否提供。
  • 资料未说明该技能的具体安装方式、收费模式或平台兼容性。