analysis-to-delivery

Analysis to Delivery

通用需求分析到开发实施工作流 — 26 个独立可组合 skill、3 个完整行业示例、13 个 CI workflow、26 个自动化脚本、15 个 pytest 测试。

它是什么

一个面向 Claude Code / Hermes / Codex / OpenCode 等 agentic coding assistants 的 agent-neutral skill/workflow 集合,提供从「需求澄清」到「开发实施」的标准化工作流。

• 26 个独立可组合 skill — 拆分为 2 router + 9 动作 + 1 编排 + 7 bridge + 7 纪律,职责单一,自由组合
• 3 个完整行业示例 — 医药 WMS / SaaS 订单 / 移动 App 积分,看完即可照搬到同类项目
• 5 个 GitHub Actions CI workflow — smoke test / SQL 方言 / 文档校验 / 字段对齐 / 全量 QA 审计
• 流程图工具链 — ASCII → Mermaid / Drawio → SVG / PNG(命令行 + VSCode 集成)

设计原则:小而精、可组合、不拥有流程。每个 skill < 300 行,改一个不影响其他。

任何团队拿到这个 skill 之后:

1. 告诉你的 agent 你的领域(医药/金融/SaaS/移动 App...)和技术栈(Java/Go/Python/Node...)
2. 用 /ask-delivery 选择对应 skill,或直接 /analysis-delivery-workflow 走完整流程(不支持 slash command 的 agent 可用自然语言触发)
3. 产出可直接交给开发的设计文档(BRD/FSD/数据模型/PRD/开发设计/测试用例)

默认不包含:实际业务代码。若用户明确启用"实施扩展模式",可走 /using-superpowers 串接 superpowers 5 步实施。

核心特性

• ✅ 26 个独立 skill — 2 router + 9 动作 + 1 编排 + 7 bridge + 7 discipline,职责单一,自由组合
• ✅ 3 个完整行业示例 — 医药 WMS / SaaS 订单 / 移动 App 积分,各 16 文件,看完照搬
• ✅ 26 个自动化脚本 — 7 阶段门控 + 5 静态审计 + 4 元数据校验 + 3 流程图工具 + 5 基础设施 + 2 状态管理
• ✅ 13 个 GitHub Actions workflow — smoke-test / sql-dialect / doc-validate / field-alignment / full-qa-audit + 8 个 P0/P1 增量校验
• ✅ 15 个 pytest 测试 — 每个 gate 脚本有对应测试,覆盖 CLI / 双模式 / 互斥参数 / 边界条件
• ✅ 流程图工具链 — ASCII → Mermaid/Drawio → SVG/PNG(命令行 + VSCode 集成)
• ✅ VSCode 扩展 — 4 个命令直接桥接到 skill 脚本
• ✅ 可组合 — 不强制流程,自由调任意 skill
• ✅ 可插拔配置 — config/ 目录放行业/技术栈/领域知识库,按需加载
• ✅ 框架层通用 — 流程骨架/门控/纪律与具体语言无关(见覆盖范围)
• ✅ 社区治理 — CONTRIBUTING.md + Issue/PR 模板 + Conventional Commits

目录

• 它是什么
• 核心特性
• 覆盖范围(已覆盖 vs 未覆盖)
• 安装
• 快速开始
• 26 个 skill 速查
• 3 个示例
• 📚 知识库配置(项目级)
• 🔧 工具链
• GitHub Actions CI
• 包含什么
• 脚本能力表
• 工作流总览
• 文档编号
• 依赖
• 路线图
• 贡献
• 安全
• 协议

覆盖范围(已覆盖 vs 未覆盖)

诚实声明:本仓库框架层通用(流程骨架/门控/纪律与具体语言无关), 但默认示例与 config 只覆盖 3 个领域(医药 WMS / SaaS 后台 / 移动 App)。 其他行业/技术栈需用户在项目级补 knowledge-path.md / tech-stack-path.md / compliance/。

