@fiale-plus/repo-arch
项目考古与仓库记忆工具，CLI驱动的项目历史引擎。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@fiale-plus/repo-arch。 它的用途是：项目考古与仓库记忆工具，CLI驱动的项目历史引擎。 完整的 Skill 内容见：https://321skill.com/skills/fiale-plus-repo-arch/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析当前目录下项目过去半年关于‘用户认证’模块的主要变更和决策点。”，它会调用 repo-arch 工具，扫描相关提交、PR和文档，整理出一份包含时间线、关键修改和讨论背景的结构化报告，帮助你快速理解该模块的演进历程。
介绍
在长期或多人协作的项目中，代码库的演进历史、决策背景和关键信息常常散落在各处，难以追溯。@fiale-plus/repo-arch 旨在解决这一问题，它是一个 CLI 优先的项目记忆引擎，帮助开发者挖掘和固化项目知识，避免因人员变动或时间久远导致的项目“失忆”。
它主要通过命令行工具运行，可以扫描仓库的提交历史、文档、代码注释等，提取并结构化关键信息，构建一个可查询的项目知识库。用户可以通过特定命令查询某个功能的演进历史、某个决策的上下文，或者生成项目的“记忆快照”。
该工具非常适合项目负责人、技术负责人、新加入团队的开发者，以及对代码库考古和知识管理有需求的工程师。它能帮助新人快速理解项目脉络，也能帮助老成员回顾复杂决策的来龙去脉。
使用建议是将其集成到项目的常规开发流程中，例如在关键里程碑后运行以固化知识。需要注意的是，其分析深度依赖于项目本身的文档和提交信息质量，对于提交信息混乱或文档匮乏的项目，效果可能受限。
核心特点
与同类代码分析工具相比，它更专注于“项目记忆”和“考古”场景，旨在构建可查询的、上下文丰富的项目历史知识库，而非仅仅进行静态代码分析或生成报告。其 CLI 优先的设计也使其易于自动化集成到开发流水线中。
注意事项
不适合用于分析提交信息极其简略、缺乏结构化文档或注释的“沉默型”仓库。
常见问题
repo-arch 能分析私有仓库吗？
可以，只要在本地有访问权限的仓库目录下运行即可。
它和 Git 历史查看工具有什么区别？
它不止于展示提交记录，而是提取、关联并结构化信息，形成更易理解和查询的项目记忆。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/fiale-plus-repo-arch/raw/index.md 读取 @fiale-plus/repo-arch 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/fiale-plus-repo-arch/raw/index.md（查看排版版本）