source-command-catchup 是一个用于深入理解项目历史、方向与实现细节的技能。当用户要求运行迁移后的 source command catchup 时,可使用该技能。
用途 该技能旨在帮助使用者快速、全面地掌握一个项目的整体情况,包括其历史演进、当前开发方向以及具体实现细节。它适用于需要快速上手或评估项目的场景。
主要能力 技能分为三个阶段:
第一阶段:Git 历史分析
- 查看最近提交:使用 git log --oneline -50、git log --oneline --since="1 week ago"、git log --oneline --since="1 month ago" --until="1 week ago" 等命令。
- 分析提交模式:识别活跃工作区域、主要变更类型(feat、fix、refactor、docs)、贡献者及其关注点、反复修复的问题。
- 按区域查看近期活动:例如 git log --oneline --all -- "src/components/*" | head -20 等。
第二阶段:开发方向
- 阅读项目文档:PRODUCT.md(愿景、目标、目标用户、成功指标)、ARCHITECTURE.md(技术决策、模式、系统设计)、AGENTS.md(项目特定知识、命令、注意事项)、README.md(设置、使用、贡献指南)、CHANGELOG.md(发布历史、破坏性变更)。
- 识别当前重点:进行中的功能、路线图或下一个里程碑、指示方向的开放 issue 或 PR(gh issue list --state open --limit 20、gh pr list --state open --limit 10)。
- 商业与营销策略:盈利模式及其效果、竞争对手与差异化、市场进入策略、用户获取方式(SEO、社交、付费、推荐)、面向公众的资产(落地页、博客、社交账号)。
- 分支分析:git branch -a、git log main..HEAD --oneline(如果在功能分支上)。
第三阶段:深度实现研究
- 代码库结构:tree -L 2 -d src/(或相关目录)。
- 关键文件:入口点(main、index、app)、配置文件(config、env、settings)、核心业务逻辑、数据库模式与迁移、API 路由与处理器、共享工具与辅助函数。
- 依赖分析:主要依赖、值得理解的自定义抽象、一致使用的模式。
- 测试覆盖:测试位置、已测试与未测试内容、测试失败所反映的系统问题。
输出 技能最终生成以下内容:
- 执行摘要:项目名称、阶段(MVP/成长/成熟)、当前开发重点、健康度评估(基于提交、issue、代码质量)。
- 近期活动(最近两周):日期、区域、变更、影响(高/中/低)。
- 开发方向:当前冲刺/重点、下一个里程碑、技术债务、机会。
- 关键发现。
- 建议:立即、短期、考虑。
使用方式 当用户要求运行迁移后的 source command catchup 时,按照上述三个阶段执行相应命令和阅读文档,并整理输出。
适用场景 适用于需要快速了解项目全貌、评估项目健康度、规划后续工作或加入新项目时。
限制 该技能依赖 Git 仓库、项目文档(如 PRODUCT.md、ARCHITECTURE.md 等)以及 GitHub CLI(gh)等工具的存在。若相关文件或工具缺失,部分分析可能无法进行。具体限制未在资料中进一步说明。
心态
- 彻底:阅读所有内容,不做假设。
- 连接点:理解决策背后的原因。
- 前瞻:项目将走向何方?
- 批判:识别风险、差距、机会。
- 记录发现:用重要发现更新 AGENTS.md。