| name | skein-flow |
| description | 强制 task 闭环。复杂/多步/跨文件请求, 或用户显式要求把请求作为 SKEIN task 处理时使用 — 强推 plan→exec→check→finish 全流程, main 作调度器派 subagent 在 worktree 内执行, 禁 inline 直接做 |
| argument-hint | [任务描述] |
| arguments | [任务描述] |
| model | sonnet |
| effort | medium |
把请求强制作为 SKEIN task 处理, 除非用户输入 --skip，否则禁 inline 直接做 (即使看似简单)。但不等于一定新建 — 先判全新任务 vs 对现有 active task 的补充, 再决定新建/并入
执行载体铁律 (最高优先级)
「派 agent」=真实 Agent tool_use / main 默认禁写源码 / 有 task 必有 worktree / dispatch 6 字段 / 完成即时回传 / 并发请求禁互相顶掉 等。全量 11 条铁律详见 references/carrier-rules.md。
任务执行流程 (plan → exec → check → finish 四步闭环)
plan
- 先查未完成再 durable 登记 (防丢/防并发覆盖/防堆重复) — 第一步先跑
skein list --status open --json 判归属: 相关 → 并入补 subtask 不新建; 无相关才 skein create 落 pending。被中断/顶掉亦可 /skein-exec 无参续跑, 绝不静默跳过。禁不查就 create、禁一直堆新 task。
- memory recall — 派
skein-specer 召回 recall 规则注入 dispatch prompt「已知」段 (core 规则已常驻)。
- Skill(skein-grill) 确认需求 → Skill(skein-plan --continue) 规划+
subtask add 登记 → 🛑 ToolCall(AskUserQuestion) 评审确认 → skein start <id> 激活 (建 worktree)。未确认禁进 exec (硬门 · STOP)。
exec
- Skill(skein-exec) DAG 就绪即派 / 完成即派 (并发上限 2)。执行一律派 agent (🛑 硬门): 有 subtask 走
claim→派 Agent→done→claim; 无 subtask main 派 1 个 skein-executor。禁 main inline 顺跑。派发后回合末 MUST 输出任务清单; 禁问顺序。
- exec/check/finish 禁动 design.md — 方案调整回 planning 改 design 后重派。
check
- Agent(skein-checker) 跑 lint/type-check/tests/契约合规 + 一致性核查。未过或检出冲突 → 回 planning 重确认 (task 保持
进行中): grill/AskUserQuestion 与用户确认修复方向 (定点修/重拆/改契约), 禁跳过确认直接补 subtask; 确认后同 task subtask add 修复子任务 (--deps 挂失败源) 回 exec 重派, 全绿且零冲突才放行。详见 skein-check skill。
finish
- Skill(skein-finish) 收尾门 (check 全绿后): 派
skein-finisher 勘察 → 委托 skein-spec sediment → 清理悬挂 → skein finish。sediment 判定门 (自动沉淀): skein-specer 产候选 → main 逐项 trace + skein-spec sediment 自动写盘; 无增量跳过。详见 skein-finish skill。
作用域边界 (何时建 task)
| 特征 | 判定 |
|---|
| 纯查询 / 文档阅读 / 问答 (无改动) | 豁免 |
| 单文件单处改, ≤20 行且位置已知 | 豁免 |
| 跨 ≥2 文件 / 单文件多处 / 多步骤 | 必建 task |
| 需外部调研 / 产出文档交付 | 必建 task |
| 边界模糊 | AskUserQuestion 用户裁定 |
归一 vs 分立 / worktree 豁免 / 完成判定 详见 references/scope-boundary.md。
失败模式 (if-then 三段式: 触发 → 一线修复 → 仍失败兜底)
| 触发 | 一线修复 | 仍失败兜底 |
|---|
| 判新旧不准 (新建 vs 并入现有 active) | AskUserQuestion 用户裁定 | 用户也不确定 → 默认新建, 保守留旧 task 不动 |
| 相关工作误判成独立 (拆多 task) | 按相关性收敛: 相关 → 归一 task 拆 subtask (subtask add) | 已误建多 task → skein archive 多余者, 归一到主 task 补 subtask |
| 某阶段未达出口 (plan 未收敛 / check 未绿) | 停在该阶段, 禁跨阶段推进 | 反复不过 → 走对应子 skill 兜底 (check 第 3 轮根因复盘) |
宣称派 agent 但无 Agent tool_use | 立即在同回合补真实 Agent 调用 | 补不出 → 硬错停手, 禁回传「已派出 / 在做」 |
| 有 subtask 却想 inline 顺跑 | 停手, 走 skein-exec claim→派 Agent 循环, 每 ready subtask 派 1 subagent | 派不出 → 硬错停手, 禁 main 代跑 subtask |
| 第二个 flow 进来, 第一个还没 durable | 先给第一个 skein create 落盘再处理第二个 | 都未落盘 → 立即各自 create, 未处理者留 pending 待续 |
❌ 反例 (命中=流程错误)
🔒 Iron Law: 「派 agent」=真实 Agent tool_use — 无 tool_use 即没派, 禁回传「已派出」。
违反上文铁律即流程错误: main 直接改源码 / inline 跳 task / 宣称派 agent 无 tool_use / 无 worktree 改源码 / 直编 .skein/task.md / 纯文本代替 AskUserQuestion / exec 阶段问用户顺序 / 有 subtask 却 main inline 顺跑不派 subagent / 第二个 flow 请求顶掉/中断在飞的第一个 task / 相关工作拆成多个 task 而非归一 task 拆 subtask。
自欺兜底 (高频反例)
| Excuse (自欺) | Reality (现实) |
|---|
| 「agent 已经在跑了 / 我说已派出」 | 无 Agent tool_use = 没派, 硬错停手禁回传 |
| 「两个请求差不多, 先做新的」 | 顶掉在飞 task = 丢上下文, 先给旧的 durable 落盘 |
