---
protocol-version: 4
---

# Autotrain Next 项目管理协议（standard-v4）

## 文档分工

- `AGENTS.md`：可随时更新的操作约束。
- `INDEX.md`：目录导航和唯一的当前接力点；阶段性更新。
- `CHANGELOG.md`：已完成的阶段性变更；使用 `#type scope:name` 强标签。
- `docs/CHARTER.md`：目标、范围和关键决策的当前权威视图；方向变化时更新。
- `CONVERSATION_LOG.md`：脱敏的用户需求、决策和验证摘要；不含凭证或业务隐私。

## 接力规则

`INDEX.md` 只保留一个 `## 当前接力点 (Handoff)`。任务完成后清理；有新的未完成事项则整体覆盖。不得新建独立 TODO、HANDOFF 或 relay 文件。

## 变更规则

完成一个功能、修复或结构调整后，向 `CHANGELOG.md` 追加：

```text
## YYYY-MM-DD #<type> scope:<name> - <一句话主题>

- Why: <一句话动机>
- 详见: <文件或提交>
```

不在 CHANGELOG 写未完成事项、密钥、身份证号或大段 diff。

## 独立性规则

- 项目根目录是运行时、配置和工作数据的唯一边界。
- 禁止 `../` 访问外部项目资源，禁止导入外部工程模块。
- 新增依赖必须安装或记录在本项目内；新增运行数据路径必须位于本项目内。
- 每次涉及路径、配置或启动入口的改动后，运行独立性检查与单元测试。

## 安全与记录

- `config.local.json`、`.env`、`work/` 由 `.gitignore` 排除。
- 对话记录只保存脱敏摘要；敏感字段以“已配置”“已导入”等状态描述。
- 真实提交、外部发送或覆盖性操作必须取得用户明确授权。

## 语言

项目说明、架构与注意事项使用中文；代码标识符使用英文。