# CC-02～CC-03 配套：资产检查工作流

这是教学项目：沿用[CC-01检查器](<../CC-01_asset_naming/README.md>)，演示项目上下文、工作流扩展和缺陷定位。资产规则是教学约定，不代表引擎默认标准。

## 从哪里开始

1. CC-02：读[CLAUDE.md](<CLAUDE.md>)、[资产规则](<docs/资产规则.md>)与[计划和交接模板](<templates/计划与交接.md>)，区分长期规则与本次任务。
2. CC-02：读[Skill](<.claude/skills/asset-audit/SKILL.md>)、[只读子Agent](<.claude/agents/asset-reviewer.md>)、[Hook配置](<.claude/settings.json>)与[脚本](<hooks/guard_write.py>)。MCP只提供[未连接的模板](<.mcp.example.json>)。
3. CC-03：比较[缺陷函数](<debug/extension_buggy.py>)和[修复函数](<debug/extension_fixed.py>)，运行固定答案检查，再用[评审与交付模板](<templates/评审与交付.md>)说明结果。

本版本把旧版扩展和调试内容纳入 CC-02、CC-03。文件夹和结果文件中的 `CC-02-04` 保留历史名称，运行入口保持一致。

在本目录运行：

```powershell
python run_checks.py
```

在学习项目根目录也可以运行：

```powershell
python V2.0/示例/ClaudeCode/CC-02-04_asset_workflow/run_checks.py
```

程序只读原始检查器与样本，将证据保存到`检查记录/CC-02-04_示例检查.json`。结果包括9个扩展名固定答案、7个CLI场景、12个Hook输入场景以及输入文件哈希。成功退出0，检查不符合预期时退出1。

## 实际检查与尚未实测

| 内容 | 验证方式 |
|---|---|
| 大小写教学缺陷 | 缺陷版本在3个大写扩展名样本上违反固定答案；修复版本应符合全部9个答案 |
| CC-01命令行合同 | 实际运行7个场景，核对JSON／stderr／退出码 |
| Hook脚本 | 实际用stdin JSON调用配置中的命令，包括不同cwd、路径边界与错误输入 |
| 配置格式 | JSON可解析，Skill和Agent元数据可检查；不是Claude运行时配置验收 |
| 原始输入 | 检查前后哈希一致 |
| Claude Code加载与模型行为 | 未执行真实模型会话，不能声称Skill调用、Subagent编排或Hook触发已经验证 |
| MCP与引擎 | 未连接MCP、未启动游戏引擎 |

## Claude Code会话中的练习

进入本目录再启动Claude Code。先检查`/context`、`/permissions`、`/agents`及`/help`，确认当前版本实际加载内容；按需使用`/asset-audit`。

项目配置的PreToolUse只匹配Edit／Write；Python脚本把目标解析到项目根目录，保护`protected/`。`CLAUDE_PROJECT_DIR`由Claude Code传给Hook。本套检查构造了同样的环境和stdin输入，只证明脚本与命令执行正确。

`allowed-tools`不作为Skill只读的排他工具列表；只读子Agent明确限定Read、Glob、Grep。MCP模板中的`https://example.com/mcp`是占位地址，不应直接连接。

教学文件可以复制到自己的试验项目后修改；原始学习笔记及CC-01输入样本保持只读。实际结果和环境以生成的JSON为准。