Code Context Control (C3) Skill 技能

技能简介

Code Context Control（C3）是一款专为 AI 编程工具打造的本地代码智能层，通过 21 个 MCP 工具实现对代码库的结构化读取、精准编辑和安全管控。与传统 AI 编程方式（直接读取整个文件、盲目 grep 全库、暴力 cat 日志）不同，C3 以「手术式」操作替代「大开大合」式消耗，将 Token 浪费降低 40%~70%，同时通过访问守卫（Access Guard）和数据遮蔽（Mask Guard）防止 AI 误读敏感文件，全面提升 AI 编程的效率、安全性与可控性。

核心能力

1. 21 个 MCP 工具：涵盖搜索（c3_search）、压缩（c3_compress）、精准读取（c3_read）、原子编辑（c3_edit）、验证（c3_validate）、Shell 执行（c3_shell）、记忆（c3_memory）、会话（c3_session）、影响力分析（c3_impact）、Agent 锁（c3_locks）、CI 本地运行（c3_ci）等完整工具链
2. 访问守卫（Access Guard）：配置路径规则（deny / read_only），彻底阻止 AI 访问 .env、credentials、CSV 等敏感文件
3. 数据遮蔽（Mask Guard）：对 .env、CSV、签名文件等进行脱敏处理，AI 只能看到预设的脱敏值而非真实数据
4. Token 节省：c3_compress 返回代码结构地图（40~70% Token），配合 c3_read(symbols=...) 精确定位函数级代码
5. 会话与记忆持久化：c3_session 和 c3_memory 支持跨会话保存决策和知识图谱，AI 无需每次重新解释项目
6. 多 IDE 支持：Claude Code、Codex、Grok Build、Copilot、Cursor、Antigravity 均已适配
7. 多项目管理 Hub：c3 hub 提供跨项目任务面板、知识库搜索和凭证管理
8. Agent 锁（c3_locks）：防止多个 AI 会话同时编辑同一文件导致数据竞争
9. 凭证保险库：API 密钥等敏感数据以命名凭证形式存储，值从不进入模型上下文

安装配置

1. 环境要求：Python 3.10+，推荐使用 pipx 安装
2. 安装命令：pipx install code-context-control
3. 初始化项目：c3 init /path/to/your/project
4. IDE 选择：初始化时选择目标 IDE（Claude Code、Codex、Cursor 等），自动完成 MCP 注册
5. 带 UI 安装：pip install "code-context-control[tui]" 可选安装 Textual 图形界面
6. Docker 支持：提供 MCP Docker 镜像，隔离运行

使用步骤

1. 在目标代码库根目录执行 c3 init 完成初始化，配置访问规则
2. 在 AI 编程工具中（Claude Code 等）通过 MCP 调用 c3_* 系列工具
3. 使用 c3_search 精准搜索而非 grep 全库，使用 c3_read(symbols="函数名") 精确定位而非 cat 整个文件
4. 使用 c3_edit 进行原子编辑（带变更账本），编辑后 c3_validate 自动运行类型检查
5. 配置 Access Guard：c3 access add "secrets/**" --kind deny，阻止 AI 访问敏感路径
6. 配置 Mask Guard：c3 access mask add "data/*.csv" --preset sample_rows --params "count=20" 脱敏数据文件

适用场景

1. 大型代码库 AI 编程：避免 AI 读取过多无关代码造成 Token 浪费和上下文干扰
2. 敏感项目安全管控：在 AI 编程场景中保护 .env、API 密钥、客户数据 CSV 等敏感内容
3. 多 Agent 协作开发：c3_locks 防止多个 AI 同时修改同一文件造成冲突
4. 跨项目代码复用：Hub 模式支持同时管理多个项目，并在项目间共享凭证和上下文
5. CI 前置验证：c3_ci 在本地运行真实 GitHub Actions 工作流（通过 act 容器），在提交前发现问题
6. 会话复用：AI 编程中断后可通过 c3_session(resume) 恢复，保持上下文连贯性
7. Jira/Bitbucket 集成：AI 可直接操作工单和代码仓库，无需切换工具

适用人群

• 使用 Claude Code、Cursor、Codex 等 AI 编程工具的专业开发者
• 在大型或敏感代码库中工作的安全意识较强的工程团队
• 需要管理多个 AI 编程项目的技术负责人

工作原理

C3 在本地运行一个 MCP 服务器，所有 AI 工具调用通过 C3 而非直接访问文件系统。c3_compress 基于 AST 分析生成代码结构地图，Token 消耗远低于原始文件内容；c3_read 在地图基础上按符号名或行范围精准读取；c3_edit 以账本（Ledger）模式记录每次变更，支持回滚；Access Guard 在文件系统层面阻止或遮蔽受限路径。整个系统完全本地运行，源代码和模型输出不离开本机（除非显式调用外部模型 API）。

官方链接

• PyPI：https://pypi.org/project/code-context-control/
• GitHub：https://github.com/drknowhow/code-context-control
• 文档：https://github.com/drknowhow/code-context-control/blob/main/docs/