32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
# CLAUDE.md
|
|
|
|
> Claude Code 的仓库级薄入口。进入本仓库后，先读本文，再读 [`AGENTS.md`](AGENTS.md)。
|
|
|
|
本仓库的权威 agent 规则、文档入口、工作边界和验证方式统一维护在
|
|
[`AGENTS.md`](AGENTS.md)。
|
|
|
|
Claude Code 处理本仓库任务时：
|
|
|
|
1. 先读取 [`AGENTS.md`](AGENTS.md)。
|
|
2. 再按其要求进入 [`docs/00-ai-start-here.md`](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 判断，不以版本号判断。
|