opencode-context-manager
为AI编码助手提供持久化、低成本的代码库上下文管理工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：opencode-context-manager。 它的用途是：为AI编码助手提供持久化、低成本的代码库上下文管理工具 完整的 Skill 内容见：https://321skill.com/skills/opencode-context-manager/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“/context-update”，它会自动分析你代码库的变更，仅读取受影响的关键文件，并更新上下文文档，确保AI在后续对话中对你项目的最新状态了如指掌。或者简单地对AI提出一个关于项目代码的问题，由于上下文已自动加载，AI能直接基于完整的项目结构给出精准回答。
介绍
OpenCode Context Manager 解决了开发者在每次与AI编码助手（如Claude、Cursor）新开对话时，都需要花费大量上下文Token重复介绍项目代码结构的问题。它通过智能分析你的代码仓库，自动生成并维护一份结构化的项目上下文文档，并确保在每次与AI交互时自动包含这些信息，让AI“记住”你的项目。
使用时，你只需安装并运行一次初始化扫描，工具会在你的项目根目录下创建 .opencode/context/ 文件夹，其中包含 repo-structure.md 等模块化的上下文文件。之后，无论是使用支持该工具的AI客户端，还是通过特定命令（如 /context-update）触发，这些上下文文件都会被自动附加到你的提示词中，实现项目知识的持久化。
该工具特别适合正在使用AI辅助进行代码开发、重构或维护的开发者，尤其是那些项目结构复杂、文件众多，或者需要频繁与AI讨论同一代码库的团队。它能显著提升AI对项目的理解深度和回答的准确性。
建议在项目初期或引入重大变更后运行一次完整扫描。日常开发中，工具会基于Git变更进行增量更新，几乎不消耗额外Token。请注意，它主要面向JavaScript/TypeScript项目优化，对其他语言的支持可能有限。
核心特点
其核心区别在于创新的“静态分析先行，AI选择性阅读”的两阶段架构，能实现高达99%的Token节省；并且通过依赖图进行符号级追踪，实现真正精准的增量更新，而非简单的文件变动检测。
注意事项
主要针对JavaScript/TypeScript项目优化，对于其他语言或非标准项目结构的支持可能不完善。
常见问题
这个工具会消耗我的AI对话Token吗？
首次扫描会消耗约150-200K Token进行一次性投资，后续增量更新通常只需3-20K Token，无变更时消耗为0，相比每次手动介绍代码库可节省40%-99%的Token。
生成的上下文文件需要提交到Git吗？
建议提交 `.opencode/analysis/` 目录下的分析缓存文件，以便团队成员共享分析结果，避免重复扫描，但 `.opencode/context/` 下的文件可根据需要决定是否提交。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/opencode-context-manager/raw/index.md 读取 opencode-context-manager 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/opencode-context-manager/raw/index.md（查看排版版本）