skein-exec

name	skein-exec
description	SKEIN exec 执行方法论 — skein-executor agent 绑定 skill。单个 running subtask 的完整执行纪律: workdir 硬门 + worktree 改动范围判定 + 自读 subtask 详情 (不靠转述) + spec 约定佐证 + 读后写硬门 + done 前可运行验证 + JSON 回传格式。只做范围内事, 收尾仅 subtask done/fail。
argument-hint	[tid] [sid] [任务描述]
arguments	["tid","sid","任务描述"]
user-invocable	false
model	sonnet
effort	medium
context	fork
agent	skein-executor

skein-exec — exec 执行方法论

🔒 本 skill 是 skein-executor agent 的执行纪律单一真值源; agent .md 只留入参/回传/边界。 全局流程规则 (状态机/调度/优先级) 以 skein-flow/references/ 为单一真值源。

工作流四步

入参只给定位信息, 详细要求靠自己读。

1. 定工作目录 + 读详情

• workdir 硬门 (纯事实校验, 不推断运行模式): 开工前确认 workdir 存在且可写。不满足 → 立即 skein subtask fail <tid> <sid> --note "workdir <路径> 不存在/不可写" 并回传, 禁先改一堆文件再失败。
• 改动范围照入参的 worktree 字段, 不看路径长相: on → 改动只准落在 workdir 内, 主工作区不在范围; off → 在仓库根原地改, 无隔离。字段缺失按 off 处理并在回传里标注。
• 自跑 skein subtask show <tid> <sid> 读 desc/验收/depends_on/skills 等全部字段, 不靠 dispatch prompt 里的转述。
• 需 spec 约定佐证时先 skein-spec recall <关键词> (namespace×inclusion 记忆库, 只读)。
• 缺信息 (验收模糊/依赖不明) → needs 标 需要: <问题>, 不猜, 不直接问用户。
• 你被派时 subtask 已是 running 态 (main 用 skein claim / skein flow run 前置占槽), 不重复占槽、不跑 claim/start。

2. 定位现状

Grep / Glob 定位改动点 → Read 目标文件全文

• 读后写硬门: 改任一文件前先 Read (漏读即改 → Edit 失配或覆盖)。

3. 执行改动

按 subtask 详情写码 / 改配置 / 跑命令。

• 命令带 cwd 指向工作目录; 记 exit code + 结果摘要。
• 命令失败 → [工具失败: <命令 + 原因>], 不把报错当成功继续。
• 踩到可复用约定 → skein-spec sediment --namespace <ns> --inclusion always|auto --category <类目> --topic <主题> --title <规则标题> --body-file <正文.md> 落盘 (--title 与 --body-file 必填, 正文只认 --body-file 文件; 先 skein-spec sediment --help 核实参数)。

4. 自跑收尾 + 回传

按验收标准逐条对照 pass/fail。改过的脚本必须先验证可运行才准报 done (改 py 就跑 python3 <改过的脚本> --help; 改测试就跑 pytest 该文件), 跑不通一律 subtask fail 而非 done:

• 全 pass 且可运行 → skein subtask done <tid> <sid>
• 有 fail/缺信息 → skein subtask fail <tid> <sid> --note "<原因>"
• 附改动摘要 → 回传 JSON。

检查点

🛑 改动范围由入参 worktree 字段决定, 不由路径长相决定 — on 时止步于 workdir, 不含主工作区; off 时在仓库根原地改。 🛑 撤销改动只准 git checkout -- <自己改的具体文件> 逐个点名 — git reset --hard / git reset / git clean / git stash / git checkout . 不在允许范围内。原地态 (worktree 禁用) 下同一文件可能有并发或已完成 subtask 的改动, 全仓回滚会静默抹掉它们且无人发现。 🛑 done 前必须验证可运行 — 改过的脚本跑一次 (python3 <脚本> --help / pytest 该文件); 跑不通报 subtask fail 而非 done。报了 done 却 import 就崩, 会让下游 subtask 基于不存在的符号写代码。 🛑 读后写硬门 — 改前先 Read 目标文件。 🛑 允许自跑 subtask done/fail；create/start/check/finish/del 等生命周期命令归 main。 🛑 缺信息标 需要: <问题> 回传, 由 main 转达用户 — 无 AskUserQuestion 权限。 🛑 工具失败必标 [工具失败: <原因>] — 命令失败/Read 不存在时, 只标 [工具失败: <原因>], 不当成功结果返回 (原始错误输出不是有效结果)。 🛑 exec 不勾 PRD 验收 — 正式验收归 check。scope 外问题另建 task, 不塞进当前 subtask。

失败模式 (if-then 三段式)

触发	一线处理	兜底
验收标准不明	按最合理解释做 + note 标假设	判不准 → needs 标 需要:, subtask fail --note, status=需 main 介入
依赖文件/接口缺失	Grep 全仓找替代	找不到 → needs 标缺失依赖, subtask fail, 不臆造
命令报错	读报错定位, 修 1 次重跑	仍败 → [工具失败: <原因>] + subtask fail + status=需 main 介入
改动超出 subtask 范围	只做范围内, 范围外记 note	needs 标「范围外发现」交 main 判是否拆新 subtask