代码提交与文档站发布

项目 PRJ202609247653 的协作说明。此页说明目标流程；Mark 2026 的独立 GitHub 上传身份尚未配置，不能把流程写成已跑通。

项目代码私有 GitHub 仓库；生产分支 main
本地目录各电脑从同一仓库克隆；本机绝对路径可以不同，仓库内文件结构按提交版本同步。
文档站Cloudflare Pages 从 main 自动部署 项目文档/；正式地址公开访问。
产品服务尚未部署；本页的 Pages 流程只发布项目文档，不代表前端应用或后端服务上线。

一次修改如何交付

  1. 项目经理派任务：写清实际负责 Agent、修改范围、依赖与验收条件；同一页面或接口有多人修改时先定集成负责人和顺序。
  2. 责任 Agent 开发：开工前同步最新 main，在自己的任务分支修改并自测。两台电脑可各有一份仓库；同一电脑只有轮流写入时才共用一个工作目录，并行写入需隔离工作目录。
  3. 责任 Agent 提交：提交前将最新 main 合入任务分支，解决冲突并重测；只提交本任务文件，推送任务分支并创建 PR。在项目群 @项目经理，附 PR、实际执行 Agent、改动文件与验证结果。通用 Git 步骤见 GitHub 操作 Skill。
  4. 审查与合并：研发负责人或指定审查人核对代码、接口和测试；需求冲突由产品负责人判断。提交者修复问题。项目经理确认验收后合并 PR 到 main。任务分支推送或预览不算正式发布。
  5. Pages 发布验证：合并后 Git 集成触发文档站生产部署；发布负责人核对 Deployment 对应提交、正式地址实际内容与访问策略，再记入发布记录。通用部署与回滚步骤见 Cloudflare Pages 上线 Skill。

两条共享 Skill 的多人协作修订仍在审核；GitHub Skill 旧版“日常更新”示例直接推 main，不适用于本项目的多 Agent 交付。本项目先按本页的任务分支与 PR 流程执行。

当前免费私有仓库不能强制协作者只走 PR。获得写权限的机器身份在技术上也能直接推 main；“不得直推”须由执行约定和发布核验落实。凭据不写入仓库、页面或项目群。此公开文档站不得放内部项目卡正文、密钥或未公开资料。