1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | repo-story-time-github-awesome-copilot |
| 作者/维护者 | github/awesome-copilot 社区合集(前身 prompt 文件由贡献者 sdolgin 于 2025-07-28 提交,此后由多位贡献者修订工具名与格式) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/repo-story-time |
| 许可证 | MIT(数据来自 GitHub API,仓库级) |
| GitHub Stars / Forks | 39,890 / 5,091(数据来自 GitHub API;为合集仓库整体数字,不代表本技能自身热度) |
| 最新版本 | 无独立版本号,随仓库滚动更新;该技能文件最近一次改动为 2026-02-19(由 prompt 转为 skill 格式),合集仓库近日仍在持续提交 |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill repo-story-time,或复制 skills/repo-story-time/ 目录 |
2. 功能介绍与亮点
让 agent 把一个陌生仓库读成两份文档:REPOSITORY_SUMMARY.md(用途、架构、关键组件、技术栈、数据流、维护归属)和 THE_STORY_OF_THIS_REPO.md(基于近一年 git 历史写成的叙事)。
- 分六个阶段执行:仓库探索 → 技术盘点 → 提交历史统计(总提交数、近一年活跃度、贡献者排名、月度节奏、改动热点、合并情况)→ 模式识别 → 写作。
- 叙事章节固定:一年数字、人物群像、季节规律、主题、转折点、当前篇章。要求引用真实文件名、提交信息与贡献者,每个论断须有 git 数据支撑。
- 交付物是落盘文件,明确禁止把全文输出到对话里。
- 纯提示词,无附带脚本;用到的 git 命令均为只读。
3. 适用场景
所属分类:内容创作与知识管理
适合接手陌生代码库的新成员、需要给团队写项目回顾或年度总结的维护者、想快速理解开源项目演进脉络的人。产出物是可读的说明文档,而不是对代码的评审意见。
4. 跨 Agent 兼容性
- Claude Code:⚠️ 需适配——SKILL.md 符合标准格式可直接加载,但其中的统计命令是 PowerShell 语法(
Get-ChildItem、Select-Object),且要求用 VS Code Copilot 的editFiles工具写文件;在 macOS/Linux 的 Claude Code 里需由 agent 自行改写为 bash 并用自带的写文件工具。 - Codex:⚠️ 需适配——同上;另外 Codex 不会自动扫描
~/.codex/skills,需显式引用。 - OpenClaw:❓ 未验证。
- Hermes Agent:⚠️ 需适配——按路径扫描子目录可识别 SKILL.md,命令层面同样需要改写。
5. 推荐理由
“读懂一个仓库”通常靠翻 README 加零散提问,这个技能把它变成固定流程:先看结构,再用 git 历史取证,最后产出两份可留存的文档。叙事部分把提交统计转成“谁在什么时候做了什么、为什么”,对新人入项和团队复盘都比纯数字报表好读。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 第三方目录 skills.sh 显示该技能单独安装量约 8,900 次;合集仓库近 4 万 stars,但该数字不计入本技能 |
| 可用性 | 6 | 无需配置、复制即用,流程与输出结构清晰;但命令为 PowerShell 写法、工具名绑定 VS Code Copilot,非 Windows 环境要靠 agent 临场改写;技能文件自 2026-02 起未再改动 |
| 安全性 | 9 | 纯提示词;执行的 git 命令只读;唯一写操作是在仓库根目录创建两个 Markdown 文件;不联网、不索取凭据;MIT 许可证明确 |
综合评分:7.33(三项均值)
安全检查清单:① shell 命令:仅只读 git 与目录列举,另写两个文件;② 联网外发:无;③ 凭据:不需要;④ 可疑指令:无(“必须落盘、不得输出到聊天”属输出方式约束);⑤ 作者信誉:GitHub 官方维护的合集,该技能由外部贡献者提交;⑥ License:MIT;⑦ 维护:合集活跃,技能文件近 8 个月未改。
7. 跟同类 Skills 相比的优势
| 同类 | 定位 | 差异 |
|---|---|---|
| GitHub Insights(Pulse / Contributors 页面) | 网页端的提交与贡献者统计图表 | 只给图表,不写叙事,也不分析架构;本技能同时产出架构摘要和故事化解读 |
| git-quick-stats 等 git 统计命令行工具 | 终端里快速出提交、作者、活跃度数字 | 只出数字,不做解释;本技能由 agent 读代码加读历史,把数字解释成因果 |
| Gource 等仓库历史可视化工具 | 把提交历史渲染成动画 | 偏展示,不产出文字文档,也不涉及架构 |
核心差异:把“架构理解”和“历史叙事”合并为一次任务,交付物是可直接留存的两份文档。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;可查证的是其前身 prompt 自 2025-07-28 提交后,经贡献者 derekclair、CypherHK 等陆续更新工具名与格式。
9. 其他补充
原为 VS Code Copilot 的 prompt 文件,2026-02 转为 skill 格式并入同一合集。
10. 安装使用方式
- 命令行:
npx skills add https://github.com/github/awesome-copilot --skill repo-story-time - 手动:复制
SKILL.md到目标 agent 的 skills 目录(Claude Code 为~/.claude/skills/repo-story-time/) - 触发:在目标仓库中提出“分析这个仓库并写一份仓库故事”一类请求;无需重启
11. 注意事项
- 在非 Windows 环境须让 agent 把 PowerShell 命令改写为 bash,否则首轮统计会失败。
- 会在仓库根目录新建
REPOSITORY_SUMMARY.md与THE_STORY_OF_THIS_REPO.md,已有同名文件会被覆盖,建议先提交或换分支。 - 统计只覆盖近一年提交;历史很短或提交信息质量差的仓库,叙事会偏空泛。
- 叙事会点名贡献者,发布前请确认团队是否接受。