git-context-controller
为AI智能体提供基于Git的轻量级结构化记忆管理
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：git-context-controller。 它的用途是：为AI智能体提供基于Git的轻量级结构化记忆管理 完整的 Skill 内容见：https://321skill.com/skills/git-context-controller/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我们尝试用另一种方法解决这个问题”，AI会使用GCC创建新的Git分支和工作区进行隔离实验。完成后，你可以说“把实验分支的结果合并进来”，AI会调用GCC执行合并操作，并将关键决策记录到索引中。随时可以问“我们刚才做到哪了？”，GCC会提供简洁的进度摘要。
介绍
Git Context Controller (GCC) v2 旨在解决LLM智能体在长对话或跨会话中容易丢失上下文记忆的核心痛点。它通过将智能体的进展与Git版本控制系统深度绑定，将冗长的Markdown对话记录转化为仅包含哈希值、意图和决策摘要的轻量级索引（约50个token），从而实现高效、可追溯的记忆管理。
使用时，智能体可以通过自然语言或特定命令（如“保存这个里程碑”、“显示最近的活动”）来触发GCC。系统会自动在项目根目录创建.GCC文件夹，在Git模式下，它会生成真实的Git提交并记录指针；在无Git仓库的独立模式下，则回退到与v1兼容的Markdown文件。核心功能包括保存进度、创建实验分支、合并结果、按需重构完整上下文以及清理旧工作区。
该Skill特别适合需要长期、结构化管理项目上下文的前后端开发、全栈开发、智能体开发以及项目经理等角色。它帮助开发者和AI协同工作时，保持对项目历史、决策原因和实验路径的清晰记忆。
建议在已有Git仓库的项目中使用以获得最佳体验（Git模式）。在独立模式下功能受限。注意，它管理的是“项目上下文”而非一般性的对话历史，更适合用于编码、文档编写等有明确产出物的协作场景。初次使用后，建议通过“/gcc context —summary”快速了解当前状态。
核心特点
与同类记录对话历史的Skill不同，GCC v2的核心区别在于其“Git优先”的设计理念：它不存储冗长的对话副本，而是将智能体的每个“里程碑”转化为真实的Git提交，仅保存指向该提交的轻量级元数据（哈希、意图、决策笔记），从而确保记忆的“单一事实来源”并极大优化Token消耗。
注意事项
不适合用于管理非项目导向的日常闲聊或没有明确版本控制需求的通用对话历史。
常见问题
GCC v2和v1有什么区别？
v2采用极简的索引文件（~50 token/条）指向真实Git提交，存储效率比v1的Markdown文件（~500 token/条）提升约10倍，且数据源更可靠。
没有Git仓库能用吗？
可以，GCC会自动降级到Standalone模式，使用Markdown文件记录，但会失去Git带来的分支、隔离和精准重构等核心优势。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/git-context-controller/raw/index.md 读取 git-context-controller 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/git-context-controller/raw/index.md（查看排版版本）