lazygophers/skein-flow

把请求强制作为 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 | jq -c '[.[] | {id,name,desc}]' (只取判归属所需字段省 token) 判归属: 相关 → 并入补 subtask 不新建; 无相关才 skein create <id> --name "任务名" --desc "一句话描述" 落 pending。被中断/顶掉亦可 /skein-exec 无参续跑, 绝不静默跳过。禁不查就 create、禁一直堆新 task。
• memory recall — 派 skein-recaller 召回 recall 规则注入 dispatch prompt「已知」段 (core 规则已常驻)。
• Skill(skein-plan --continue) 走完 brainstorm 需求澄清 → grill 硬门 → 规划+subtask add 登记 (brainstorm/grill 均在 skein-plan 内, 单一真值源, 顺序 brainstorm→grill) → 🛑 ToolCall(AskUserQuestion) 评审确认 → skein confirm <id> 过用户确认门 (待处理→就绪, 验 prd + ≥1 subtask) → skein start <id> 激活 (占 active 槽 + 建 worktree, 就绪→进行中)。未 confirm 禁 start, 未 start 禁进 exec (硬门 · STOP)。
• plan 阶段完成判据: 4 条 checklist (task 已 create / prd 已填完 / subtask 已规划 / 设计方案已定或 main 豁免) 详见 skein-plan SKILL.md「✅ plan 阶段完成判据」段。未勾满 = planning 未收敛, 禁 skein start。

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。

闭环完成判据 (四步逐一勾满才算 Done):

• [ ] plan: 查重 + create/并入 + brainstorm 需求澄清 + grill 确认 + skein confirm (待处理→就绪) + skein start 激活
• [ ] exec: 每 ready subtask 派真实 Agent, 回合末输出任务清单
• [ ] check: lint/type/test/契约全绿且零冲突
• [ ] finish: merge + 销 worktree + 标记完成 (检查中→已完成) + sediment 异步派出

作用域边界 (何时建 task)

原则: 该走 flow 的直接走, 不问用户要不要走; 简单的直接做, 不问能不能 inline。能走 flow 还是 inline 是 AI 自己该判的选择, 禁抛给用户。

| 特征 | 判定 | | --------------------------------- | ---------------------------- | | 纯查询 / 文档阅读 / 问答 (无改动) | 豁免 (直接做) | | 单文件单处改, ≤20 行且位置已知 | 豁免 (直接做) | | 跨 ≥2 文件 / 单文件多处 / 多步骤 | 必建 task (直接走 flow) | | 需外部调研 / 产出文档交付 | 必建 task (直接走 flow) | | 边界模糊 (走 flow vs inline 难判) | AskUserQuestion 问用户 (禁自行 inline 蒙混) |

归一 vs 分立 / worktree 豁免 / 完成判定 详见 references/scope-boundary.md。

🧭 场景路由 (ask-matt 同源)

决定建 task 后, 按输入场景定 planning 力度与走法 (非新增机器字段, 仅路由启发 — 与 ask-matt 场景路由器同源理念, skein 原生覆盖):

| 场景信号 | skein 内置走法 | | --- | --- | | 新 idea / 新功能 (有 codebase) | 常规 plan→exec→check→finish; plan 跑 grill 硬门 + research 判定门 | | 雾区大需求 (跨子系统 / 破坏式重构 / 看不清全貌) | heavy 档: 强化 grill + research 判定门保守灰区自动派 researcher + 命中复杂度天花板拆多 task (--deps 连 task 级 DAG) | | bug 堆积 / 多 issue 涌入 | plan 登记前查未完成 task (查重归并) + plan 收尾异步派 skein-dedup 织 DAG | | 难 bug 反复 (一处崩全批停) | exec subtask 失败自愈闭环 (定点重派 / 加修复 subtask 定点修根因); check 根因协议兜底 | | 代码健康 / 架构改进 (非 feature) | 独立 skein create 改进类 task, 走标准四步闭环 | | 设计问题需验证 (UI/状态模型) | plan research 判定门派 skein-researcher 勘察, 或独立 sandbox task 原型验证 (不落主仓库) | | 多 session 大型 build | supertask 聚合层 + child task 各自完整闭环, task 级 --deps 排队 |

零外部 skill 硬依赖 — skein 四步闭环自包含覆盖全部场景。熟悉 Matt Pocock /ask-matt 套件者, 完整 skill 级映射见 references/matt-pocock-mapping.md (装了外部 skills 可选增强, 没装 skein 照跑)。

失败模式 (if-then 三段式: 触发 → 一线修复 → 仍失败兜底)

| 触发 | 一线修复 | 仍失败兜底 | | --------------------------------------- | ---------------------------------------- | --------------------------------------------------- | | 判新旧不准 (新建 vs 并入现有 active) | AskUserQuestion 用户裁定 | 用户也不确定 → 默认新建, 保守留旧 task 不动 | | 相关工作误判成独立 (拆多 task) | 按相关性收敛: 相关 → 归一 task 拆 subtask (subtask add) | 已误建多 task → skein archive <多余task-id> 归档多余者, 归一到主 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 待续 |

✅ 正向配方 (命中反面=流程错误)

🔒 铁律: 「派 agent」=真实 Agent tool_use — 无 tool_use 即没派, 禁回传「已派出」。

| 场景 | 正确做法 (❌ 反面) | | ---------------------- | ------------------------------------------------------------------------------ | | 改动源码 | 派 agent 在 task worktree 内改 (❌ main 直接改源码 / 无 worktree 改源码) | | 处理请求 | 强制走 task 闭环, 即使看似简单 (❌ inline 跳 task) | | 派 agent 声明 | 必带真实 Agent tool_use, 无则硬错停手禁回传 (❌ 宣称派 agent 无 tool_use / 自欺「agent 已经在跑了 / 我说已派出」) | | 改任务状态 | 经 skein CLI 操作 (❌ 直编 .skein/task.md) | | 用户确认 / 选择 | 走 AskUserQuestion 工具 (❌ 纯文本代替 AskUserQuestion) | | exec 派发顺序 | 按 depends_on DAG 自动排序即派 (❌ exec 阶段问用户顺序) | | 有 subtask 的 task | 走 claim→派 subagent→done 循环, 每 ready subtask 派 1 个 (❌ main inline 顺跑不派 subagent) | | 新 flow 进来 / 多请求 | 先给在飞的第一个 task durable 落盘再处理第二个, 保上下文 (❌ 第二个 flow 顶掉/中断在飞 task / 自欺「两个请求差不多, 先做新的」) | | 相关工作组织 | 归一 task 拆 subtask (❌ 相关工作拆成多个 task) |