mcpField
S
split-tasks

split-tasks

github.com/venhdevAgent 工作流115 次安装1 天前更新
代码仓库

关于 split-tasks

split-tasks 是将已确定的项目范围整理为带依赖关系的任务 DAG 的技能。它强调小型端到端切片、验收标准和来源追踪，可输出供审阅的 Markdown 表格或供自主运行器使用的精简 JSON。

主要功能

  1. 01将范围拆分为垂直切片
  2. 02以 DAG 表示依赖关系
  3. 03追踪切片的来源
  4. 04定义验收标准
  5. 05输出 Markdown 或 JSON

适用场景

  1. 01根据已确定的变更集规划实现
  2. 02为顺序执行准备任务
  3. 03为自主运行器生成任务清单

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/venhdev/skills --skill split-tasks

安装后在 Claude Code 中输入/split-tasks确认已加载。

详细介绍

split-tasks — 任务 DAG 分解与溯源切片

运行不变量

  • 零持久化边界：绝不将任务文件写入磁盘，也不向远程跟踪系统提交问题；仅生成内存中或可供审阅的任务 DAG 清单。
  • 垂直切片要求：严格将工作划分为端到端垂直切片（1–4 个文件，50–150 LOC），并设定可观察的验收标准；禁止按技术层横向划分（仅数据库或仅 API 的切片）。
  • 父级溯源严谨性：每个切片都必须明确追溯其来源（Parent Trace：ADR ID、Feature Slug 或 Frozen Contract 坐标）；禁止存在无来源切片。
  • 无环依赖约束：切片必须构成有向无环图（DAG）；禁止循环依赖。
  • 原子绕行：如果输入范围已适合在一个验证轮次内完成（≤ 3 个文件，单一验收标准），则保留为单个统一切片。
  • 自适应调用输出：生成人工审阅用的完整 Markdown 表格；由自主运行器调度时，输出精简的 JSON DAG。

领域规则

1. 切片规模与影响范围

切片必须能在一次 /forge 轮次内完成验证。如果切片涉及超过 4 个文件，或触及互不相关的领域上下文，则应沿独立的调用方或场景边界进一步拆分。

2. 拓扑阶段划分

按拓扑顺序排列切片：

  1. 契约 / 接缝锚点：类型声明、接口、特征测试。
  2. 核心垂直流程：最小端到端正常路径。
  3. 边界 / 弹性切片：验证、错误边界、并发防护措施。
  4. 精简 / 弃用：移除过时的垫片、标志或旧版路径。
3. 状态与调度生命周期
  • READY：所有前置依赖均为 DONE；可立即执行 /forge。
  • BLOCKED：等待上游前置切片完成。

规范输出契约

# Task DAG: <Feature / Scope> · <STAGED | UNRESOLVED>

Basis: <Root intent, architecture anchor, or ADR link>

| Slice ID | Title & Scope | Dependencies | Parent Trace | Acceptance & Verification Criteria | Dispatch State |
| :--- | :--- | :--- | :--- | :--- | :--- |
| S-01 | <Vertical deliverable> | None | <ADR / Spec Anchor> | <Automated test command or invariant> | READY |
| S-02 | <Dependent deliverable>| S-01 | <ADR / Spec Anchor> | <Automated test command or invariant> | BLOCKED |

Summary: <N> slices (Max depth <K>, <D> direct dependencies).
*(omit if clean)* Gap: <Unresolved dependency or ambiguous boundary requiring decision.>

自主 JSON 契约（适用于 Model Runner）：

{
  "basis": "<anchor>",
  "slices": [
    {"id": "S-01", "scope": "<title>", "deps": [], "parent": "<trace>", "verify": "<cmd>", "state": "READY"},
    {"id": "S-02", "scope": "<title>", "deps": ["S-01"], "parent": "<trace>", "verify": "<cmd>", "state": "BLOCKED"}
  ]
}
路由
  • 立即在当前会话执行 -> 通过 /changeset 选择第一个 READY 切片 -> 通过 /forge 执行。
  • 延后执行或团队积压跟踪 -> 使用 /tracking-tasks。
  • 长期运行的自动化流水线执行 -> Autonomous Runner（/goal）。
  • 范围不明确或依赖冲突 -> 使用 /clarify。

执行协议

  1. 接收已确定的 changeset、冻结契约或架构方向。
  2. 如果范围是原子的（≤ 3 个文件），则生成单个 READY 切片，不进行拆分。
  3. 否则，推导垂直切片、建立父级溯源，并验证依赖无环。
  4. 输出 Markdown DAG（供人工调用方使用）或 JSON DAG（供自主运行器使用）。

评论

支持 Markdown