Bear. CTXPM
项目依赖外部 Skill、Rule,也会积累与自身业务相关的 AI 资源。两者混在仓库里,时间久了就难以维护。Bear. CTXPM 是一套配有 CLI 的开源协议,把外部资源作为依赖管理,让项目自己的资源留在仓库里。AI Agent 可以按协议检查更新、校验结构,资源归属和升级由你决定。
主要功能

给 AI Agents 的一句话安装指令
把下面这条指令直接交给你的 Agent,它就可以开始检查、安装、初始化,并把当前项目整理成 CTXPM 兼容结构。
Please follow the instructions in https://raw.githubusercontent.com/gBearBest/Bear.CTXPM/latest/INSTALL.md to inspect, install, initialize, and refactor this project into a Bear.CTXPM-compliant structure for managing AI dependencies and resources.像项目依赖一样管理 AI 资源
把外部 Agent Skills、规则和项目自有资源分开管理。
先分清哪些是外部资源
区分 dependency 和 package,外部 AI 资源该像 node_modules 一样管理,不直接提交进仓库。
用清单记录外部 Skills
ctxpm.yaml 记录外部 AI 资源的来源、版本和入口,它们像依赖一样被安装和更新,跟项目文件分开版控。
只有项目自己的资源跟着仓库走
来自项目业务逻辑的 Skill、Rule、Prompt、Memory、MCP 作为 package 留在仓库里,像源码一样参与版本控制和 review。
AI 驱动优先,工具管重复劳动
协议写进 agent 入口文档,AI 在编码、review 间隙自己判断该检查更新还是校验清单;固定步骤交给本地 CTXPM CLI,归属和升级这类决策才需要你点头。
在已有项目中接入 CTXPM
把 INSTALL.md 交给 AI,它会按引导迁移到 CTXPM 架构,自动整理外部与内部资源,同时兼容现有 Agent 和原生资源发现方式。
1. 把 INSTALL.md 交给 AI
AI 从现有项目状态开始检查、安装、初始化,不需要先手动重写整套结构。
2. 自动整理外部与内部资源
外部 Skill、Rule 等共享资源整理为 dependency,项目自身沉淀的资源整理为 package,两类资源不再混在一起。
3. 兼容已有 Agent
迁移后的结构兼容已有 Agent,也更容易被原生 Agent 自动发现相关资源;需要标准化的关键流程,交给本地 CTXPM CLI 保证一致性。
AI 能做什么,你做什么
采用 CTXPM 后,资源管理的日常工作主要由 AI 完成,你只需要在关键节点做决策。
AI 会自主执行
- 扫描项目,发现未受管的 AI 资源。
- 读取 ctxpm.yaml,理解资源归属和依赖关系。
- 在合适时机检查外部依赖是否有更新。
- 修复入口 symlink,保持目录结构一致。
- 按优先级加载资源,避免上下文浪费。
外部 Git 依赖只跟踪资源路径最后一次变化的 commit,不是仓库最新的 HEAD,其他目录的改动不会触发一次假升级。
你只需要做决策
- 散落的资源是迁移到 packages,还是标记为 dependency?
- 外部依赖有新版本,是否升级?
- 规则冲突时,保留哪一份?
AI 资源的共享结构
目录布局、清单声明和兼容入口共用同一套约定,人和 AI 能对上同一个心智模型。
清单与文件系统同步可读
ctxpm.yaml 负责声明资源,.ctxpm/packages 和 .ctxpm/dependencies 负责让工作区结构保持直观。
跨 Agent 共享 AGENTS.md
通过根入口别名,多个 Agent 可以读取同一份 AGENTS.md 指令,无需维护重复文件。
归属边界持续可见
什么属于项目、什么来自外部、什么该进版本控制,协议把这些边界留在明面上,不会混在一起。
哪些项目适合使用 CTXPM
如果项目同时使用社区 Agent Skills、规则和自有 AI 资源,CTXPM 可以帮你记录来源并维护它们。
- 外部共享 AI 资源像 node_modules 一样明确声明,不混进日常提交。
- 项目自有的 Skill、Rule、Prompt、Memory、MCP 配置像源码一样进版本控制。
- AGENTS.md、CLAUDE.md 等根入口桥接到同一套入口说明,不用维护重复内容。
- AI 先按协议手工工作,等确定性的初始化和维护步骤值得标准化,再切换到本地 CTXPM CLI。
先有协议,再有 CLI
核心价值是一套 AI 在没有专门可执行文件之前也能理解和执行的长期约定。
把该进仓库的才放进仓库
项目内 AI 资产和该保持依赖属性的外部资源不会再混在一起提交。
可迁移到不同 Agent
同一个仓库能让 Codex、Claude Code、Antigravity 或 generic 工作流读到同一套资源约定。
把仓库里的 AI 层整理起来
从 README 和 INSTALL 指南开始,这套协议会跟着项目里的 AI 资源一起长大。
Please follow the instructions in https://raw.githubusercontent.com/gBearBest/Bear.CTXPM/latest/INSTALL.md to inspect, install, initialize, and refactor this project into a Bear.CTXPM-compliant structure for managing AI dependencies and resources.