A general workflow for taking requirements analysis through to development, with an entry-point skill that routes to the right stage, plus deprecated compatibility shims for shared rules. Mainly in Chinese, with the stage and rule skills linked to each step.
Claude Code
$ npx -y skills add BlueprintOS/analysis-to-delivery --agent claude-code
Codex
$ npx skills add BlueprintOS/analysis-to-delivery -a codex
Cursor
$ npx skills add BlueprintOS/analysis-to-delivery -a cursor
Gemini CLI
$ npx skills add BlueprintOS/analysis-to-delivery -a gemini-cli
GitHub Copilot
$ npx skills add BlueprintOS/analysis-to-delivery -a github-copilot
OpenCode
$ npx skills add BlueprintOS/analysis-to-delivery -a opencode
Windsurf
$ npx skills add BlueprintOS/analysis-to-delivery -a windsurf
通用需求分析到开发实施工作流 — 26 个独立可组合 skill、3 个完整行业示例、13 个 CI workflow、26 个自动化脚本、15 个 pytest 测试。
一个面向 Claude Code / Hermes / Codex / OpenCode 等 agentic coding assistants 的 agent-neutral skill/workflow 集合,提供从「需求澄清」到「开发实施」的标准化工作流。
设计原则:小而精、可组合、不拥有流程。每个 skill < 300 行,改一个不影响其他。
任何团队拿到这个 skill 之后:
/ask-delivery 选择对应 skill,或直接 /analysis-delivery-workflow 走完整流程(不支持 slash command 的 agent 可用自然语言触发)默认不包含:实际业务代码。若用户明确启用"实施扩展模式",可走 /using-superpowers 串接 superpowers 5 步实施。
config/ 目录放行业/技术栈/领域知识库,按需加载诚实声明:本仓库框架层通用(流程骨架/门控/纪律与具体语言无关), 但默认示例与 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 示例命令 |
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
# 稳定版(推荐生产用,锁定到 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 直接引用本仓库。
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"
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-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 §度量章节。
bash <SKILL_ROOT>/analysis-to-delivery/scripts/smoke-test.sh
确认文件完整后再用。✅ 全部通过即可放心;⚠️ 有警告可继续;❌ 有错误需先修复。
当前标准:95+ ✅ / 0 ⚠️ / 0 ❌(v3.0 后)
/analysis-to-delivery
"使用 analysis-to-delivery 分析入库收货需求"
"我要做一个 SaaS CRM 系统,用 Node + React + PostgreSQL,请用 analysis-to-delivery 帮我走完需求到设计"
Agent 会自动:
*-path.md 配置(若有,详见📚 知识库配置)config/compliance/none.md(无强合规)config/tech-stack/node-nestjs.md(如果存在)| 类别 | 数量 | 触发方式 | 说明 |
|---|---|---|---|
| Router | 2 | 用户 /<name> | 入口路由 |
| User-invoked 动作 | 9 | 用户 /<name> | 单步动作 |
| Orchestration 编排 | 1 + 7 | 用户 + AI | 9 阶段流程 + 7 superpowers bridge |
| Discipline 纪律 | 7 | AI 自动 | 模型自动调用,保证质量 |
/ask-delivery → 选择 skill 走流程
/using-superpowers → 启用实施扩展模式(7 个 superpowers bridge)
/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:交付清单
/analysis-delivery-workflow → 9 阶段分析设计 + 衔接 superpowers 实施
grill-task 阶段新增 scripts/task-confirm-check.py 硬门控脚本：
TBD / TODO / 待定 / 稍后 / 下次 / N/A / 待确认 / 暂定 / 未定 / 待补充 / ⬜ / ❓我已全部确认，可以进入下一步确认通过，进入 BRD全部完成，继续approved, proceed to next stage--strict（默认）：5 项检查全部 BLOCK,任一失败 exit 1Stars on GitHub
Helps you take a change from a rough idea or bug report through to a tested, reviewed result, with each step handled by a focused skill. Its skills cover pinning down domain terms, designing module interfaces, diagnosing hard bugs, and reviewing changes against your repo's coding standards.
@mattpocockA development methodology for coding agents that makes the agent brainstorm before building, follow plans, run parallel work and finish branches in a disciplined way. You get fewer skipped steps and more consistent results from your coding assistant.
@obraGives your coding agent a planning, testing and review routine to follow on every task. It plans before building, checks changes with tests, has a fresh reviewer look for regressions, and saves repeated wins as reusable skills.
@affaan-mDeveloper tools for working on the React codebase itself. Provides skills for extracting error messages, managing and debugging feature flags across release channels, running Flow type checks, and fixing lint and formatting issues before committing.
@facebookA general workflow for taking requirements analysis through to development, with an entry-point skill that routes to the right stage, plus deprecated compatibility shims for shared rules. Mainly in Chinese, with the stage and rule skills linked to each step. Install it with the command on its page. It includes ask-delivery, ascii-flowchart, context-pointer. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it