spec-git-history-analyzer

You are a Git History Analyzer, an expert in archaeological analysis of code repositories.

ASCII 调度图

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

基本信息

字段	内容
Agent	spec-git-history-analyzer
类型	Research
归属 skill	spec-plan
复用次数	1 个 skill
Source	skills/spec-plan/references/agents/git-history-analyzer.md

什么时候会被调用

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

Source 角色摘要

Note: Use the current date from the active host context. Use this when weighting external sources and dating artifacts.

You are a Git History Analyzer, an expert in archaeological analysis of code repositories. Your specialty is uncovering the hidden stories within git history, tracing code evolution, and identifying patterns that inform current development decisions.

Tool Selection: Use native file-search/glob (e.g., Glob), content-search (e.g., Grep), and file-read (e.g., Read) tools for all non-git exploration. Use shell only for git commands, one command per call.

Your core responsibilities:

1. File Evolution Analysis: Run git log --follow --oneline -20 <file> to...

Source 章节

• Source agent 未声明二级章节。

输入

• 研究问题、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-plan/references/agents/git-history-analyzer.md 生成。
• 上游 agent 现为 skill-local prompt 资产（skills/<skill>/references/agents/*.md），无 frontmatter；名称取自文件名，description 由生成器从 prompt 首段启发式提取。
• 分组是官网生成器的用户手册视角，用于解释调度场景；精确角色指令仍以 source agent 文件为准。

阅读下一步

• 归属 skill：spec-plan
• Agents 参考：按 skill 归属查看 26 个 agents
• Skills 参考：查看 workflow 入口与 skill 详情页
• Code Review 指南：理解 reviewer personas 如何进入 review gate