维度	已覆盖(开箱即用)	未覆盖(需用户补 config)
流程骨架	9 阶段工作流、3 层门控、白名单签字纪律、纪律清单(7 个)	—
领域	医药物流 WMS / SaaS 后台 / 移动 App(3 个 example)	金融 / 教育 / 医疗 HIS / 制造 MES / 物流 TMS…
技术栈	Spring Boot + Vue 3 / Node + React / Flutter + Firebase	Go / Rust / .NET / K8s 原生 / 函数计算…
数据库	Oracle 11g/19c / PostgreSQL / MySQL(注:Oracle 是默认示例)	DB2 / SQL Server / TiDB / 大数据 Hive / ClickHouse…
合规体系	中国 GSP(药品经营质量管理规范)	GAMP 5 / ISO 13485 / HIPAA / GDPR / 等保 2.0…
门控脚本	12 个(setup / brd / compliance / prd / dev-design-backtest…)	—
VSCode 集成	4 个命令(mmdc / drawio / flow-export / 新建文件)	IntelliJ / Vim / Emacs 插件

如何补 config:在项目根放 3 个 *-path.md + 1 个 compliance/,详见 /setup-analysis-delivery skill。

安装

平台支持

安装方式按运行环境选择:

平台	推荐方式	说明
Linux / Ubuntu / Debian / Fedora / Arch / CentOS	Bash 一键安装或 git clone	需要 bash、git;一键安装还需要 curl
macOS	Bash 一键安装或 git clone	建议先确认 git --version 可用
Windows + WSL	在 WSL 里运行 Linux 安装命令	推荐 Windows 用户使用,路径在 WSL 用户目录下
Windows + Git Bash	在 Git Bash 里运行 Bash 安装命令	适合已安装 Git for Windows 的用户
Windows PowerShell / CMD	手动 git clone	不直接运行 install.sh;用 PowerShell 示例命令

Linux / macOS / WSL / Git Bash 一键安装(推荐)

curl -fsSL https://raw.githubusercontent.com/BlueprintOS/analysis-to-delivery/main/install.sh | bash

指定 agent:

curl -fsSL https://raw.githubusercontent.com/BlueprintOS/analysis-to-delivery/main/install.sh | bash -s -- --agent codex
curl -fsSL https://raw.githubusercontent.com/BlueprintOS/analysis-to-delivery/main/install.sh | bash -s -- --agent claude
curl -fsSL https://raw.githubusercontent.com/BlueprintOS/analysis-to-delivery/main/install.sh | bash -s -- --agent opencode

Linux / macOS / WSL / Git Bash 手动安装

# 稳定版(推荐生产用,锁定到 v4.0.0)
git clone --branch 4.0.0 --depth 1 https://github.com/BlueprintOS/analysis-to-delivery.git \
  ~/.codex/skills/analysis-to-delivery

# main 分支(尝鲜用,跟随最新提交)
git clone --depth 1 https://github.com/BlueprintOS/analysis-to-delivery.git \
  ~/.codex/skills/analysis-to-delivery

也可以把目标目录换成对应 agent 的 skills 目录,或用项目级 AGENTS.md 直接引用本仓库。

Windows PowerShell 手动安装

PowerShell 不直接运行 install.sh。请用 git clone 安装到对应 agent 的 skills 目录:

# Codex
git clone --branch 4.0.0 --depth 1 https://github.com/BlueprintOS/analysis-to-delivery.git "$env:USERPROFILE\.codex\skills\analysis-to-delivery"

# Claude Code
git clone --branch 4.0.0 --depth 1 https://github.com/BlueprintOS/analysis-to-delivery.git "$env:USERPROFILE\.claude\skills\analysis-to-delivery"

# Hermes
git clone --branch 4.0.0 --depth 1 https://github.com/BlueprintOS/analysis-to-delivery.git "$env:USERPROFILE\.hermes\skills\analysis-to-delivery"

# OpenCode
git clone --branch 4.0.0 --depth 1 https://github.com/BlueprintOS/analysis-to-delivery.git "$env:USERPROFILE\.opencode\skills\analysis-to-delivery"

如果目标目录的父目录不存在,先创建:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills"

Windows CMD 手动安装

REM Codex
git clone --branch 4.0.0 --depth 1 https://github.com/BlueprintOS/analysis-to-delivery.git "%USERPROFILE%\.codex\skills\analysis-to-delivery"

