44 lines
1.7 KiB
Markdown
44 lines
1.7 KiB
Markdown
# 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)
|