CC-02 · ClaudeCode
01 / 18
Claude Code 的项目上下文与扩展
把长期规则、重复方法和外部工具放到适合的位置。
- 分清 CLAUDE.md、Skill、MCP、Hook 与子代理。
- 核对配置发现、触发时机和实际返回。
- 为清单报告选择足够且能维护的机制。
CC-02 · ClaudeCode
02 / 18
上下文与扩展关系
CC-02 · ClaudeCode
03 / 18
按信息寿命分类
| 信息 | 载体 | 更新条件 |
|---|---|---|
| 长期项目约束 | 项目规则入口 | 实现或业务改变 |
| 本次目标 | 任务说明 | 范围与验收调整 |
| 详细规范 | 按需资料 | 对应事实变化 |
| 当前失败与结果 | 摘要和交接 | 阶段完成或中断 |
CC-02 · ClaudeCode
04 / 18
项目规则的范围与示例
输入 CSV 只读。
规则以 docs/资产规则.md 为准。
运行 run_checks.py。
报告写入指定目录。
未运行检查不得写成通过。- CLAUDE.md 和 .claude/rules/ 用于可发现规则。
- 父目录、子目录与版本影响加载。
- 规则路径与命令必须能复现。
CC-02 · ClaudeCode
05 / 18
规则冲突与维护
- 先确认当前目录、版本与实际加载上下文。
- 消除用户规则与项目规则的矛盾。
- 不宣称后加载一定覆盖先加载。
- 一次故障优先修实现和检查，再更新准确入口。
CC-02 · ClaudeCode
06 / 18
长会话摘要和交接
摘要保留
- 目标、业务边界和关键事实。
- 决定、真实结果与失败尝试。
- 剩余工作与下一项行动。
恢复时核对
- /compact 等入口以当前 /help 为准。
- 摘要不能丢失只读与单位条件。
- 恢复会话和维护长期知识用途不同。
CC-02 · ClaudeCode
07 / 18
Skill 的组成
| 组成 | 清单报告示例 |
|---|---|
| 触发与输入 | 重复资产检查；CSV 与规则 |
| 操作顺序 | 读取、检查、报告、核对 |
| 支持资源 | 已有 CLI 与输出模板 |
| 结果与验证 | 问题表、命令和固定答案 |
CC-02 · ClaudeCode
08 / 18
重复任务流程示例
Skill 说明读取指定清单与规则。
调用已有检查器，保留退出码和返回。
生成规定报告，不修改输入资产。
核对行号、规则和报告位置后交付。
CC-02 · ClaudeCode
09 / 18
MCP 工具连接
- 客户端通过服务发现工具、参数和结果 schema。
- 外部工具提供项目数据或实时环境事实。
- 连接不替代任务方法、身份校验与结果检查。
- 教材 example.com 是未连接占位地址。
CC-02 · ClaudeCode
10 / 18
配置、调用与结果核验
配置是否被读取，范围是否正确？
服务是否可连接，工具是否可见？
请求参数是否符合合同与版本？
真实返回是否满足任务，而非仅连接成功？
CC-02 · ClaudeCode
11 / 18
Hook 与确定性检查
操作前
- PreToolUse 可在动作前检查。
- guard_write.py 匹配 Edit / Write。
- 十二类 stdin 输入已有脚本检查。
操作后
- PostToolUse 时动作已经发生。
- 不能把操作后检查当成自动撤销。
- 其他工具、终端和符号链接不当然受覆盖。
CC-02 · ClaudeCode
12 / 18
子代理的使用条件
- 适合目标与产物独立的研究、只读评审。
- 委派时写清输入、允许文件和汇总方式。
- 共享文件会冲突，串行依赖不靠增加角色解决。
- 独立上下文与调用仍有用量和合并成本。
CC-02 · ClaudeCode
13 / 18
各机制选择表
| 问题 | 机制 | 选择理由 |
|---|---|---|
| 长期约束 | 规则文件 | 可发现与可维护 |
| 重复流程 | Skill 与已有 CLI | 方法复用，执行可测 |
| 外部事实 | MCP 或 API | 查询真实环境 |
| 固定事件检查 | Hook 或 CI | 确定触发与反馈 |
CC-02 · ClaudeCode
14 / 18
资产报告组合案例
一次清单任务先用明确提示与项目规则。
流程重复后，将操作顺序整理成 Skill。
需要引擎事实时再接真实查询工具。
反复误写某目录时，增加对应执行检查。
CC-02 · ClaudeCode
15 / 18
维护成本与常见误区
- 大而全配置不会自动提高任务质量。
- 写了文件不证明已发现，连接成功不证明结果正确。
- 服务、规则路径或触发条件变化后重查会话。
- allowed-tools 不能随意当作完整隔离机制。
CC-02 · ClaudeCode
16 / 18
练习与验收
- 写一张机制选择表、一份短规则和一个报告流程。
- 运行配套检查，再在自己的会话确认真实加载。
- 分开记录脚本、配置与模型行为三层验证。
- 每个机制都有具体用途，移除无用途配置。
CC-02 · ClaudeCode
17 / 18
上下文与扩展思维导图
CC-02 · ClaudeCode
18 / 18
官方文档、示例和版本
- 项目指令与 memory
规则载体、加载范围与维护
- Skills 与子代理
可复用方法与支持资源
- MCP 文档
配置、授权、连接与工具发现
- Hooks 文档与配套例
事件语义；本地示例入口在完整学习稿
- 本章完整学习稿
含解释、案例、练习与逐项来源
- 版本来源索引
来源、版本、核验日期与使用位置
核验日期：2026-10-10；CLI 2.1.295。脚本检查不代表会话触发已测。