Coding
PromptBeginner5 minmarkdown
Nano Banana Pro
Agent skill for nano-banana-pro
7
Use when 需要生成 RFC 技术规范、进行需求分析、设计 API 契约,或需要 OHSpec 多代理编排输出。Triggers on "RFC", "需求分析", "API 契约", "设计规范", "OHSpec", "/ohspec".
Sign in to like and favorite skills
AI辅助需求分析与设计规范生成,强调多代理编排、结构化产物和质量门禁。
架构概览与职责划分。
+-------------------------------------------------------------------+ | Orchestrator (你) | | - 协调流程 / 复杂度路由 / 质量门禁 / 维护三文件 | +-------------------------------+-----------------------------------+ | Subagents | Artifacts | | Dispatcher / 需求分析师 / | rfc.md / findings.json / | | 架构设计师 / 质量审查员 | progress.json | +-------------------------------+-----------------------------------+ | Optional export: /ohspec:export -> rfc.digest.json + tasks.json | +-------------------------------------------------------------------+
角色职责:
关键产物:
rfc.md、findings.json、progress.json(三文件是 scan-of-record 与质量审计入口)。
用户需求 -> 初始化三文件(rfc.md/findings.json/progress.json) -> PRECHECK:快速需求预检(30秒过滤不可行需求) -> ASSESS:确定工具与 scan scope,写入 progress.json + audit_log -> 快速意图澄清(≤2问题,确保扫描准确性) -> Dispatcher 基线扫描(scan-of-record) -> 深度技术澄清(基于扫描结果) -> 复杂度路由 + 路由信号 -> analyze -> design -> precheck -> audit -> RFC 输出 -> 可选 /ohspec:export 生成机读件
复杂度路由:
| 级别 | 特征 | 模式 |
|---|---|---|
| SIMPLE | 单文件,<50行 | 快速通道 |
| MEDIUM | 多文件,单子系统 | 标准流程 |
| COMPLEX | 跨子系统,架构级 | 完整流程 + spike |
路由信号:
| 信号 | 动作 |
|---|---|
| 需求明确、单文件 → 跳过 analyze |
| 跨子系统依赖 → 加载 Diplomat |
| 技术不确定 → 触发 Spike |
| 详细需求 → 简化澄清 |
⛔ 禁止跳过:在执行任何操作之前,必须完整阅读以下文档。P1 表示触发该模式前必须读。
| Document | Purpose | Priority |
|---|---|---|
| workflows/main.md | 主工作流程 | P0 - 最高 |
| workflows/requirement-precheck.md | 快速需求预检 | P0 - 最高 |
| workflows/assess.md | ASSESS 阶段(代码库评估) | P0 - 最高 |
| workflows/precheck.md | RFC 预检规则 | P0 - 最高 |
| workflows/export.md | 手动导出机读件 | P0 - 最高 |
| workflows/spike.md | Spike 验证流程 | P1(触发 TRIGGER_SPIKE 时) |
| workflows/resume.md | Resume 模式 | P1(中断恢复时) |
| Document | Purpose | Priority |
|---|---|---|
| docs/phases.md | 阶段详细定义 | P0 - 最高 |
| docs/quality-gates.md | 质量门禁标准 | P0 - 最高 |
| docs/rfc-format.md | RFC 格式规范 | P0 - 最高 |
| docs/routing-signals.md | 路由信号机制 | P0 - 最高 |
| docs/subagent-contract.md | 子代理契约与摘要规范 | P1(启用子代理时) |
| docs/error-handling.md | 错误处理策略 | P1(发生异常时) |
| Document | Purpose | Priority |
|---|---|---|
| templates/rfc.md | RFC 模板 | P0 - 最高 |
| templates/findings.json | 扫描发现模板 | P0 - 最高 |
| templates/progress.json | 进度与门禁模板 | P0 - 最高 |
| templates/rfc-minimal.md | 快速通道 RFC | P1(快速通道) |
| templates/project-context.md | 项目上下文输入 | P1(需要补齐上下文时) |
| templates/context-pack.json | 上下文打包格式 | P1(需要打包上下文时) |
| templates/project-knowledge.json | 知识结构模板 | P1(需要结构化知识时) |
| templates/checkpoint.json | 断点续写状态 | P1(中断恢复时) |
| Document | Purpose | Priority |
|---|---|---|
(优先;未初始化则用 或先 bootstrap) | RFC 结构预检 | P0 - 最高 |
| scripts/export_digest.py | 导出机读件 | P0 - 最高 |
| scripts/bootstrap_project.py | 初始化项目上下文 | P1(首次落盘项目时) |
强制:所有交付物必须使用简体中文(RFC、findings.json、progress.json、审查报告)。
例外:代码标识符遵循项目约定。
/ohspec "为音频服务增加 3D 音效开关"
rfc.md、findings.json、progress.json 必须先落盘再扫描/ohspec:export 手动生成 rfc.digest.json(可选 tasks.json)request_user_input;Claude Code CLI 用 AskUserQuestion;若工具不可用/被禁用,输出“选项式问题 + 影响 + 建议”的文本并暂停,不得进入 plan/design/audit当无法使用 Task 子代理时(例如 Codex 环境),允许编排器执行最小化 scan-of-record:
rg(其次 ag/grep)做关键词预过滤,快速定位候选关键文件rg --glob '!**/.ohspec/**' --glob '!**/.claude/ohspec/**' --glob '!**/node_modules/**' --glob '!**/dist/**' --glob '!**/build/**' ...)progress.json.tooling + phases.assess + audit_logfindings.confirmed.key_files(≥3 且覆盖入口/配置/依赖或测试/可观测)findings.confirmed.facts(SIMPLE ≥ 1;MEDIUM/COMPLEX ≥ 3,项目事实:配置/存储/权限/错误码/线程模型/可观测等,每条附证据锚点)progress.json.tooling 与 audit_log| 阶段 | 目标 | 专家 | 输出 |
|---|---|---|---|
| assess | 评估代码库规模,决策扫描策略 | 编排器 | 扫描策略 |
| analyze | 理解需求,澄清歧义 | 需求分析师 | RFC §1-§2 |
| design | 设计方案,定义接口 | 架构设计师 | RFC §3-§5 |
| precheck | 自动验证结构和覆盖 | 编排器 | 预检报告 |
| audit | 质量审查,评分决策 | 质量审查员 | 审查报告 |
| 阶段 | 目标 | 触发条件 | 输出 |
|---|---|---|---|
| requirement_precheck | 快速需求预检,过滤不可行/信息不足需求 | 所有任务 | 可行性判断 |
| assess | 评估代码库规模,决策扫描策略 | requirement_precheck 通过 | 扫描策略 |
| intent_clarify | 快速意图澄清,确保扫描准确 | assess 完成 | 意图理解 |
| dispatcher | 基线扫描(scan-of-record) | intent_clarify 完成 | key_files + facts |
| analyze | 深度技术澄清,输出 RFC §1-§2 | dispatcher 完成 | RFC §1-§2 |
核心专家:Dispatcher、需求分析师、架构设计师、质量审查员
扩展专家:Diplomat(跨子系统)、API设计师、Prototyper(spike验证)
必须满足:
ID格式:
RFC-{YYYYMMDD}-{slug}-{hash4}
目录(推荐):
.ohspec/rfcs/{RFC-ID}/.claude/ohspec/rfcs/{RFC-ID}/
工作流:
文档:
模板:
脚本:
.ohspec/scripts/precheck_rfc.py(优先;未初始化则用 scripts/precheck_rfc.py 或先 bootstrap)