48 lines
1.7 KiB
Markdown
48 lines
1.7 KiB
Markdown
---
|
||
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` 排除。
|
||
- 对话记录只保存脱敏摘要；敏感字段以“已配置”“已导入”等状态描述。
|
||
- 真实提交、外部发送或覆盖性操作必须取得用户明确授权。
|
||
|
||
## 语言
|
||
|
||
项目说明、架构与注意事项使用中文；代码标识符使用英文。
|