SuperAPI AI 工具集

workflow-planned-work

智能体与模型

查看项目

更新于 11-06 09:09

技能介绍

workflow-planned-work 是一个面向规划阶段的多模式工作流技能,目标是在任何实现开始之前,把产品意图整理成经过评审的规划产物。它不编写生产代码;需要写代码时应改用 workflow-feature(规范中尚无该行为)或 workflow-implement-spec(规范中已有该行为),若先要看可点击的 UI 方向则应使用 workflow-spec-to-mockup。

用途与三种模式 模式通过 --from 与 --to 参数选择(也可用 --mode 直接指定),仅给单个参数时按规则推断:--to=spec 对应 idea-to-spec;--from=spec 对应 spec-to-tasks;--from=idea 或 --to=tasks 对应 idea-to-tasks。--from=spec --to=spec 不是合法模式,修改规范应使用 workflow-feature-spec。

  1. idea-to-tasks(默认模式):输入为想法、工单、简报或原始产品愿景,可走单任务轨道(经临时规范产出一个任务),或多机会轨道(经 RICE 机会图处理多个机会)。交付物包括临时规范与测试规范、经评审并通过就绪检查的任务与故事、优先级排序,以及 UI 任务的界面原型。结束门槛为 review-converged、spec-synced(当草稿规范或测试规范发生变更时)和 run-closed。

  2. idea-to-spec:将原始想法、愿景或问题,为每个收敛的能力产出一份经评审的临时正式规范,产物包括配套的计划测试用例,不产生任务、故事或原型。结束门槛为 review-converged 和 run-closed。

  3. spec-to-tasks:适用于正式规范已存在的情况,产出覆盖矩阵、任务、故事、DoR 证据和排定优先级的计划工作,并包含能力切片与实现排序。结束门槛为 review-converged、spec-synced(当本次运行改动正式规范内容时)和 run-closed。

步骤链示例(idea-to-tasks):$web-research --chain=deep-dive → $brainstorm → $initiative → $spec [mode=discovery] → $work-item --mode=review → $domain-analysis → $why-review → $spec [mode=draft] → $spec [mode=tests] → $work-item --mode=review --type=spec-tests → $spec [mode=clarify] → $scenario → $plan → $work-item --mode=refine → $work-item --mode=review --type=task --fix-loop → $work-item --mode=challenge --reuse=task-review → $work-item --mode=story → $work-item --mode=dor --reuse=task-review → $prioritize → $design-spec → $work-item --mode=review --type=design → $work-item --mode=mockup --explore → $docs-manager --mode=update → $feature-presentation → $workflow-end → $watzup。注册表中各步骤角色与条件由注册表定义,其中部分为核心步骤,部分为可选/条件步骤,gate 步骤始终执行。

使用方式要点

  • 先通过 $start-workflow workflow-planned-work 解析所选模式、前置动作和解析指纹,并记录模式假设。
  • 待办先行:在分诊、分析或步骤执行之前,按阶段为所选模式创建待办,保留出现编号、角色与屏障分组,使用原生待办工具或等效的持久台账;第一步标记为进行中,每步以运行或跳过的证据收尾,阶段待办仅在全部条目关闭且退出条件满足时才完成。
  • 每一步通过宿主环境的技能调用启动其链接的 SKILL.md;若宿主拒绝该调用或没有技能调用机制,则自行完整阅读该文件并按其相同参数执行;命名技能本身不算执行。上下文压缩后需重新阅读进行中步骤的 SKILL.md。
  • 步骤遵循 start-workflow 的 Step Execution Protocol:gate 步骤固定,其他步骤可有记录理由的灵活调整;不得批量完成校验门槛。
  • 严格按协议顺序执行,除非用户批准偏离;每步或子技能调用前更新待办状态,已完成或跳过步骤须附简要证据或明确跳过理由。
  • 指定模式下应先完整阅读对应模式参考文件(mode-idea-to-tasks.md、mode-idea-to-spec.md 或 mode-spec-to-tasks.md),再阅读 planned-work-core.md,其分诊、质量门槛、推荐技能表、产物与修复路径为该模式的约定。
  • 协议指南按读取条件适用,如 design-distinctiveness-gate(面向视觉界面的设计身份门槛 DD-1 至 DD-8)、incremental-persistence、session-goal-ledger、subagent-return-contract 等。
  • 工作跟踪:按项目根指令(CLAUDE.md 或 AGENTS.md)在同一变更中维护被跟踪的工作;使用便携跟踪器时,在采集、开始、保存工作、验证、交接与收尾检查点读取集成指南。

适用场景 适合产品负责人、业务分析人员或用户在实现前需要计划工作或经评审规范时使用;需要把想法、工单或愿景整理为任务与故事;需要为已有正式规范生成覆盖矩阵和依赖有序的工作;需要优先级排序、就绪检查或 UI 任务原型时。

限制与说明 资料未提供收费标准、平台限制、安装命令或具体实现细节;三种模式均不写生产代码;若宿主缺少必需的技能调用能力,需按文件阅读方式执行;实际不可用的必需能力应停止并附步骤证据与用户提问后再适配。对于旧名称 workflow-initiative-to-task、workflow-initiative-to-spec、workflow-spec-to-task 及更早名称,资料说明其已不再解析。