REM Claude Code
git clone --branch 4.0.0 --depth 1 https://github.com/BlueprintOS/analysis-to-delivery.git "%USERPROFILE%\.claude\skills\analysis-to-delivery"

升级

cd <SKILL_ROOT>/analysis-to-delivery && git pull origin main

PowerShell 升级:

cd "$env:USERPROFILE\.codex\skills\analysis-to-delivery"
git pull origin main

安装选项

# Dry run(只检查不安装)
bash install.sh --dry-run

# 指定 agent 默认目录
bash install.sh --agent claude
bash install.sh --agent hermes
bash install.sh --agent codex
bash install.sh --agent opencode

# 指定目标目录
bash install.sh --target /path/to/install

# 指定版本
bash install.sh --version v4.0.0

# 卸载(会清理已知 agent skills 目录中的本 skill)
bash install.sh --uninstall

卸载

Linux / macOS / WSL / Git Bash:

# 在仓库目录内执行
bash install.sh --uninstall

# 或手动删除指定 agent 目录
rm -rf ~/.codex/skills/analysis-to-delivery
rm -rf ~/.claude/skills/analysis-to-delivery
rm -rf ~/.hermes/skills/analysis-to-delivery
rm -rf ~/.opencode/skills/analysis-to-delivery

Windows PowerShell:

# Codex
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\skills\analysis-to-delivery"

# Claude Code
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\skills\analysis-to-delivery"

# Hermes
Remove-Item -Recurse -Force "$env:USERPROFILE\.hermes\skills\analysis-to-delivery"

# OpenCode
Remove-Item -Recurse -Force "$env:USERPROFILE\.opencode\skills\analysis-to-delivery"

Windows CMD:

REM Codex
rmdir /s /q "%USERPROFILE%\.codex\skills\analysis-to-delivery"

REM Claude Code
rmdir /s /q "%USERPROFILE%\.claude\skills\analysis-to-delivery"

REM Hermes
rmdir /s /q "%USERPROFILE%\.hermes\skills\analysis-to-delivery"

REM OpenCode
rmdir /s /q "%USERPROFILE%\.opencode\skills\analysis-to-delivery"

安装位置

脚本自动检测已存在的 agent 目录:

• ~/.claude/skills/(Claude Code)
• ~/.hermes/skills/(Hermes)
• ~/.codex/skills/ 或 $CODEX_HOME/skills/(Codex)
• ~/.opencode/skills/ 或 $OPENCODE_HOME/skills/(OpenCode,若本地采用该目录约定)

可用 --agent 选择默认目录,或用 --target 强制指定。更多说明见 docs/adapters/。

Agent 兼容性

核心工作流是 agent-neutral 的 Markdown + CLI 脚本;不同 agent 只在入口、命令触发和子代理能力上有差异。

Agent	推荐接入	说明
Claude Code	--agent claude 或 ~/.claude/skills	原生 skill / slash command 体验最佳
Hermes	--agent hermes 或 ~/.hermes/skills	沿用 Claude 风格 skill 目录
Codex	--agent codex 或 $CODEX_HOME/skills	通过 SKILL.md、AGENTS.md 和脚本门控接入
OpenCode	--agent opencode 或 --target	优先用项目级 AGENTS.md + CLI 脚本接入

不支持 slash command 的 agent 可直接用自然语言触发,例如:"使用 analysis-to-delivery 的 /grill-task 流程澄清这个需求"。

快速通道

跳过 router,直接按目标选:

目标	命令
配置项目	/setup-analysis-delivery
跑 5 项门控全套	bash scripts/smoke-test.sh
看项目走到哪个阶段	python3 scripts/analysis-state.py status
ASCII → Mermaid	python3 scripts/flow-to-mermaid.py file.txt
校验所有 skill 是否合规	python3 scripts/discipline-lint.py skills/
校验 Required rules / paths 声明	python3 scripts/rules-path-lint.py <repo>
校验目标边界与分期	python3 scripts/goal-boundary-check.py <project_dir>

逆向使用

不是"需求 → 设计",而是已有产物需要后向追溯:

