1.7 KiB
1.7 KiB
DOC-022 把文档作为可迁移的仓库资产
分类：协作与质量。级别：核心。本规则是项目写作约定，不是语言语义。
规则
正文、作者规则、模板和验证工具一起版本管理，个人环境与凭据不进入仓库。
原因
协作应依赖明确文件与流程，而不是单台电脑的聊天记忆或编辑器状态。
执行方法
- 使用仓库相对路径和低依赖检查命令；远端修改前检查分支与工作区。
- 本地编辑器状态和凭据不上传；不强推覆盖其他贡献。
- Gitea 仅使用 codex-bot，身份与仓库 owner 分开，专用密钥在本机配置。
改写对照
问题写法：把个人配置与密钥一并打包，让其他电脑照搬。
推荐做法：共享 AGENTS、手册和验证脚本，各机器独立配置授权身份。
以上是说明写作差异的项目例子，不新增语言能力。
验收
- 他人能从 README 找到贡献流程。
- 工具无本机绝对路径。
- 提交和推送状态有记录，权限不足不换用 owner 凭据。
具体应用
让入口、任务索引、相对引用和必要主定义可从仓库重新取得。独立 skill 包携带写作资源，真实写作仍读取目标语言仓库；不要复制某台电脑的凭据或会话配置。