SuperAPI AI 工具集

iterate-structure-outline

编程与开发

查看项目

更新于 10-20 06:54

技能介绍

用途:该技能用于根据用户反馈迭代已有的结构大纲文档。适用前提是用户显式按名称调用该技能;否则不应使用。

主要能力:读取并完整理解结构大纲及相关产物(ticket.md 或 task.md、研究文档、设计讨论、PRD/TDD 等),检查任务目录 .humanlayer/tasks/TASKNAME 下的相关文件;根据用户反馈重新组织阶段、调整范围(更新“What we're not doing”和阶段内容)、将已回答的开放问题纳入计划并从“Open Questions”中移除;在需要时派生子代理进行代码库定位、分析、模式查找或外部研究,且要求仅以前台方式运行代理;保持相同的 YAML frontmatter 和格式;强调每个阶段应为薄纵向切片,尽可能跨多个层、服务或模块边界,并能基于类型检查、测试、构建步骤等仓库内手段独立验证,避免“先建 schema、再建 API、再建 UI、最后加测试”的横向拆分,也避免阶段 N 的验证依赖阶段 N+1 完成。

使用方式:若仅提供目录或未提供目录,检查提示中的任务产物目录,使用 ls -La .humanlayer/tasks/<task slug>(不要使用 grep、glob、ls 或 ls -l,因为目录可能是符号链接)。若用户未给出任何指示或反馈,先询问其希望纳入的反馈或变更(如阶段重组、范围增删、开放问题回答、补充上下文或需求),等待反馈后再继续。读取输入文档时使用 Read 工具且不设 limit/offset,完整读取结构大纲及所有先前产物。若用户给出输入,不盲目接受纠正,必要时派生研究任务核实信息、读取其提到的具体文件/目录,并在自行核实事实后才继续。处理反馈后,若需更改,则在相同 docPath 更新文档,调整阶段、阶段内文件变更、验证方式,移除已回答的开放问题。最后检查是否已在 worktree 中(git rev-parse --git-dir),读取相应最终输出模板并严格按模板响应,不附加摘要或其他信息,如可用则包含云永久链接。

适用场景:适用于已有结构大纲需要根据反馈调整阶段划分与范围、回答开放问题、补充上下文或需求,以及需要将计划重组为可独立验证的纵向切片的开发规划场景。

限制:资料未提供该技能的具体收费、价格、平台兼容性、效果保证或安装命令;仅说明在用户显式调用时使用。文档优先级为:结构大纲 > TDD > PRD > 设计讨论 > 研究 > 工单。在 .humanlayer/tasks/ 中写入或编辑文档时,钩子响应会自动提供云永久链接,格式如 http(s)://{DOMAIN}/artifacts/{artifactId}。编写包含代码块的 markdown 文件(如 README 示例或 SKILL.md 模板)时,外层围栏使用 4 个反引号,避免内部 3 个反引号代码块提前闭合。阶段描述应简洁清晰,结构大纲定位为“c header files”,计划则包含函数定义;代码片段应克制使用,优先突出签名变化,除非用户明确要求完整代码块。并非每个阶段都需要手动验证,若某阶段无法手动检查,可能说明其过小或纵向程度不足;自动化测试始终优于手动测试,需明确区分手动与自动测试。最终输出需严格遵循模板,不添加摘要或其他信息。