SuperAPI AI 工具集

workflow-feature

编程与开发

查看项目

更新于 11-06 09:10

技能介绍

workflow-feature 是 easy-claude(duc01226/easy-claude)中的工作流技能,目标是在请求的行为尚未被权威规范(canonical spec)覆盖时,以规范先行(spec-first)、测试先行(test-first)的方式交付一个定义明确的功能。其最终交付标准是:经过评审的权威规范与实现一致、测试验证通过、变更评审收敛。

用途与适用判断 该工作流用于“规范尚不完整、需要先更新规范”的功能开发。根据资料,若行为的规范已完整,应使用 workflow-implement-spec;若任务规模大、歧义多或研究密集,应使用 workflow-big-feature;若只是单模块聚焦改动且不涉及契约变更,通常走 custom-simple 路线,而非本工作流。

启动与待办初始化 先读取注册表 workflows.workflow-feature,调用 $start-workflow workflow-feature 解析所选模式、前置动作与指纹。随后必须“待办先行”:在分诊、分析或执行步骤之前,为所选模式的每个阶段按顺序创建一条待办,把该阶段的每次出现列成一行(含条件性/可选步骤),保留出现 ID、角色与屏障组;用原生待办工具或等效的持久台账记录,并将第一条标为进行中。每个步骤行以其运行或跳过的证据关闭,只有所有行关闭且适用的退出条件满足,阶段待办才可完成。

规模、类型与风险分诊(首个实质动作) 在选步骤前先分类并记入运行报告:

  • 规模(指导性):XS 1–3 个文件 / ≤100 行改动;S ≤15 文件;M ≤60;L ≤300;XL >300。
  • 类型(可多选):仅文档、工具/配置、仅测试、行为变更、公共契约/API、数据/模式/迁移、安全敏感(认证、密钥、资金、PII)、UI 界面、基础设施/CI、跨模块/跨服务。
  • 风险:不可逆、数据、安全、跨模块。
  • 大型想法判定 isLargeIdea:多个独立成果、歧义或研究密集、发布范围拆分、必须拆分的超大规模任务。 深度应随风险与歧义提升:XS/S 单模块意图清晰时轻量调查、只更新受影响的规范章节、轻量计划、构建前一次测试规范质量评审,可内联完成;M 或涉及公共契约、数据/模式、安全、跨模块时,每个核心步骤全深度执行,并执行条件成立的可选步骤;L/XL 或 isLargeIdea 为真时,在 M 的基础上按模块或切片分批构建、测试规范与评审。无法切片的密集型研究范围应建议改用 workflow-big-feature。

步骤路线与阶段 默认模式(注册表顺序)为:调查(核心)→ 规范发现(可选、有条件)→ 领域分析(可选)→ 设计取舍评审(可选)→ 规范撰写(核心)→ 场景(可选)→ 探索性原型(可选)→ 测试规范(核心)→ 测试规范评审(核心)→ 规范澄清(可选)→ 计划(核心)→ 计划执行(核心)→ 测试数据种子(可选)→ 集成测试(可选)→ 规范同步(核心)→ 变更评审(门禁)→ 集成验证(门禁)→ E2E(可选)→ 剩余测试层级(门禁)→ 演示指南(可选)→ 收尾(门禁)→ 汇总报告(可选)。阶段待办划分为:发现(4)→ 规范(6)→ 计划(1)→ 构建(4,退出条件 spec-synced)→ 评审(1,退出条件 review-converged)→ 验证(4,退出条件 tests-pass)→ 收尾(2,退出条件 run-closed)。可选步骤按其条件评估,并以逐字记录的理由跳过。

必须满足的质量门禁 运行未完成,除非每个适用门禁都有证据成立:

  • 测试通过(tests-pass):本轮内于静态评审之后运行 $integration-test --mode=verify(含变异检查)通过,且 $test --proven=@verify 覆盖验证报告未涉及的层级;每个变更行为映射到 §8 测试用例,并标明其业务意图/不变量守护;生命周期行为需断言持久状态转换与非法转换拒绝。
  • 评审收敛(review-converged):嵌套的 $workflow-review-changes 在主会话内联运行并收敛,阻塞性发现已修复且修复后状态已复评。
  • 规范同步(spec-synced,行为或公共契约变更时):实现后对规范 §1-7 再次核验,每条差异按漂移裁决规则处理(代码错误、规范过期、歧义升级)。
  • 运行关闭(run-closed):$workflow-end 检查所有门禁并输出目标满足矩阵。
  • 规范先行、测试先行:权威规范须在首个 $plan 之前撰写或更新;测试规范须在 $plan --mode=execute 之前编写并评审。
  • 目标契约(Goal Contract):启动时解析当前目标契约,计划的成功标准在 $plan --mode=execute 之前映射到它;每个子步骤读取同一目标文件;关闭需要每项标准 PASS,或被阻塞并有面向用户的升级。
  • 计划门禁:$plan 在流程内运行自身验证链并应用答复;计划门禁处于阻塞或缺人工批准时,$plan --mode=execute 不得开始。
  • 大型想法分块、既有行为保持、性能路线(性能类需求)、UI 意图刷新等条件性要求。

协调自由度、记忆与报告 工作流固定门禁,其他步骤可按记录的理由与证据灵活调整;协议顺序除非用户批准偏离否则保持不变。进度与证据须持续更新。子代理授权:当技能由用户调用或被 AI 识别且协议需要子代理时,该激活即授权使用所需的 spawn_agent。上下文压缩后,应重新完整阅读进行中步骤的 SKILL.md。

限制与未提供信息 资料未说明该技能的独立定价、商业授权、支持平台范围(除 Codex/Claude 相关说明外)以及独立安装命令;安装命令在资料中未以完整形式给出(仅出现 $skill-name 调用方式与 node .claude/scripts/lib/workflow-skill-contract.cjs --write 等仓库内脚本),具体获取与使用方式需参考 skills.sh 页面。