# Claude Code 项目入口

本仓库的完整开发规则以 [AGENTS.md](AGENTS.md) 为唯一事实来源。

Claude Code 开始任何工作前，必须按顺序阅读：

1. 根目录的 `AGENTS.md`；
2. Gitea Wiki 的项目档案；Wiki 不可用时读取 `docs/00-project-profile.md` 镜像并明确其 revision；
3. Gitea Wiki 的架构与代码地图、业务规则，以及任务直接涉及的主题页；
4. 任务涉及目录中更具体的 `AGENTS.md`；
5. 当前 Gitea 工单及其父级 MVP、Epic 工单。

必须遵守以下入口规则：

- 方案经用户确认并建立单元任务工单后，才能修改产品代码。
- 只修改当前工单范围内的文件，保留用户已有和无关的改动。
- 在单元任务中明确文档影响；入口、命令、配置、数据、业务规则或排错方式变化时先更新对应 Wiki。
- 严格遵守 `AGENTS.md` 的效率与范围控制：优先真实反馈、复用未失效的检查结果、完成必要闭环后停止，但不得省略安全和最终验收。
- 实现、测试、Git 提交、待验收、Wiki 任务归档、导出本地镜像和关闭工单的顺序不得跳过。
- 长期文档先修改 Wiki，再导出 `docs/`；不得直接编辑镜像作为最终结果。
- 未经用户明确验收，不得关闭工单。
- 不得把密码、令牌、Cookie、私钥或生产数据写入代码、日志、工单和文档。

不要在本文件复制完整工作流。流程发生变化时只更新 `AGENTS.md`，本文件保持为 Claude Code 的稳定入口，防止两套规则不一致。