用途
该技能用于在用户反馈的基础上迭代修改一份已有的“研究问题”文档。它属于任务工作流中的一环,输入是一份研究问题文档的路径,以及可选的、包含反馈意见的票据文件路径。技能强调:仅在用户明确按名称调用时才可使用。
主要能力
- 完整读取指定路径的研究问题文档(不加行数限制),理解此前已创建的问题。
- 若只提供了目录,则从任务产物目录中查找研究问题文档;目录可能是符号链接,因此规定使用
ls -La方式查看,禁止使用 grep、glob 或未带 -L 的 ls。 - 若提供票据文件,则读取其中的评论作为用户反馈。
- 依据反馈在原路径更新文档,保持相同的 YAML 前置元数据与格式,并逐条回应每项反馈。
- 按参考模板
{SKILLBASE}/references/research_questions_final_answer.md输出最终答复,不额外添加摘要或其他信息。 - 在
.humanlayer/tasks/下写入或编辑文档时,钩子响应会自动返回云端永久链接,可在最终输出中使用以便导航,格式如http(s)://{DOMAIN}/artifacts/{artifactId}。
问题撰写准则
问题只针对代码库当前状态:记录存在什么、在何处、组件如何组织。不得询问应构建什么、不得未经要求提出改进建议、不得询问需要做哪些变更。问题应写成高层次的代码库探索形式,例如:
- “解释 [FEATURE] 端到端如何工作以及涉及的所有系统”
- “探究 [COMPONENT1] 与 [COMPONENT2] 之间的契约及两侧如何实现”
- “追踪从 [ENDPOINT] 到 [DATASTORE] 的逻辑流向”
- “找出 [数据库列或表] 的所有使用者及其数据用途”
每个任务使用 3 至 8 个问题,数量视复杂度判断。需保留任何“关键上下文指针”部分(用户或票据提到的链接、仓库、库、依赖、文件路径),逐字照录,并在相关时补充反馈中新出现的指针。技能特别强调:问题列表中不得泄露任何实现细节或任务性质,只能问“它如何工作”,不能问“我们该如何做 XYZ”。
若涉及界面或前端改动,即使票据未明确提及也需考虑,并询问诸如:某产品区域使用何种设计系统或组件库、主色(含十六进制色值)、排版、间距、边框、阴影等模式、是否存在主题系统。该类问题无需针对票据中的具体界面工作定制,因为做前端改动时需要了解设计系统与一次性 HTML 稿的模式。
使用方式
- 读取 docPath 指向的完整文档。
- 若提供票据文件则读取反馈。
- 处理反馈并在同一路径更新文档,保持格式。
- 读取最终输出模板并按模板答复。
适用场景
适用于已有研究问题文档需要根据用户评论进行修订的研发任务场景,尤其是需要梳理现有代码库结构、组件契约、数据流向与前端设计模式时。
限制
- 仅在用户明确点名调用时使用。
- 问题只描述现状,不涉及规划、改进或变更建议。
- 具体文件路径、票据格式等细节由调用方提供;未提供的配置与运行环境信息暂未提供。