用途:让仓库的开发循环显式且可重复,覆盖想法收集、迭代规划、实现、验证、变更日志、PR/评审、合并、发布准备、打标签/发布以及发布说明。适用于 Codex 被要求搭建或标准化轻量 Scrum、待办与发布流程的场景。
规划优先:用于工作流搭建或较大改动时,先检查仓库,询问无法从本地判断的发布配置问题,提出工作流方案,等待用户明确指示后再修改文件;若有正式 Plan Mode 则使用,否则在对话中保持规划优先。只询问影响工作流设计的问题,如项目可见性、交付类型、发布受众、版本来源、退出产物。
首要检查:修改前执行 git rev-parse --show-toplevel、git status --short --branch,并查看顶层文档、清单文件、CI 文件、PR 模板、变更日志、发布文档、标签、部署文件和版本来源。保留仓库既有真实约定,不覆盖有意义的现有工作流文档或无关的未提交改动,优先适配现有约定。对仓库进行分类:单包、应用、服务、monorepo、文档仓库、仅本地或混合;公开、私有、内部或混合受众;GitHub、其他平台、仅本地或已部署平台工作流;以及现有版本来源、发布渠道、发布说明渠道与自动化。仓库形态不明显或现有流程文档冲突时,阅读 references/repo-adaptation.md。
标准工作流:默认链路为 idea -> backlog -> sprint -> implementation -> validation -> changelog -> PR/review -> merge -> release prep -> tag/release/publish,除非仓库已有更强约定。使用轻量 Scrum 与简洁产物:docs/sprints/backlog.md、docs/sprints/YYYY-MM-DD-sprint-N.md、CHANGELOG.md、docs/releases/、.github/pull_request_template.md 或对应平台模板。引导这些文件前阅读 references/workflow-model.md。
退出工作流:若仓库使用托管评审,优先 PR 优先路径;非平凡工作先关联待办或迭代项,在迭代工作日志中记录进展与验证,为用户可见、运维可见或与发布相关的变更更新 CHANGELOG.md;默认使用 Conventional Commits,格式 type(scope): summary;用发布准备 PR 处理版本号、变更日志定稿、部署说明与对外发布文案;从仓库选定渠道发布。修改版本、标签、变更日志、发布说明、部署记录或 CI 发布流程前,阅读 references/release-models.md。
模板使用:assets/templates/ 中模板为可适配起点而非固定文件,替换 <module-or-package>、<validation-command>、<release-build-command>、<version-source>、<version-read-command>、<tag-format>、<release-branch>、<artifact-glob> 等占位符;GitHub 发布模板仅用于包含 GitHub Releases 或 GitHub 托管产物的发布配置;删除不适用章节,保留更强的仓库特定流程,生成的文档保持简短且可实现。常用模板包括 docs/development-cycle.md、docs/sprints/README.md、docs/sprints/backlog.md、docs/sprints/templates/sprint.md、docs/releases/README.md、.github/pull_request_template.md、.github/workflows/release.yml、snippets/AGENTS.md、snippets/CHANGELOG.md。
验证:工作流变更后运行 git diff --check;尽可能解析 YAML 工作流文件;若 CI 或发布命令有变,运行仓库最小相关验证命令;确认 git status --short 只包含预期改动及用户已有改动。创建或更新本技能本身时运行:python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-creator/scripts/quick_validate.py" <skill-dir>。
限制:具体发布渠道、版本来源等需按仓库实际情况与用户选择确定,资料未提供固定默认值。