cmbuyer/CLAUDE.md

CLAUDE.md

Claude Code 的仓库级薄入口。进入本仓库后，先读本文，再读 AGENTS.md。

本仓库的权威 agent 规则、文档入口、工作边界和验证方式统一维护在 AGENTS.md。

Claude Code 处理本仓库任务时：

1. 先读取 AGENTS.md。
2. 再按其要求进入 docs/00-ai-start-here.md。
3. 不在本文重复维护任务流程、编码规则或文档清单，避免与 AGENTS.md 漂移。

本机工作模式

• 主会话规划分析用 Opus，plan 阶段自动切换。
• 范围不确定、需要跨多目录扇出的只读探索派 Explore 子代理；范围明确时主会话直接 查证更快，也不丢失已积累的上下文。
• 方案确认后，具体编码可派 general-purpose 子代理（配 model: "sonnet"）执行。 派发时必须在 prompt 里逐条写死不可改动的项（安全边界、判定式、既有契约字段）， 并声明 write_paths 之外不得触碰。
• 子代理完成后主会话独立复核，不以其自我报告为准：git status 查越界写入、 git diff 逐条核对边界、独立重跑验证命令、检查行尾未被改成 CRLF。
• 不使用外部 codex agent。

本机环境

• 构建与验证工具链只在 Windows 侧，WSL 无 Go SDK、Python 环境和 Android SDK。 所有验证命令必须在 Windows 执行。
• 真机连接（USB / WiFi ADB）与设备验收只能由人工完成。agent 不得据此把任务标为 DONE。
• 交付产物新旧以 SHA-256 判断，不以版本号判断。