Skill v1.0.0
currentAutomated scan100/100version: "1.0.0" description: Use when user says "业务机会/OPP", "专题/Epic", "分解需求/decompose", "精炼/refine", "战略对齐/align", "业务全景/view", "需求发现/brainstorm/discover", "导入/import", "技术债务/infer", "pace-biz", or wants to plan requirements. NOT for /pace-dev, -change, -plan, -init. allowed-tools: AskUserQuestion, Read, Write, Edit, Glob, Grep, Bash argument-hint: "[opportunity|epic|decompose|refine|align|view|discover|import|infer] [EPIC-xxx|BR-xxx|PF-xxx] <描述|路径>" model: opus context: fork agent: pace-pm hooks: PreToolUse:
- matcher:
tool_name: "Write|Edit" hooks:
- type: command
command: "${CLAUDE_PLUGIN_ROOT}/hooks/skill/pace-biz-scope-check.mjs" timeout: 5
- matcher:
tool_name: "Write" path_pattern: "**/.devpace/epics/EPIC-*.md" hooks:
- type: prompt
prompt: "检查即将写入的 Epic 文件:1) OBJ 关联是否存在于 project.md?2) MoS 是否使用了可度量的表述(含目标数值或可验证条件)?如两项均合格回复 PASS。如有问题输出改进建议并阻断。" timeout: 15
/pace-biz — 业务规划域统一入口
管理从业务机会到专题(Epic)到业务需求(BR)的上游价值链。覆盖 Opportunity 捕获、Epic 创建与管理、需求分解、战略对齐检查和业务全景展示。
与现有机制的关系
/pace-biz:业务规划域(Opportunity→Epic→BR 的创建和分解)/pace-change:需求变更域(已有 BR/PF/Epic 的变更——add/pause/resume/modify)/pace-plan:迭代规划域(PF/CR 的排期)/pace-init:项目初始化(首次 Vision/Strategy/OBJ 引导)/pace-init full:项目不存在时,从 0 到 1 建立 .devpace/ + OBJ + 功能树 + 迭代计划(一站式初始化)/pace-biz discover:项目已存在时,从模糊想法探索新的 OPP→Epic→BR→PF(增量扩展)/pace-status:开发状态(CR/PF 开发进度视图)
推荐使用流程
完整业务路径: opportunity → epic → decompose → /pace-dev探索式发现: discover → decompose → /pace-plan next多源导入: import <文档> → align → /pace-plan next代码库推断: infer → align → /pace-dev战略对齐检查: align(只读分析)业务全景: view(只读展示)直接创建 Epic: epic(跳过 Opportunity)日常需求注入: /pace-change add(跳过 Opportunity/Epic,走快速路径)
输入
$ARGUMENTS:
子命令
创建型(产出新实体):
opportunity <描述>→ 捕获业务机会到 opportunities.mdepic [OPP-xxx] <描述>→ 从 Opportunity 转化或直接创建 Epicdecompose <EPIC-xxx|BR-xxx>→ 分解 Epic→BR 或 BR→PF
精炼型(深化已有实体):
refine <BR-xxx|PF-xxx>→ 交互式补充验收标准、边界条件、用户故事
发现型(探索和导入需求):
discover <描述>→ 交互式需求发现,从模糊想法产出 OPP→Epic→BR→PF 候选树import <路径>... [--threshold N]→ 从文档批量提取需求实体,合并到功能树(阈值默认 0.8)infer→ 从代码库推断未追踪功能和技术债务
分析型(查看和检查):
align→ 检查 OBJ→Epic→BR 战略对齐度,发现孤立实体view→ 业务全景视图(OPP→EPIC→BR 流)
空参数
- (空)→ 智能引导——扫描项目上下文,按下方"空参数引导"章节给出个性化推荐
执行路由表
| 子命令 | 读取 | 写入 | procedures 文件 | |
|---|---|---|---|---|
| opportunity | project.md, opportunities.md | opportunities.md | skills/pace-biz/biz-procedures-opportunity.md | |
| epic | opportunities.md, project.md | epics/EPIC-xxx.md, project.md, opportunities.md | skills/pace-biz/biz-procedures-epic.md | |
| decompose EPIC-xxx | epics/EPIC-xxx.md, project.md | project.md, epics/ | skills/pace-biz/biz-procedures-decompose-epic.md | |
| decompose BR-xxx | requirements/BR-xxx.md, project.md | project.md, requirements/ | skills/pace-biz/biz-procedures-decompose-br.md | |
| refine | project.md, requirements/BR-xxx.md | project.md, requirements/ | skills/pace-biz/biz-procedures-refine.md | |
| align | project.md, epics/, requirements/, opportunities.md, metrics/insights.md | metrics/insights.md(趋势数据) | skills/pace-biz/biz-procedures-align.md | |
| view | project.md, epics/, requirements/, opportunities.md | (只读) | skills/pace-biz/biz-procedures-view.md | |
| discover | state.md, project.md, opportunities.md | opportunities.md, epics/, project.md, scope-discovery.md | skills/pace-biz/biz-procedures-discover.md | |
| import | project.md, insights.md | project.md, epics/, requirements/ | skills/pace-biz/biz-procedures-import.md | |
| infer | project.md, src/ | project.md | skills/pace-biz/biz-procedures-infer.md | |
| (空参) | state.md, project.md, opportunities.md | (只读) | (内联于下方"空参数引导"章节) |
流程
所有子命令的公共前置
- 读取 state.md 和 project.md 确认项目上下文
- 确认 .devpace/ 已初始化(未初始化时引导 /pace-init)
- 读取 project.md 配置 section 的
preferred-role字段(缺省 = Dev)。角色影响:输出措辞、追问方向、展示维度排序。参见各 procedures 文件中的"角色适配"段落 - 按子命令路由到对应 procedures 文件(各 procedure 内部根据 role 调整行为)
空参数引导
当用户无参数调用 /pace-biz 时,执行以下智能引导:
以下检测逻辑与knowledge/_signals/signal-priority.mdS16-S19 部分重叠。此处为用户直接引导版本(面向空参数场景),信号版本面向 pace-next/pace-pulse 的自动推荐。两处条件修改时需同步审查。
- 读取 project.md 的
mode字段判断模式 - 扫描 opportunities.md 中
评估中的 Opportunity 数量 - 扫描 epics/ 中
进行中和规划中的 Epic 数量 - 扫描 project.md 树视图中未关联 Epic 的"孤立" BR 数量
- 阶段判断(内部逻辑,用于选择推荐策略,不直接输出阶段名称给用户):
- 无 OPP 且无 Epic/BR → Sense 阶段→ 侧重发现型推荐
- 有 OPP 未转化 或 有活跃 discover 会话 → Ideate 阶段→ 侧重转化和探索
- 有 Epic 未分解 或 有 BR 未分解出 PF → Structure 阶段→ 侧重 decompose
- 有 BR/PF 平均就绪度 < 60% → Refine 阶段→ 侧重 refine
- 距上次 align > 5 天 或 从未执行 → Validate 阶段→ 侧重 align
- 大部分 BR/PF 就绪度 >= 80% → Ready 阶段→ 推荐移交 /pace-dev
- 多阶段条件同时满足时,按上述顺序取最早未完成的阶段
- 推荐优先级(生命周期感知):
- 未评估 Opportunity →
opportunity或epic - 规划中 Epic 需分解 →
decompose - BR/PF 平均就绪度 < 60% →
refineTop-3 最需精炼项 - 距上次 align 超过 5 天或从未执行 →
align - 以上均不满足 → 上下文发现型推荐(import/infer/discover)
- 附完整子命令列表
发现型推荐(上下文感知):
- 检测到
.md/.txt文档 → 推荐import <文件> - 检测到
src//lib/等代码目录 → 推荐infer - 有活跃 Epic 但 BR 为空 → 推荐
decompose <EPIC-xxx> - 其他 → 推荐
discover
输出
- 渐进暴露:默认输出简洁摘要,
--detail展示完整信息 - 操作确认:写入操作前展示变更预览,用户确认后执行
- 追溯链:每次创建实体时展示其在价值链中的位置
各子命令输出格式索引
权威模板在各 procedures 文件中。
| 子命令 | 输出摘要 | 权威源 | |
|---|---|---|---|
| opportunity | 已捕获业务机会:OPP-xxx -- [描述],状态:评估中 | skills/pace-biz/biz-procedures-opportunity.md Step 4 | |
| epic | 已创建专题:EPIC-xxx -- [名称],关联 OBJ + MoS | skills/pace-biz/biz-procedures-epic.md Step 8 | |
| decompose (Epic) | 已分解 EPIC-xxx:BR 列表 + 依赖关系 + 价值链 | skills/pace-biz/biz-procedures-decompose-epic.md Step 6 | |
| decompose (BR) | 已分解 BR-xxx:PF 列表 + 优先级 + 价值链 | skills/pace-biz/biz-procedures-decompose-br.md Step 6 | |
| refine | 已精炼 [BR/PF]:变更摘要 + 就绪度变化 | skills/pace-biz/biz-procedures-refine.md Step 4 | |
| align | 战略对齐度报告:覆盖率 + 孤立实体 + 就绪度 + 趋势 | skills/pace-biz/biz-procedures-align.md Step 3 | |
| view | 业务全景:OPP->EPIC->BR->PF->CR 树视图 + 统计 | skills/pace-biz/biz-procedures-view.md Step 2 | |
| discover | 已从发现会话创建:OPP + Epic + BR + PF 汇总 | skills/pace-biz/biz-procedures-discover.md Step 6 | |
| import | 导入完成:新增 + 丰富 + 跳过 汇总 | skills/pace-biz/biz-procedures-import.md Step 6 | |
| infer | 代码库推断完成:追踪 + 技术债务 + 未实现 汇总 | skills/pace-biz/biz-procedures-infer.md Step 6 |