项目配置

Files To Know

项目根目录/
├── AGENTS.md          # 唯一协作规范入口
├── CLAUDE.md          # Claude Code 兼容跳转壳
├── PROJECT_STATE.md   # 任务状态（执行时自动创建，默认加入 .gitignore）
└── docs/
    ├── WORKFLOW_TEMPLATES.md      # 工作流 SOP
    ├── PROJECT_STATE_TEMPLATE.md  # PROJECT_STATE 模板
    ├── REVIEW_TEMPLATES.md        # 评审标准
    └── ARCHITECTURE.md            # 项目架构

PROJECT_STATE At A Glance

PROJECT_STATE.md 是任务级状态面板，当前固定 9 个区块：

1. 目标
2. 下一步 Top 3
3. 阻塞项
4. 关键决策索引（最近 3 条）
5. 关键决策日志（全量追加）
6. 验收证据（Evidence）
7. 未验证清单（Gaps）
8. 提交计划
9. Execution Contract

首次执行 feat/fix/refactor/chore 任务时自动创建，并默认加入 .gitignore。

需要更新它的时机：

• 列出或更新 todo 时
• 开始或完成某个 todo item 时
• 遇到阻塞或决策点时
• 阶段切换时
• commit 后

Commit Rules

• 只有用户明确要求时才执行 git commit
• 默认不执行 git push
• PROJECT_STATE.md 默认加入 .gitignore，不跟仓库同步
• Co-Authored-By 使用当前模型名

Context Handoff

当对话变长、上下文变脏或准备切新会话时，只做这四件事：

1. 暂停当前任务
2. 更新 PROJECT_STATE.md
3. 只在用户明确要求时提交
4. 给出下一轮该从哪里继续