AI·技术
文章介绍Bear. CTXPM，即上下文包管理器，用于将技能、规则、提示、记忆和MCP从分散文件中组织为声明式、可复用、可维护的项目资源。使用AI编码代理时间一长，项目就会开始收集提示之外的东西，包括约束代码风格的规则、处理日常任务的技能、描述产品边界的规范、连接外部服务的MCP配置以及记录过去决策的记忆。这些资源有的来自开源社区，有的是团队资产，有的仅适用于当前项目。起初把它们放进项目没问题，问题在项目增长、切换代理或几个月后回来时出现：哪些文件属于Git？外部资源是否已更新？这条规则适用于整个团队还是仅此仓库？当资源没有边界时，AI工作流就会变得混乱。CTXPM正是从这个问题出发。CTXPM代表上下文包管理器，是一个管理AI资源的开源协议，配有ctxpm命令行工具，像组织项目代码一样组织AI使用的上下文和能力。与传统包管理器要求开发者手动输入各种命令进行安装、更新和验证不同，CTXPM采用AI优先设计，协议规则和操作逻辑通过代理入口文档注入，结合内置技能和CLI工具，AI代理可在日常编码、审查和调试中自主检查、升级、验证和整理资源。用户无需记住子命令参数，AI读取协议、调用工具，并在需要时与用户确认决策。CTXPM不要求重写现有技能、规则或提示，也不要求项目绑定特定代理。它首先建立几项实际工作中无法回避的约定，落在三个地方：ctxpm.yaml清单、.ctxpm/目录结构和项目根目录的代理入口文档。CLI让安装、检测和验证更可靠，但协议本身不依赖CLI，即使当前环境无法运行工具，AI仍可从清单和目录理解项目。CTXPM只使用两种所有权语义：依赖和包。依赖是项目使用的外部AI资源，来源可以是Git仓库、OCI注册表、文件路径或其他位置，完整内容通常不提交到当前项目，但ctxpm.yaml记录其来源、路径和稳定版本，类似代码项目中的第三方依赖。包是当前项目自己维护的AI资源，与项目业务逻辑、代码结构或协作方式相关，应与源代码一起提交和审查，并随项目修改。资源所有权和资源类型是分开的，无论依赖还是包，资源都可属于技能、规则、提示、记忆、MCP等类型。例如，从GitHub导入的代码提交技能是依赖+技能，当前仓库特有的发布工作流是包+技能，项目自身的源代码编辑边界可以是包+规则。这样，谁维护资源、出问题找谁就不再混淆。采用CTXPM的项目通常具有如下结构：ctxpm.yaml是项目资源清单；安装的外部资源放在.ctxpm/dependencies/，通常加入.gitignore；项目维护的资源放在.ctxpm/packages/，通常纳入版本控制；.ctxpm/AGENTS.md是共享代理入口源文件，根据启用的代理配置文件，项目可在根目录生成AGENTS.md、CLAUDE.md、GEMINI.md等兼容入口，全部指向同一内容。规则维护一次，入口文件适应不同代理约定。入口文档还告诉AI如何发现资源：先读项目清单，再读项目自己的包，然后读外部依赖，仅在任务需要历史背景时加载相应记忆，上下文不会从一开始就被每个文件填满。这是AI驱动设计的关键：协议不是静态配置，而是AI的操作指南。AI按优先级读取资源，决定哪些规则适用于当前任务，并在适当时机执行资源检查和维护操作，开发者无需中断编码手动执行这些流程。Bear. CTXPM仓库本身遵循这些规则：ctxpm的管理能力和第三方git-commit技能是外部依赖，仅服务于此仓库的发布工作流是包+技能，提醒不要将产品源代码与仓库自身管理资源混合的约束是包+规则。对应清单可简化为版本1.0、项目名称Bear.CTXPM、代理generic和claude-code、依赖ctxpm技能、包ctxpm-release技能和ctxpm-source-boundary规则。清单的作用是写下责任：后来进入仓库的AI可以知道哪些内容随上游更新，哪些内容由当前项目负责，修改源代码前应阅读哪些规则。传统包管理器要求记住命令、查看文档并手动触发检查，CTXPM将这些步骤变成AI能理解和执行的协议。用户可以自己运行这些命令，也可以交给AI。项目采用CTXPM协议后，AI代理在处理日常任务时会执行相应操作。AI不只是执行固定脚本，它理解协议的语义边界，根据项目状态判断该做什么、何时做以及是否需要确认。detect和migrate处理遗留资源：先只读扫描，再由用户确认迁移什么。check-updates和update也刻意分开：先发现变化并报告，确认后再执行更新。对于常规外部Git资源，Bear. CTXPM记录资源路径最后更改的提交，而不一定是仓库最新HEAD，当大型仓库只更改其他目录时，依赖的技能不会显示虚假升级，版本号对应实际安装的资源根目录。Bear. CTXPM先定义协议，因为项目不能依赖二进制工具才能让AI理解工作环境。协议通过入口文档注入，让AI知道相关规则。创建目录、修复入口符号链接、安装依赖、计算版本、检查未管理资源、验证清单等固定步骤适合CLI；如何判断资源所有权、解释风险、是否请求确认以及如何处理迁移冲突则留给AI。协议明确规则，CLI让固定步骤稳定，AI理解语义边界并处理需要判断的部分。这样开发者可以专注于决策层，而不必记住并反复执行固定命令。采用CTXPM后，日常资源管理工作主要由AI完成，这与传统工具体验完全不同。npm install要求记住命令、查看文档并手动触发，而CTXPM的AI代理在用户编码、审查和调试时在后台检查项目状态，发现问题时主动请求用户决策。一次性AI演示可能不需要CTXPM，但项目进入长期维护后，这些情况很常见。CTXPM不替用户写提示，也不决定哪个代理更聪明，它明确资源的所有权、位置和生命周期，使AI工作流能随项目一起维护。开始集成时，可将指定句子交给正在使用的AI代理，AI会先识别项目使用的代理和现有资源，然后准备项目本地CLI、初始化目录和清单，遇到资源所有权或迁移问题时会停下来请求确认。从这一步起，CTXPM的维护流程切换到AI驱动模式。之后正常处理项目时，AI会在后台执行相应操作。如果项目已积累规则、技能、提示或记忆，尽早明确边界可节省大量整理工作。Bear. CTXPM专注于这一步：给现有上下文一个安身之处，并知道谁维护它。整个过程中，用户只做决策，其他步骤交给AI和工具。项目地址为github.com/gBearBest/Bear.CTXPM。
来源：原文链接 (新窗口)
本页由搜罗吧(Solo8.cn)信息精选服务自动生成，内容仅供参考，不构成任何建议。