已有产物	逆向动作
01-BRD.md 已写,字段不确定	python3 scripts/field-alignment-check.py <project>
05-PRD.md 与 BRD 冲突	回到 /grill-task 重对齐
06-开发设计.md 与代码不一致	直接 /qa-audit 找偏差
09-QA审计报告.md P0 列表	逐项修复后重跑 full-qa-audit.py
状态文件 .analysis-delivery-state.json 在	python3 scripts/analysis-state.py status 看中断阶段

度量

python3 scripts/analysis-state.py metrics [--json] 输出 5 项:

#	指标	含义
1	总 gate 调用次数	整套流程自动化门控累计调用
2	总签字次数	用户白名单话术累计签字
3	gate 拦截次数	各 gate 脚本失败次数(按脚本名)
4	各阶段重试次数	哪些阶段反复回去修
5	阶段用时(分钟)	已签字阶段耗时(开始 → 签字)

用途:找流程瓶颈 / 门控过严过松。详见 rules/stage-gate.md §度量章节。

快速开始

0. 装完先跑 smoke test(v1.2+)

bash <SKILL_ROOT>/analysis-to-delivery/scripts/smoke-test.sh

确认文件完整后再用。✅ 全部通过即可放心;⚠️ 有警告可继续;❌ 有错误需先修复。

当前标准:95+ ✅ / 0 ⚠️ / 0 ❌(v3.0 后)

方式 1:斜杠命令(支持 slash command 的 agent)

/analysis-to-delivery

方式 2:自然语言

"使用 analysis-to-delivery 分析入库收货需求"

方式 3:项目启动

"我要做一个 SaaS CRM 系统,用 Node + React + PostgreSQL,请用 analysis-to-delivery 帮我走完需求到设计"

Agent 会自动:

1. 加载项目级 *-path.md 配置(若有,详见📚 知识库配置)
2. 加载 config/compliance/none.md(无强合规)
3. 加载 config/tech-stack/node-nestjs.md(如果存在)
4. 按 9 阶段工作流推进

26 个 skill 速查

类别	数量	触发方式	说明
Router	2	用户 /<name>	入口路由
User-invoked 动作	9	用户 /<name>	单步动作
Orchestration 编排	1 + 7	用户 + AI	9 阶段流程 + 7 superpowers bridge
Discipline 纪律	7	AI 自动	模型自动调用,保证质量

Router(2 个)

/ask-delivery            → 选择 skill 走流程
/using-superpowers       → 启用实施扩展模式(7 个 superpowers bridge)

User-invoked 动作(9 个)— 单步

/setup-analysis-delivery → 生成项目级配置(knowledge/compliance/tech-stack/doc-naming)
/setup-analysis-delivery → 阶段 1:生成项目级配置
/grill-task              → 阶段 2:AI 反复追问澄清需求
/to-brd                  → 阶段 3:生成业务需求文档(BRD)
/compliance-review       → 阶段 4:合规评审(GSP / 等保 / GDPR / PIPL)
/test-case-design        → 阶段 5:生成测试用例
/to-prd                  → 阶段 6:生成产品需求文档(PRD)
/dev-design              → 阶段 7:开发设计(FSD + 数据模型 + 开发设计说明书)
/qa-audit                → 阶段 8:QA 审计(6 大类)
/handoff                 → 阶段 9:交付清单

Orchestration(1 个)— 走完整流程

/analysis-delivery-workflow  → 9 阶段分析设计 + 衔接 superpowers 实施

需求澄清门控(v3.x 新增)

grill-task 阶段新增 scripts/task-confirm-check.py 硬门控脚本：

• 5 项检查：状态字段、12 词 TBD 扫描、5 章节完整、REVIEW 第八节为空、字段对齐 🔴/❓=0
• 12 词 TBD 红线：TBD / TODO / 待定 / 稍后 / 下次 / N/A / 待确认 / 暂定 / 未定 / 待补充 / ⬜ / ❓
• 白名单话术：用户必须用以下 4 句之一才能进入下一阶段：
  • 我已全部确认，可以进入下一步
  • 确认通过，进入 BRD
  • 全部完成，继续
  • approved, proceed to next stage
• TASK_CONFIRM 模板状态字段：硬约束为二态（⬜ / ✅），删除 🟡 中间态
• 双模式：
  • --strict（默认）：5 项检查全部 BLOCK,任一失败 exit 1