Codex 知识库同步流程

用途

固化 Codex 项目任务的知识库读取、项目文档更新、交接记录、Git 提交和线上 Quartz 发布流程，避免项目上下文和交接信息遗漏。

当前状态

• 本地可编辑真源：/Users/ayang/Projects/product-mapping/docs
• 全局规则：/Users/ayang/.codex/AGENTS.md
• 个人 skill：/Users/ayang/.codex/skills/codex-knowledge-sync/SKILL.md
• 线上展示：https://docs.gogo996.com

触发边界

以下任务按项目任务处理，开始时读取 docs/Codex与线上知识库同步.md，并根据项目名读取 docs/Codex项目/ 下的对应项目页：

• 修改代码、配置、脚本、数据库结构、服务进程或部署状态。
• 修复具体产品、系统、网站、自动化流程或线上/本地服务问题。
• 新增功能、改 UI、改交互、改运营后台、接入接口或调整业务规则。
• 结果会成为后续维护依据，或用户明确提到知识库、项目文档、交接文档、发布文档、docs.gogo996.com。

以下任务不强制生成交接文档：

• 简单确认、闲聊、翻译、概念解释。
• 纯只读小检查，且不改变项目状态。
• 用户明确要求不读取文件、不执行命令、不修改内容。

收尾规则

• 项目或阶段完成时，在 docs/交接记录/ 新增或更新交接文档。
• 如果对话开始时漏走读取流程，最终回复前必须补做同步检查，并明确说明本地更新、校验、GitHub 推送和 Quartz 发布状态。
• 不把 API Key、密码、Cookie、私钥、真实账号令牌、.env 值、数据库 dump 或原始日志写入文档。

验证与发布

cd /Users/ayang/Projects/product-mapping
./scripts/docs-check.sh
git diff --check
./scripts/publish-docs.sh "更新 Codex 知识库同步流程"

如缺少 SSH、GitHub、服务器或发布口令权限，最终回复必须明确阻塞步骤。