用途
该技能用于在用户反馈的基础上迭代一份已有的研究文档。它只处理任务产物目录中匹配 research.md 的文件(排除 research-questions.md),不读取 ticket.md/task.md 等其他文件,以保持研究对当前代码库的客观性。仅当用户明确按名称调用此技能时使用。
主要能力
- 定位并完整读取已有的研究文档,理解此前的研究内容。
- 解析用户反馈:若要求补充研究,则派生并行子代理进行调查;若要求修正,则原地更新文档。
- 调用专用研究子代理:codebase-locator(定位文件与组件位置)、codebase-analyzer(理解代码如何工作)、codebase-pattern-finder(查找现有模式示例);仅在用户明确要求时使用 web-search-researcher 进行外部搜索并返回链接。
- 保持文档原有的 YAML frontmatter 和格式,将新发现融入相关章节,而非追加变更日志。
- 按指定模板输出最终回答,并包含云永久链接(如有)。
使用方式
调用后先检查系统提示中的任务产物目录,用 ls -La 查找 research.md 文件(目录可能是符号链接,不使用普通 ls 或 grep/glob 工具)。若找到多个研究文档,先询问用户选择哪一个再读取。若不知道产物目录,则提示用户提供研究问题或领域。读取文档后处理反馈:需要额外研究时派生并行子代理,仅使用上述专用代理类型(名称随运行时变化,如 rpi:codebase-analyzer 或无前缀的 codebase-analyzer)。子代理使用建议:先用定位代理发现存在什么,再用分析代理深入最有希望的发现;可并行运行多个代理;主代理专注于综合而非深度读文件。需要更新时在同一路径修改文档,添加新发现到相关章节,然后读取 {SKILLBASE}/references/research_final_answer.md 模板并严格按模板回复。
适用场景
适用于需要对已有代码库研究文档进行迭代更新、补充调查或修正的场景,且用户明确调用该技能。研究内容聚焦于描述和解释当前代码库的实际状态。
限制
- 仅当用户明确按名称调用时使用。
- 严禁读取 ticket.md/task.md 或产物目录中不匹配 research.md 模式的文件,除非用户明确要求。
- 不提出改进建议、不进行根因分析、不提议未来增强、不批评实现或识别问题、不推荐重构/优化/架构变更,除非用户明确要求。
- 仅使用列出的专用研究代理,不使用 general-purpose、Explore 或 Plan 等其他代理类型。
- 不得在文档中写入占位值。
- 外部网络搜索仅在用户明确要求时进行。
- 文档格式要求:标题应陈述要点而非主题或问题;混合使用段落、表格、Mermaid 图、调用栈树、文件树、组件树、类型签名、伪代码等视觉结构;不使用 diff 块或 +/- 变更标记;保持客观描述当前状态。