用途:该技能用于在用户明确点名调用时,根据用户反馈迭代已有的研究问题文档。
主要能力:完整读取指定路径的研究问题文档;若提供了工单文件路径,则读取其中的评论作为反馈;按反馈逐条更新同一路径的文档,保持原有 YAML frontmatter 与格式;保留 Key Context Pointers 中的链接、仓库、库、依赖和文件路径原文,并在相关时补充反馈中新出现的指针。
问题范围:问题只关注代码库当前状态,即记录存在什么、在何处、组件如何组织,例如功能如何端到端运作、组件间的契约及两侧实现、逻辑从端点流向数据存储的路径、数据库表或字段的所有使用者及其数据用途;不询问应构建什么、不提改进建议、不涉及需要做哪些变更。问题以高层代码库探索形式表述,通常每个任务 3 至 8 个,具体数量视复杂度判断。若涉及 UI 或前端变更(即使工单未明确提及),需包含关于设计系统或组件库、主色(含十六进制色值)、字体、间距、边框、阴影等模式以及主题系统的问题。
使用方式:提供 docPath(如 .humanlayer/tasks/ENG-XXXX-description/NN-research-questions-DESCRIPTION.md),可选提供含反馈评论的工单文件路径;若只提供目录,需在该任务工件目录中查找研究问题文档,查看目录时使用 ls -La,不使用 grep、glob 或不带 -L 的 ls,也不带 -l,因为目录可能是符号链接。读取文档时不设 limit/offset。更新后按 references/research_questions_final_answer.md 模板输出,不额外添加摘要或其他信息。在 .humanlayer/tasks/ 下写入或编辑文档时,钩子响应会自动提供云端永久链接(格式如 http(s)://{DOMAIN}/artifacts/{artifactId}),可用于最终输出。
适用场景:已有研究问题文档需要依据用户反馈修订的研发任务流程。
限制:仅在用户显式点名该技能时使用;不得将实现细节或任务性质泄露到问题列表中,不使用“我们将如何做”式表述,只用“它如何运作”式表述;文档格式与 frontmatter 保持不变。