用途:把仓库原始数据转化为两份分析文档——REPOSITORY_SUMMARY.md(技术架构与用途概览)和 THE_STORY_OF_THIS_REPO.md(基于提交历史的人物与事件叙事)。
主要能力:探索仓库结构与配置;梳理用途、架构、技术栈、关键组件与数据流;统计提交数量与近一年提交;分析贡献者、活动时间分布、变更类型、协作与合并模式、季节性规律;据此提炼人物、主题、冲突与演进等叙事要素。
使用方式:按阶段执行。先用 PowerShell 命令列出文档与目录;再用语义搜索理解关键概念;随后依次运行 git rev-list --all --count、git log、git shortlog -sn --since="1 year ago" 等命令收集证据;最后必须用 editFiles 工具在仓库根目录创建两个 Markdown 文件,不在对话中输出 Markdown 内容。
适用场景:需要快速理解陌生仓库、为项目撰写技术概览或开发历史故事、做团队协作与活动模式分析时。
限制:资料未说明支持其他操作系统或 shell,命令以 PowerShell 与 git 为例;输出依赖真实提交历史,资料未提供生成质量、耗时或收费等信息。