'/%3e%3crect%20x='42'%20y='42'%20width='428'%20height='428'%20rx='104'%20stroke='rgba(255,255,255,0.12)'%20stroke-width='2'/%3e%3cpath%20d='M144%20160H228V244H144V160Z'%20fill='%230B1220'%20stroke='%2334D399'%20stroke-width='18'/%3e%3cpath%20d='M284%20160H368V244H284V160Z'%20fill='%230B1220'%20stroke='%23F59E0B'%20stroke-width='18'/%3e%3cpath%20d='M144%20300H228V384H144V300Z'%20fill='%230B1220'%20stroke='%23F59E0B'%20stroke-width='18'/%3e%3cpath%20d='M284%20300H368V384H284V300Z'%20fill='%230B1220'%20stroke='%2334D399'%20stroke-width='18'/%3e%3cpath%20d='M228%20202H284'%20stroke='url(%23ctxpm-accent)'%20stroke-width='20'%20stroke-linecap='round'/%3e%3cpath%20d='M256%20244V300'%20stroke='url(%23ctxpm-accent)'%20stroke-width='20'%20stroke-linecap='round'/%3e%3ccircle%20cx='256'%20cy='272'%20r='28'%20fill='%230F172A'%20stroke='url(%23ctxpm-accent)'%20stroke-width='18'/%3e%3c/svg%3e)
Bear. CTXPM
项目一边依赖外部 Skill、Rule，一边又会长出贴合自身业务的 AI 资源，两者混在仓库里很快就难以维护。CTXPM 用一份清单、两种归属模型和共享根入口理清边界，再让读过协议的 AI 主动检查更新、修复入口并校验结构；开发者只在归属和升级等关键决定上介入。
主要功能
给 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 资源不该像项目源码一样被提交进仓库，这是它最初要解决的问题。
先分清哪些是外部资源
区分 dependency 和 package，外部 AI 资源该像 node_modules 一样管理，不直接提交进仓库。
外部资源用清单声明，不进代码库
ctxpm.yaml 记录外部 AI 资源的来源、版本和入口，它们像依赖一样被安装和更新，跟项目文件分开版控。
只有项目自己的资源跟着仓库走
来自项目业务逻辑的 Skill、Rule、Prompt、Memory、MCP 作为 package 留在仓库里，像源码一样参与版本控制和 review。
AI 驱动优先，工具管重复劳动
协议写进 agent 入口文档，AI 在编码、review 间隙自己判断该检查更新还是校验清单；固定步骤交给本地 CTXPM CLI，归属和升级这类决策才需要你点头。
不用推倒重来就能接入
把 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 负责让工作区结构保持直观。
入口桥接是显式的
canonical 的 AGENTS.md 内容通过根入口别名服务多个 Agent，不用靠复制粘贴维持多份说明。
归属边界持续可见
什么属于项目、什么来自外部、什么该进版本控制，协议把这些边界留在明面上，不会混在一起。
为真实项目里的 AI 依赖而设计
仓库一边依赖外部 AI 资源，一边又不断长出自己的 AI 资源，这套结构就特别有价值。
- 外部共享 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.