Skip to content

核心工作流

工作流适用场景

灵犀工作流适用于任务量超过 3 人/天、且中等及以上复杂度的任务。这类任务需要预先做充分的架构设计与方案调研;task + vet 能帮助架构师(或负责方案的角色)做好架构与整体方案设计。若任务较简单,可直接使用 IDE 的 Agent 模式,无需启动灵犀工作流。

工作流顶层设计

设计目标

在保持多入口与流程解耦的前提下,将需求从「可判定目标」推进到「可执行实现」再到「可验证交付」:

  • task 锁定目标、范围、验收标准与架构级决策
  • vet 审查 task 文档质量,帮助完成高质量的需求与验收设计(可选,可多次执行)
  • plan 细化实施路径并拆解任务,降低 build 失败率
  • build 执行实现与测试闭环,并承接有/无 plan 两种输入(简单任务可直达实现)
  • review 做按需求编号(F)的独立验收审计,形成证据闭环

生命周期(按需推进,不强制串行)

推荐推进顺序:

  1. /task <描述>:创建 001.task.<标题>.md
  2. /vet(可选):审查 task 质量
  3. /plan(可选):生成 001.plan.<标题>.md001.testcase.<标题>.md
  4. /build(可选):实现与测试
  5. /review:交付审查与验收结论

工作流特性:

  • 所有环节可跳过,按需执行
  • 入口解耦,通过 /task/plan 等显式触发对应 Skill(仅支持手动或显式调用)

多任务特性(Multi-task)

工作流天然支持多任务并行推进,taskId 是唯一任务上下文锚点:

  • 文档按 taskId 命名与隔离:001.task.*001.plan.*001.testcase.*001.review.*
  • 可通过显式指定 taskId 在任意任务间切换,不要求单任务串行完成
  • 未指定 taskId 时可回退到最新任务编号用于便捷操作
  • 多任务场景建议显式携带 taskId,避免上下文歧义与串线

命令职责与用法

工作流由 Skills 驱动;/task/plan 等为显式触发方式(仅支持手动或显式调用,不根据语义自动加载)。以下按步骤说明各 Skill 的职责与用法。

/task — 锁定目标与边界

/task <需求描述>

职责:

  • 产出任务目标、边界、验收标准、架构级方案、验证方式与证据形式
  • 不承载实施级细节,实施细化下沉到 /plan

灵犀会做什么:

  • 自动生成任务编号(001, 002...)和标题
  • 完成需求提纯并明确验收标准
  • 创建结构化任务文档:.cursor/.lingxi/tasks/001.task.<标题>.md

产出:

  • 001.task.<标题>.md

/vet — 审查 task 质量(可选)

/vet [taskId]

职责:

  • 对 task 文档做质量审查,提升可行性与可判定性

灵犀会做什么:

  • 从完整性、一致性、边界条件等维度给出审查结论与建议
  • 支持多次执行,用于迭代优化

产出:

  • 无文件产出(结果在对话中返回)

/plan — 细化实施方案(可选)

/plan [taskId]

产出:

  • 001.plan.<标题>.md
  • 001.testcase.<标题>.md

职责:

  • 对 task 做实施级方案细化(改动点、依赖、顺序、风险)
  • 按需进行需求澄清,并完成任务拆解

灵犀会做什么:

  • 将 task 拆解为可执行任务与验证路径
  • 组织实施顺序、依赖关系与主要风险
  • 在可单测单元中,可采用 Txa(测试) -> Txb(实现) 的先测后实现方式

/build — 执行实现(可选)

/build [taskId]

职责:

  • 承接有/无 plan 两种输入,推进实现与测试闭环
  • unit/integration 执行先测后实现闭环

灵犀会做什么:

  • 根据输入路径选择执行模式并推进实现

产出:

  • 代码实现与对应测试变更

/review — 独立验收审计

/review [taskId]

职责:

  • 按需求项(Feature,记作 F)执行独立验收审计
  • 给出可追溯的交付结论

灵犀会做什么:

  • 对每个需求项(F)独立给出 Pass/Fail
  • 为每条结论附证据引用
  • 证据不足或不可验证的需求项(F)判定为 Fail

产出:

  • 验收结论与证据引用(可形成 001.review.<标题>.md

流程示例

简单任务(skip-plan)

/task 修复登录页面的表单验证 bug
/build
/review

复杂任务(建议完整链路)

/task 重构用户权限系统,支持 RBAC 模型
/vet
/plan
/build
/review

多任务并行

/vet 002
/plan 001
/build 001
/review 002

下一步

MIT 许可证 · 版本与反馈见 GitHub