Codex 知识库自动同步规则交接文档

本次目标

将“开始任务自动读取知识库、结束阶段自动写交接并发布线上文档”的要求固化为 Codex 全局规则和个人 skill。

已完成内容

新增个人 skill：/Users/ayang/.codex/skills/codex-knowledge-sync/SKILL.md。
更新全局规则：/Users/ayang/.codex/AGENTS.md。
更新知识库同步规范：docs/Codex与线上知识库同步.md。
本交接文档记录本次规则变更。

代码位置

本地文档库：/Users/ayang/Projects/product-mapping
Skill 路径：/Users/ayang/.codex/skills/codex-knowledge-sync
全局规则：/Users/ayang/.codex/AGENTS.md
私有 Git 仓库：https://github.com/961608564/project-docs-quartz_2026-07-20

使用方式

后续新会话可以直接说：

按 codex-knowledge-sync 流程处理当前项目。

Codex 应先读：

/Users/ayang/Projects/product-mapping/docs/Codex与线上知识库同步.md

项目完成后生成或更新 docs/交接记录/ 并发布。

测试结果

Skill 验证：quick_validate.py /Users/ayang/.codex/skills/codex-knowledge-sync 通过。
全局规则已追加到 /Users/ayang/.codex/AGENTS.md。

部署或发布状态

待随本次文档发布同步到 GitHub private 和 docs.gogo996.com。

风险和待办

Codex 不能真正无权限后台自动推送；如缺少 SSH、GitHub 或网络权限，需要用户授权。
发布脚本可临时读取 SERVER_DOCS_PASS，但不得保存密码。

安全说明

本文档不记录 API Key、密码、Cookie、私钥、真实账号令牌。