spec-learnings-researcher ​

You are a domain-agnostic institutional knowledge researcher.

ASCII 调度图 ​

text
workflow-selected research phase
  |
  v
selector: task stage + risk domain + evidence gap
  |
  v
spec-learnings-researcher
  |
  v
structured findings / research notes / specialist advice
  |
  v
orchestrator synthesis + user-visible decision

基本信息 ​

字段内容
Agentspec-learnings-researcher
类型Research
归属 skillspec-ideate、spec-optimize、spec-plan
复用次数3 个 skill
Sourceskills/spec-ideate/references/agents/learnings-researcher.md

什么时候会被调用 ​

  • 计划、调试、需求或复盘阶段缺少代码库、历史、组织或外部资料证据。
  • 通常由上层 workflow 选择调用；它不是用户直接执行的 spec-* workflow 入口。
  • 当任务证据不足、风险域明确或需要独立专家视角时，才应该引入该 agent。

Source 角色摘要 ​

You are a domain-agnostic institutional knowledge researcher. Your job is to find and distill applicable past learnings from the team's knowledge base before new work begins — bugs, architecture patterns, design patterns, tooling decisions, conventions, and workflow discoveries are all first-class. Your work helps callers avoid re-discovering what the team already learned.

Past learnings span multiple shapes:

  • Bug learnings — defects that were diagnosed and fixed (bug-track problem_type values like runtime_error, performance_issue, security_issue)
  • Architecture patterns — structural decisions about agents, skills, pipelines, or system boundaries
  • Design patterns —...

Source 章节 ​

  • Invocation Contract
  • Step 0: Ground in CONCEPTS.md (if present)
  • Search Strategy (Grep-First Filtering)
  • Frontmatter Schema Reference
  • Output Format
  • Institutional Learnings Search Results
  • Efficiency Guidelines
  • Consumption Contract

输入 ​

  • 研究问题、repo scope、历史线索、外部资料目标和当前 workflow 的证据缺口。
  • 上层 workflow 应提供明确 scope、相关文件或文档、当前假设和需要回答的问题。
  • 如果依赖 graph、MCP、浏览器或外部资料，需要同时说明 provider readiness 与 degraded 状态。

输出 ​

  • 研究摘要、事实来源、限制说明和可交给上层 workflow 的判断材料。
  • 输出应返回给 orchestrator 汇总，而不是绕过主 workflow 直接改变最终结论。
  • 对 findings、风险和建议应标注证据边界，避免把推测写成确定事实。

使用边界 ​

  • research agent 提供证据，不直接决定产品范围、架构方案或最终修复。
  • Agent 是专业判断角色，不是 tool，也不是固定状态机。
  • 如果当前问题可以由 deterministic script、测试或 provider status 直接确认，应优先使用确定性证据。

与 workflow 的关系 ​

  • Skills 定义入口、步骤和产物；agents 提供局部专家判断。
  • 当前 agent 的 runtime copy 由 spec-first init 在目标项目中选择宿主后从 source 生成。
  • 不要手改 .claude/agents 或 .codex/agents 作为 source；需要修复 runtime drift 时重新运行 init。

源码校准 ​

  • 本页由 website/scripts/generate-agent-detail-pages.js 从 skills/spec-ideate/references/agents/learnings-researcher.md 生成。
  • 上游 agent 现为 skill-local prompt 资产（skills/<skill>/references/agents/*.md），无 frontmatter；名称取自文件名，description 由生成器从 prompt 首段启发式提取。
  • 分组是官网生成器的用户手册视角，用于解释调度场景；精确角色指令仍以 source agent 文件为准。

阅读下一步 ​