autotrain/nextgen/docs/trio-protocol.md

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 追加：

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

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

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

独立性规则

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

安全与记录

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

语言

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