development-workflow

development-workflow（dw）现在只提供一个 skill：

明确需求 → 给出设计 → 实施 → 验证 → 独立复审 → 修复并复审 → 完成

它保留真正影响质量的门：

• 主 Agent 明确目标、范围、非目标和验收标准；
• 实施前给出与风险相称的设计；
• 生产代码完成验证后进行一次真实独立复审；
• 高风险数据、权限、安全、迁移、并发或不可逆设计在实施前先复审；
• reviewer 提出范围内阻断项后，由同一 reviewer 复审修复结果。

小需求与大需求

小需求同时满足：只有一个可独立验收结果、边界清晰、局部可逆、能在当前任务内定向验证，且不改变架构、共享契约或高风险边界。跨文件修改不自动变成大需求。

大需求出现任一情况：包含多个可独立验收结果；需要跨会话、分阶段或多个验证里程碑；改变架构、共享契约、数据、权限、安全、迁移、并发等高风险边界；必须先确定关键拆分或方案取舍。

• 小需求：对话内短需求摘要 + 短设计，直接实施。
• 大需求：创建需求文档和总体设计文档；两份文档作为一个 package 由 design_reviewer 评审，修复至 APPROVED 并由用户确认后，再拆成已确认的有界子需求。
• 子需求：继承父 requirements/design，不重新做独立需求分级或重复创建文档。它可以实施父设计已覆盖的数据、权限、迁移等高风险边界，但仍保留适用的高风险验证和专业复审；只有改变父范围、验收、架构、契约或关键拆分时才更新并重审父 package。

dw 不再为所有任务创建默认 PRD、spec、plan、开发提示词或多段 handoff，也不再安装 collaboration Hook。

Skill

Skill	职责
developing-software	从需求与设计直接推进到实施、验证和独立复审

主 Agent 可把有界探索交给内置 explorer、把独立实现切片交给内置 worker，但始终负责需求、设计、集成、验证和完成声明。reviewer 只读，不替用户批准扩围。

安装

通过 repo marketplace 安装完整 plugin：

codex plugin marketplace add itstarts/development-workflow --ref v0.2.0
codex plugin add development-workflow@development-workflow

也可以只安装 skill：

python3 \
  "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo itstarts/development-workflow \
  --ref v0.2.0 \
  --path skills/developing-software

上述命令固定到 v0.2.0 tag；安装完成后仍需核对正式安装状态，并在新 Codex 任务中确认 skill 已重新加载。完整边界见安装指南。

开发与验证

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
.venv/bin/python scripts/check.py --skill developing-software
.venv/bin/python scripts/check.py --full

工作流合同见工作流说明。

License

MIT © itstarts