conport-mcporter-skills

通过按需调用MCP工具,为Claude Code提供持久化项目记忆,同时避免上下文窗口膨胀。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:conport-mcporter-skills。
它的用途是:通过按需调用MCP工具,为Claude Code提供持久化项目记忆,同时避免上下文窗口膨胀。
完整的 Skill 内容见:https://321skill.com/skills/conport-mcporter-skills/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我初始化这个项目的ConPort数据库并加载当前上下文。”,它会引导你使用`/conport-init`和`/conport-context`命令,通过MCPorter调用后端工具,创建数据库并为你呈现项目概览、当前焦点和待办事项。当你需要记录一个技术决策时,

对AI说:“记录我们决定使用GraphQL作为API层的决策。”,它会通过Skill调用`conport.log_decision`工具,帮你将决策摘要和理由持久化到项目知识库中。

介绍

在Claude Code中直接安装MCP服务器会带来一个隐藏成本:工具描述膨胀。像ConPort这样的MCP服务器会暴露25个以上的工具及其详细的JSON模式,这些信息会消耗宝贵的上下文窗口,即使你并未使用它们,导致令牌浪费并挤占实际对话空间。

该Skill的解决方案是使用MCPorter通过命令行按需访问ConPort MCP工具。你无需在Claude Code中配置MCP服务器,而是通过Skill在需要时调用特定的MCPorter CLI命令来执行操作,如获取项目上下文或记录决策。工具描述仅在Skill被激活时临时引入,而非永久驻留在上下文中。

它非常适合需要长期维护项目上下文、记录架构决策、管理开发知识,但又希望最大化Claude Code上下文窗口效率的开发者。无论是启动新项目、进行代码审查,还是进行项目交接,都能通过它来系统化地管理和调用项目记忆。

使用时请注意,你需要预先在系统上安装Node.js(用于运行npx)和Python(用于安装uvx和conport-mcp)。由于工具是CLI调用,其可用性取决于外部命令的执行成功,且响应速度可能略低于直接集成的MCP服务器。

核心特点

核心区别在于采用“按需调用”模式,将MCP工具描述从常驻上下文窗口中移除,仅在Skill激活时通过CLI执行具体命令,从而将每次请求的Token开销从约2000+降至近乎为零,显著优化了上下文利用率。

注意事项

不适合需要MCP工具描述常驻上下文以实现即时、零延迟工具调用的场景。

常见问题

这个Skill和直接安装ConPort MCP服务器有什么区别?

直接安装会使所有工具描述常驻上下文,浪费Token;而此Skill通过MCPorter按需CLI调用,工具描述不入上下文,节省Token。

使用前需要安装什么?

需要Node.js(用于npx)、Python以及通过pip或pipx安装的uvx工具。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/conport-mcporter-skills/raw/index.md 读取 conport-mcporter-skills 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。