# DOC-022 把文档作为可迁移的仓库资产

分类：协作与质量。级别：核心。本规则是项目写作约定，不是语言语义。

## 规则

正文、作者规则、模板和验证工具一起版本管理，个人环境与凭据不进入仓库。

## 原因

协作应依赖明确文件与流程，而不是单台电脑的聊天记忆或编辑器状态。

## 执行方法

1. 使用仓库相对路径和低依赖检查命令；远端修改前检查分支与工作区。
2. 本地编辑器状态和凭据不上传；不强推覆盖其他贡献。
3. Gitea 仅使用 codex-bot，身份与仓库 owner 分开，专用密钥在本机配置。

## 改写对照

问题写法：把个人配置与密钥一并打包，让其他电脑照搬。

推荐做法：共享 AGENTS、手册和验证脚本，各机器独立配置授权身份。

以上是说明写作差异的项目例子，不新增语言能力。

## 验收

- [ ] 他人能从 README 找到贡献流程。
- [ ] 工具无本机绝对路径。
- [ ] 提交和推送状态有记录，权限不足不换用 owner 凭据。

## 具体应用

让入口、任务索引、相对引用和必要主定义可从仓库重新取得。独立 skill 包携带写作资源，真实写作仍读取目标语言仓库；不要复制某台电脑的凭据或会话配置。

详见[跨电脑使用](../skill-usage.md)与[手册维护](../tasks/TASK-08.md)。

## 依据与边界

[SRC-11](../research/SRC-11.md)、[SRC-07](../research/SRC-07.md)。来源页记录观察与分析，本页的执行方法是针对项目的综合建议，不宣称由某一原文逐项规定。

[规则索引](../README.md#规则索引) · [检查清单](../checklist.md)