菜单
SKEIN 调研数据源路由 (绑定 skein-researcher agent)。planning 阶段做外部资料检索 / 库选型 / 竞品对比 / 现状勘察时使用 — 分层组合数据源: 项目内代码勘察 (Read/Grep/Glob) + 外部联网检索。外部检索优先探测 agent-reach (互联网能力路由器, 15 平台多后端): 存在则纳入数据源 (小红书/Twitter/B站/Reddit/GitHub/YouTube/Exa 等多平台并行), 缺失则降级 WebSearch/WebFetch。参考 agent-reach 实现, 不重造。
用 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-research |
| description | SKEIN 调研数据源路由 (绑定 skein-researcher agent)。planning 阶段做外部资料检索 / 库选型 / 竞品对比 / 现状勘察时使用 — 分层组合数据源: 项目内代码勘察 (Read/Grep/Glob) + 外部联网检索。外部检索优先探测 agent-reach (互联网能力路由器, 15 平台多后端): 存在则纳入数据源 (小红书/Twitter/B站/Reddit/GitHub/YouTube/Exa 等多平台并行), 缺失则降级 WebSearch/WebFetch。参考 agent-reach 实现, 不重造。 |
绑定 agent skein-researcher (它 frontmatter skills: skein:skein-research)。planning 阶段 main 派 skein-researcher 调研时, 数据源按本 skill 分层组合。
定位: 只管从哪取数据、怎么取; 结论汇总 / 设计裁定仍归 researcher 回传 main (见 skein-researcher 铁律)。
| 层 | 工具 | 适合 |
|---|---|---|
| 代码勘察 | Read / Grep / Glob / Bash | 现状勘察 / 既有实现 / 依赖版本 / 项目约定 (本地真值, 恒先查) |
| 外部检索 | agent-reach (存在) → 否则 WebSearch/WebFetch | 库选型 / 竞品对比 / 官方文档 / 社区讨论 / 最新版本 |
顺序: 先本地代码勘察 (成本低、最相关), 再外部检索补空缺。CLAUDE.md 硬规: 提问前先搜项目。
探测门 (外部检索开跑前必做一次):
command -v agent-reach >/dev/null 2>&1 && echo AVAILABLE || echo FALLBACK
| 触发 | 一线修复 | 仍失败兜底 |
|---|---|---|
| agent-reach doctor 报目标平台后端全挂 | 换 agent-reach 内同类其他后端/平台重试 | 仍不可用 → 降级 WebSearch 并声明「该平台数据未覆盖」 |
| 外部检索零结果 (查空) | 换关键词 / 换平台分类 (search↔dev↔social) 重试 | 仍空 → 回传「已查 X 源均空, 现状可能无先例」, 禁编造填充 |
| 本地勘察与外部结论矛盾 | 以本仓现状为准复核 (版本/约定/接口) | 无法调和 → 并列两方证据回传 main 裁, 禁单方拍板 |
🔒 Iron Law: 提问前先搜项目 — 先本地代码勘察 (Read/Grep), 后外部检索。
调研结论落盘仍走 skein-researcher 的「结论落盘」: .skein/task/<task-id>/research/<topic-slug>.md。本 skill 只定数据源, 不改落盘路径。