菜单
SKEIN 工作区初始化 + 结构维护。未初始化仓库 (无 .skein/ 或 SessionStart 提示) 一键 scaffold; 已初始化时按需手动优化 .skein 结构 (spec 类目重组 / core↔recall 层调 / config 调参), 改盘后 reindex。既有 trellis 仓迁移见 references/trellis-migration.md。幂等可重跑。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
planning 入口 + 单一真值源 (用户显式 /skein-plan 或被 skein-flow 委托)。新建 SKEIN task 做需求梳理: 判新旧 + create 登记 + 交互式 brainstorm + grill 硬门。产出 prd.md + design.md + 子任务/依赖 DAG 落 task.json。无参 = 停在 start 前 (只规划不执行); --continue = 返回工件路径供 flow 激活。硬约束: 未跑 grill / 未 subtask add 禁进 exec; design.md 仅 planning 阶段可写
两层规则记忆 (基于 .skein/spec)。planning 时 recall 召回相关规则、task finish 后 sediment 沉淀学习 + prune 自动精简过期/重复/断链规则。core 常驻硬规 + recall 按需召回, 经判定门自动写盘 (不逐次问用户)。产出 .skein/spec 下 core/recall 规则文件 + index。另支持空仓 bootstrap 播种规则基线、记忆大面积失效 (大重构/换栈) 时 reconstruct 可逆归档后按项目类型分型重建、maintain 手动体检 (超预算/stale/断链/重复/废弃)。硬约束: sediment+prune 异步 fire-and-forget 不阻塞 finish; core 只留硬约束
task check 阶段质量验证。exec 产物完成后、finish 前使用。派 skein-checker 跑 lint/type-check/tests/契约 + 一致性核查, 回传通过|失败|冲突报告。未过或检出冲突不放行 finish。验证与修复分离。
task exec 阶段执行编排调度门 + /skein-exec 闭环入口。作命令: 有入参→强制建 task 走闭环 (委托 skein-flow: plan→exec→check→finish, 不 inline); 无入参→驱动 .skein 既有 ready/active task 各走闭环。作 skill: 被 skein-flow exec 委托, main 按 depends_on DAG 为每个 subtask 选合适 agent 各执行 1 个, 改动落 task worktree。回传各 subtask 产物 / 需要 / 失败。硬约束: 并发上限 2、完成即派、main 禁亲改源码、载体单 subagent 不递归、异步等待 MUST 输出任务清单
task 收尾闭环门。check 全绿后使用 (被 skein-flow finish 委托, 或用户显式 "收尾/归档/闭环") — 派 skein-finisher 收尾勘察 (diff/subtask 核对/悬挂清单, 同步门) → skein finish (commit→merge→archive→销 worktree, 先闭环) → 异步 fire-and-forget 派 skein-specer 跑 sediment 判定门 + 自主写盘 (不阻塞 finish)
强制 task 闭环。复杂/多步/跨文件请求, 或用户显式要求把请求作为 SKEIN task 处理时使用 — 强推 plan→exec→check→finish 全流程, main 作调度器派 subagent 在 worktree 内执行, 禁 inline 直接做
| name | skein-setup |
| description | SKEIN 工作区初始化 + 结构维护。未初始化仓库 (无 .skein/ 或 SessionStart 提示) 一键 scaffold; 已初始化时按需手动优化 .skein 结构 (spec 类目重组 / core↔recall 层调 / config 调参), 改盘后 reindex。既有 trellis 仓迁移见 references/trellis-migration.md。幂等可重跑。 |
| argument-hint | [trellis 迁移模式: 缺省=兼容保留 .trellis 数据, 完全删除 .trellis] |
| arguments | [trellis 迁移模式: 缺省=兼容保留 .trellis 数据, 完全删除 .trellis] |
| model | sonnet |
| effort | medium |
| user-invocable | true |
两用途：① 未初始化仓库 → 建 .skein/ 工作区；② 已初始化 → 手动优化 .skein/ 结构。幂等 — 重跑安全。
触发: 用户显式
/skein-setup, 或 SessionStart hook 注入「无.skein/」提示后 main 主动调用。
skein setup # 幂等 scaffold + 输出 manifest JSON
| manifest / 现状 | 用途 | 见 |
|---|---|---|
无 .skein/ (trellis_present:false) | ① 初始化 — main 直接跑, 纯机械 | 下 §初始化 |
已有 .skein/ | ② 结构维护 — 用户手动优化 | 下 §结构维护 |
检测到 .trellis/ (trellis_present:true) | ① 的一种场景 — 派 agent 语义迁移 | references/trellis-migration.md |
skein setup (纯机械, 不派 agent): 建 .skein/ + config + gitignore + 本地 .skein/spec 库。完成即可用。.trellis/) → 🛑 检测到 .trellis/ 时 main 用 AskUserQuestion 让用户选迁移模式 (缺省兼容 · STOP, --full 整删不可逆): 兼容 (留 .trellis/ 数据) / --full (整删 .trellis/); 接线 (hooks/scripts/settings) 两模式都删。据选定跑 setup 或 setup --full, 语义迁移 (派 skein-setup agent) 详见 references/trellis-migration.md。用户想调整 .skein/ 布局时用。可调项 + 落地方式：
| 想改 | 怎么改 | 收尾 |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------- | ------------ |
| 并发上限 (max_active / max_parallel) | 直接 Edit .skein/config.yaml | 无 |
| spec 类目重组 (类目 = 层内子目录, 自由取名 git/test/arch/build/style/domain/ops...) | 移动 / 改名 .skein/spec/<layer>/<category>/*.md | skein-spec reindex |
| core↔recall 层调 (core 常驻过重, >8000 字符会告警) | 把规则文件从 spec/core/ 移到 spec/recall/ (或反向) | skein-spec reindex |
| 新增一条规则 | skein-spec sediment --layer <core | recall> --category <cat> --title <T> | 自动 reindex |
reindex — 索引 (三份 index.md) 落后于实际盘面 = 召回失效。skein create/start/... 命令维护, PreToolUse hook 硬阻直接写。.skein/spec 已存在则不重复拷贝。.skein/task*。🔒 Iron Law: 幂等可重跑; task.json/task.md 经脚本不经手改 (PreToolUse hook 硬阻)。
| 禁 | 为什么 | 改为 |
|---|---|---|
手改 .skein/task* 绕过脚本 | PreToolUse hook 硬阻 + 破坏索引一致性 | 经 skein create/start/... 命令 |
| 改 spec 盘面后不 reindex | 三份 index.md 落后盘面 = 召回失效 | 必跑 skein-spec reindex |
检测到 .trellis/ 直接 setup --full | 未问用户就整删可能丢数据 | 先 AskUserQuestion 选兼容 / --full |
| 已初始化仓重跑当报错 | setup 幂等, 重跑安全不覆盖 | 正常重跑, config/spec 存在则跳过 |
| 什么都堆进 core 常驻 | >8000 字符告警, 稀释硬约束 | 默认 recall, core 只留命令式硬契约 |
| 触发 | 一线修复 | 仍失败兜底 |
|---|---|---|
skein setup 报错 | 读 manifest JSON error 字段定位 (权限 / 路径占用 / 已存在) | 仍失败 → 报用户, 禁手工拼凑 .skein/ |
skein-spec reindex 报错 | 读 stderr 定位 (类目名非法 / 路径) | 仍失败 → 停手报用户, 禁半写坏索引 |
| trellis 迁移中断 | 数据仍在 .trellis/ (兼容模式未删), 重跑迁移 | 仍中断 → 报用户, 禁手工拼凑 .skein/ |