development-workflow（简称 dw）是一组面向 Codex 的开发工作流 skill。它先按已确认事实选择最短安全路径，再提供自动连续的文档交接、已批准小改动的受控实施和独立 AGENTS rule governance：
development request → fast | standard | full | blocked
standard → PRD → spec+plan technical package → development prompt
full → PRD → approved spec → reviewed plan → development prompt
approved bounded change → implementation
substantive development → AGENTS rule governance
仓库同时提供 plugin-compatible 打包、repo marketplace、可复现验证和脱敏后的评估证据。六个 skill 职责独立；路由器只分类和交接，完整文档链通过路径与批准状态协作，受控实施入口直接执行用户已批准的边界，规则治理入口只处理有证据且逐 diff 批准的长期规则，均不依赖本机安装路径或插件缓存。
| Skill | 职责 |
|---|---|
routing-development-workflows |
在没有显式 workflow 入口时，依据批准、范围、风险和验证事实选择 fast、standard、full 或 blocked，只输出稳定交接，不创建文档或实施 |
creating-product-requirements |
澄清产品范围、用户场景和验收标准；已有批准基线时默认生成不复刻完整基线的单主题增量 PRD，否则生成完整 PRD；门禁打开后自动进入 spec workflow |
creating-development-specs-and-plans |
校验已批准 PRD；standard 把 spec+plan 合并为一次技术包评审，full 保留逐级批准；十四字段验证通过后自动进入会话路由 |
generating-development-prompts |
从已批准十四字段或显式请求判断当前会话、新会话或阻塞；仅在需要新会话时生成单一代码框中的可复制提示词，并为后续实施传递轻量比例检查边界 |
implementing-bounded-changes |
在用户明确批准后，以冻结范围、比例化 TDD、定向验证和文档同步完成小改动或 Bug 修复；在首个新鲜 GREEN、扩张写入前和最终 diff 静默收敛非必要工作，只在真实暂停时即时打断；轻量低风险行为变更可按证据免独立评审，中等任务按真实风险判断，高风险边界保持强制评审 |
managing-agents-rules |
在实质性开发前检查项目根规则，并在任务完成时对有证据的项目级或全局 AGENTS 规则候选执行逐 diff 批准治理 |
通过 repo marketplace 安装完整 plugin bundle：
codex plugin marketplace add itstarts/development-workflow --ref v0.1.6
codex plugin add development-workflow@development-workflow当前稳定版本为 v0.1.6。catalog 与 plugin entry 均固定到该不可变 tag，避免安装内容随 main 变化。
也可以通过 skill-installer 一次安装全部 skill：
python3 \
"${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
--repo itstarts/development-workflow \
--ref v0.1.6 \
--path \
skills/routing-development-workflows \
skills/creating-product-requirements \
skills/creating-development-specs-and-plans \
skills/generating-development-prompts \
skills/implementing-bounded-changes \
skills/managing-agents-rules还可以只安装一个 skill。安装器在目标目录已存在时会停止，不会静默覆盖。完整步骤、两种安装方式和安全更新边界见 安装指南。
routing-development-workflows在没有显式入口时选择一条路径：只有范围稳定、用户已批准实施、无高风险边界且定向验证充分时进入fast；普通需求进入standard；公共契约、架构、数据、权限、迁移、并发、一致性或外部状态等边界进入full；确定性能力或授权缺口进入blocked。creating-product-requirements在理解置信度达到 95% 且用户确认摘要后创建 PRD。存在可靠批准基线时默认另建增量 PRD，只写确认摘要中的变化和必要影响，不覆盖或复刻完整基线；没有相关基线时创建完整 PRD。route 与风险事实仍保存到工作流分流，不改变 canonical 八字段。PRD 经独立评审和用户批准后，在同一会话自动进入 spec workflow。creating-development-specs-and-plans复验 PRD，并把已批准 PRD 作为产品范围上限，只补满足需求、适用规则或已确认风险所需的最小技术细节。standard在 spec 用户批准前先生成 spec+plan 草案，由一位 reviewer 统一评审；评审通过但 spec 未获用户批准时，计划评审真实保持已通过，实施门仍关闭。full保留 spec 评审→用户批准→plan 评审的逐级顺序。评审项必须区分范围内阻断、需要扩围和非阻断建议；扩围不进入当前修复，复审只检查原阻断项、变更区域和修复回归。generating-development-prompts基于已验证十四字段和当前会话证据输出current-session、new-session或blocked；它分别保留计划评审状态与实施门，不会把“技术包已评审、spec 待用户批准”误判为可实施。current-session只说明后续实施边界，不生成提示词或提前开工；生成的提示词也保留相同比例检查合同。
普通非阻塞澄清只显示固定三行“当前阶段 / 主题 / 下一步”；暂停、阻塞、摘要确认、批准、文档阶段完成与跨 skill 交接继续显示完整中文八字段或十四字段。内部英文 canonical 字段、门禁计算与旧英文输入兼容性保持不变。完整契约见工作流与文档契约。
对于不需要 PRD、spec 和 plan 的已确认小改动，implementing-bounded-changes 在用户明确批准推进后冻结改动点、方案、非目标、验证和文档边界，再执行最小 TDD、定向验证和相关文档更新。首次取得新鲜 GREEN 后、可能写入扩张内容前和检查最终 diff 时，它会把剩余工作分为当前必需、延后、证据支持的移除或需要用户决定的暂停；正常继续保持静默，延后和移除只在最终交付中简报，只有暂停即时打断用户。没有批准验收、规则、已确认风险、当前回归或具体失败依据的想法不会继续开发，也不会为此创建持久状态。同一相关状态下已通过的检查不会因评审或 Agent 交接而重复运行；变化只使受影响结果失效，仓库要求的最终门在最后一次相关变化后运行一次，并在覆盖同一 focused seam 时直接充当 GREEN。任务中形成的项目验证映射只作为可选规则候选展示，必须由用户逐 diff 选择是否加入项目 AGENTS.md。评审先服从当前用户指令和项目规则：局部、可逆、有确定性行为测试且不触及共享或高风险边界的轻量行为变更默认可免独立评审；中等任务根据真实边界、可逆性和验证覆盖判断，不因任务标签自动升级；数据、迁移、权限、安全、资金、不可逆操作、并发、事务和一致性等高风险边界默认强制最终评审。评审 finding 分为范围内阻断、需要扩围和非阻断建议；没有现有验收、契约、规则、回归或具体高风险正确性依据的普通 P2 只记录，不进入修复—复审循环。只有范围内阻断进入同一 reviewer 的复审；连续两轮仍未通过时停止自动循环并保持阻塞。
managing-agents-rules 独立应用于实质性开发的前置检查和完成扫描。它不会调用其它 skill，也不会自动写规则；每个项目级或全局候选都必须有当前任务证据、明确目标和当前最小 diff，并取得只对该 diff 有效的批准。
默认文档路径、批准门和交接字段见 工作流与文档契约。
修改前完整读取 AGENTS.md 和作用域更深的规则。Agent 角色、TDD 证据、独立评审和发布边界见 Agent 开发指南。
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python scripts/validate_repo.py
.venv/bin/python -m unittest discover -s skills/routing-development-workflows/tests -v
.venv/bin/python -m unittest discover -s skills/creating-product-requirements/tests -v
.venv/bin/python -m unittest discover -s skills/creating-development-specs-and-plans/tests -v
.venv/bin/python -m unittest discover -s skills/generating-development-prompts/tests -v
.venv/bin/python -m unittest discover -s skills/implementing-bounded-changes/tests -v
.venv/bin/python -m unittest discover -s skills/managing-agents-rules/tests -v
# 当前 evaluation stage 对应的定向检查；全部 review-approved 后可使用 --full
.venv/bin/python scripts/check.py --skill creating-product-requirements完整验证命令见 Agent 开发指南。支持 Python 3.9 及以上；日常和发布验证使用项目当前 .venv，不要求重复运行第二个 Python 版本。
| 文档 | 内容 |
|---|---|
| 安装指南 | 安装、单 skill 安装和安全更新 |
| 工作流与文档契约 | 完整交接链、受控实施入口、默认路径和批准门 |
| Agent 开发指南 | 仓库规则、TDD、评估、评审和发布流程 |
| Release notes 规范 | GitHub Release 的结构、内容边界和版本链接规则 |
| CONTRIBUTING.md | 贡献范围和提交前检查 |
| SECURITY.md | 安全问题报告和敏感信息边界 |
| CHANGELOG.md | 版本变化 |
MIT © itstarts