ccplugin

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 直接做

对抗式审查 (红队, 非审批)。planning 产物 (prd 主入口/design 详细设计/findings 调研 + task.json 子任务) start 前硬门、或用户显式 "grill/盘方案/审设计/红队" 时使用 — 多轴逼问挖漏洞/隐藏假设/未定边界, 逐问给推荐答案+codebase 先查, 弱点表交用户裁才放行。main 亲做 (交互式)。

SKEIN 工作区初始化 + 结构维护。未初始化仓库 (无 .skein/ 或 SessionStart 提示) 一键 scaffold; 已初始化时按需手动优化 .skein 结构 (spec 类目重组 / core↔recall 层调 / config 调参), 改盘后 reindex。既有 trellis 仓迁移见 references/trellis-migration.md。幂等可重跑。

主动清理 (仅用户显式调用)。归档完成 task (保留期外) + 清残留孤儿 worktree / 悬挂 skein/* 分支 — 安全清扫 (只清已完成/已合并的), 存疑先报用户。入参 = 保留天数

SKEIN 调研数据源路由 (绑定 skein-researcher agent)。planning 阶段做外部资料检索 / 库选型 / 竞品对比 / 现状勘察时使用 — 分层组合数据源: 项目内代码勘察 (Read/Grep/Glob) + 外部联网检索。外部检索优先探测 agent-reach (互联网能力路由器, 15 平台多后端): 存在则纳入数据源 (小红书/Twitter/B站/Reddit/GitHub/YouTube/Exa 等多平台并行), 缺失则降级 WebSearch/WebFetch。参考 agent-reach 实现, 不重造。

跨任意组件（plugin/skill/agent/command）的验证驱动优化循环纪律 skill。当用户要优化某个已有组件却无明确方向、或要防止改了反而更差（自评乐观偏差 / 多维同改归因失效 / 为凑分加废话膨胀）、或要把一套通用「评分→单变量改→改后验证严格更好才留否则回滚→触顶停」的纪律套到任意组件上时使用。管优化过程本身的纪律（validation gate / ratchet / 独立验证 / 触顶停），不评单组件深度（交 skill-dev），不查插件接线（交 plugin-dev）。仅手动 /optimize-any 触发。

创建与优化 Claude Code 插件的方法论框架。当用户要新建插件（搭 .claude-plugin/plugin.json manifest + 接线 commands/agents/skills/hooks/MCP/LSP/monitors + 挂 marketplace）、或审查优化现有插件（manifest 合规 / 组件接线完整性 / hook 健壮性 / marketplace 一致性）时使用。单组件（单个 skill / agent）编写或 9 维质量优化路由 skill-dev。仅手动 /plugin-dev 触发。

创建、维护与持续优化 Claude skills 和 subagents 的方法论框架。写 SKILL.md / 新建 skill / 设计 subagent(agent.md) / 配 frontmatter / 拆 progressive disclosure(流程 A 创建), 或诊断 9 维短板 / 修触发准确性 / 补失败模式 / 收窄误触发 / validation-gated 优化现有 skill(流程 B 优化)时使用。领域/主题视角蒸馏(分维度调研+三重验证)内置流程 A; 9 维评分+validation-gated 爬山+可视化成果卡片内置流程 B。仅手动 /skill-dev 触发。

🛠️ 把 worktree隔离 + 闭环收尾 + task.md看板 三维注入当前项目 .trellis/。全部为 trellis 生命周期 hook 确定性强制 (after_start 建 worktree, after_finish 自动 commit→merge→archive→销 worktree, taskmd hook 维护看板), 不靠 AI 跑脚本。结果导向: 只约束最终行为闭环 (worktree 建/销 + create→…→finish 收尾链完整), 不约束注入方式。幂等 (marker 包裹)

🔄 请求级入口: 把指定请求强制纳入 trellis task 闭环 (plan→exec→check→finish), 禁 inline (即使极简)。用户显式调用 (/trellisx-flow) 或 model 自动触发 (请求复杂/多步/跨文件时)。调用即创建同意信号, 仍先判新建 vs 并入 active task。与 trellisx-apply 互补 —— apply 注入"推荐建 task"常驻软提示指向本 skill, 由本 skill 接管。载体默认 subagent 编排 (main 调度 trellis-implement 共享 task worktree 并发 2)

创建或更新单个小说人物的详细设定。当用户说"加个人物/写某角色设定/完善某人物/这个角色的经历关系"时调用。每个人物在 人物/<人物名>/ 下独立文件夹, 拆为三文件: 简介.md(简介+性格)、经历.md(各时间段经历/事件)、关系.md(与他人交集/是否见过)。本 skill 独占 人物/ 目录。

检查小说整条故事线的一致性(18 子项)。当用户说"检查一致性/查冲突/审故事线/有没有矛盾/设定对不对"时调用; 也被 novelist-write 在编写前引用取事实快照。mode=detect(默认只读审查产冲突清单) / mode=fix(单点冲突直接 Edit 修正, 段落级派 chapter-writer)。派 continuity-auditor agent 审查, 报告落 元数据/检查报告/。

小说创作大师视角——叙事心智模型库与镜片选择引擎。蒸馏三大叙事传统(中文类型/网文、世界结构、纯文学)的可操作创作启发式, 按用户自己小说的题材选用对应"叙事镜片"。当用户问"这章人物怎么写更立得住/情节怎么推/力量体系怎么设/节奏怎么调/用什么写法"时调用; 也被 novelist-design 与 novelist-write 引用作为创作引擎。这是知识框架 skill, 不替代用户决策——它给镜片, 用户选镜片。

小说的整体核心设计——主要剧情与主要人物一起定(二者必须同处本 skill, 因为主角与主线相互定义)。当用户说"设计这本书的核心/定主线和主角/搭整体框架/核心设定"时调用。本 skill 是统筹者: 自己产出核心骨架, 并引用 novelist-outline / novelist-character / novelist-worldview 落地各部分细节, 不与它们抢目录。

去 AIGC / 去 AI 味——把读起来"像 AI 生成"的小说正文改回"像人写的", 降低 AIGC 检测特征同时提升可读性。当用户说"去AI味/降AIGC/这段太AI了/去机器味/人味润色/过检测"时调用; 也被 novelist-write / novelist-rewrite 的生成后收尾链引用。去味时**先运行时发现并依次执行用户已安装的所有 humanizer 类 skill(动态发现, 不硬编码路径)**, 再用本插件 humanizer agent 补小说特化去味(对话破坏/情感呈现)。诊断三层 AI 味(统计指纹/通用tells/小说特有)。只改文字纹理, 不动剧情设定。

初始化一部新小说的目录环境(scale)。当用户说"新建小说/开一本书/初始化小说项目/搭小说目录"时调用, 创建中文目录骨架(人物/世界观/设定/大纲/情节/章节/元数据)+模板文件。这是 novelist 插件所有其他 skill 的前置——没有目录环境, design/write/check 无处落盘。

校验 novelist 插件目录结构/文件名/文件夹组织是否符合插件规范 (plugin.json 合法 / commands-agents-skills 在根 / SKILL.md 大写 / kebab 命名 / 无产物泄漏 / plugin.json 路径真实 / frontmatter name 对齐)。novelist 插件改动后、加新 skill/agent 后、发布前、或怀疑结构不合规时调用。调用即跑 scripts/lint.py 扫 7 规则违规, 按 fix-hints 移/改/删到合规

创建或更新小说的大纲与情节线。当用户说"写大纲/规划剧情/排章节/理主线支线/管伏笔"时调用。管理 大纲/(总纲+分卷) 与 情节/(主线+支线+伏笔追踪) 目录, 把宏观结构与逐章节奏落到可核对的表格。本 skill 独占 大纲/ 与 情节/ 目录。

批量写小说的流水线编排: 默认 mode=write 两流水线并行批量写(Writer 流 ‖ 检测定稿流, 每章 write→三环并行检测(check/humanize/proofread)→fix串行改→定稿)。加 mode 入参支持 review(评审)/humanize(去AI味)/proofread(校对)/polish(润色=三环收尾)/rewrite(重写)/outline(大纲)。载体: write 默认 Workflow(workflow.js), 其余默认 trellisx subagent 编排(main DAG 调度派 novelist 系列 skill, 并发上限2); --workflow/--no-workflow 覆盖。当用户说'批量写N章/写到第N章/连续写多章/逐章写/评审N章/校对N章/润色N章/去AI味N章/重写N章/出大纲'时调用。

校对小说正文的文字层问题(12 子项)——错别字(形近/音近/多漏字)、语法(残缺/搭配/语序)、标点、用词、用字统一。支持 mode=detect(只读扫描产报告, 不改正文) 与 mode=fix(默认, 报告+就地 Edit 修正)。当用户说"校对/查错别字/润色文字/检查语法/通顺一下"时调用。区别于 novelist-check(查剧情设定一致性), 本 skill 只管文字表达正确通顺, 不动剧情。派 proofreader agent 校对, 报告落 元数据/校对报告/。

重写小说章节。入参 mode=detect|fix(默认 fix): detect=只读诊断, 扫描全书产「建议重写章清单+理由+建议模式A/B/C」, 不改文件; fix=执行三模式——(A) 按 novelist-check 报告定点修复冲突; (B) 从指定章起清空该章及之后重写; (C) 连续重写多个指定章节。当用户说"重写第N章/从第N章开始重写/这几章重写/按检查报告改/第N章之后全删重写/诊断哪些章需重写"时调用。清空是破坏性操作, 执行前必须显式确认。本 skill 独占 章节/ 目录的覆盖写入。

爆款题材选择——网文/小说选题方法论框架 + 实时数据协议。当用户问"写什么题材火/选个爆款题材/这个题材现在能写吗/选题/题材有没有市场/红海还是蓝海"时调用; 也被 novelist-design 在立项前引用以定题材方向。给的是稳定的选题判断镜片(榜单逻辑/生命周期/红蓝海/作者优势匹配/避坑), 当下"什么火"靠 agentic protocol 联网取——不钉死会过时的热点。这是决策辅助框架, 不替用户拍板, 给镜片+利弊由用户选。

创建或更新小说的世界观与各类设定。当用户说"设定世界观/写背景设定/定魔法体系/加个组织或物品设定/历史背景"时调用。世界观拆为 地理/势力/规则(力量体系)/历史 四文件; 其他设定(物品/组织/术语)按一设定一文件存于 设定/ 目录。本 skill 独占 世界观/ 与 设定/ 目录。

小说写作一站式入口——用户只需调用 write, 即跑完整链: 前置就绪(目录环境+核心设计)→ 四要素确认 → 生成正文 → 收尾链(一致性检查→校对→去AIGC→定稿)。当用户说"写第N章/继续写/接着写剧情/写下一章/写这本书"时调用。设计未就绪会自动引导补(design), 全流程由本 skill 编排, 用户不必分别调各 skill。本 skill 独占 章节/ 目录的新增写入。

➕ 规划级入口 (只规划不执行): 把指定请求纳入 trellis task 的 planning 阶段 —— 判新旧 + task.py create 登记 + 交互式 planning (brainstorm 主导 + grill 硬门1 边问边写), 产出 prd/design/implement 后停在 task.py start 之前, task 留 planning 态, 禁 exec/check/finish。用户想"先看规划再决定执行 / 添加分析规划任务 / 只规划不动手"时用。仅显式调用 (/trellisx-add), 禁 model 自动触发。与 trellisx-flow 边界: flow=强制全闭环 (plan→exec→check→finish), add=只到 planning 停; 执行 pending 规划态 task 走 /go

🧹 批量收尾 —— 一次清理/归档/收尾**全部**已完成 task。三件事: ① 清理所有已合并的 worktree ② 归档所有已完成的任务 ③ 清理 task.md 看板的已完成行。完成判定 = completed ∪ merged (并集), 当前 active task 永不纳入。**强制 dry-run → 用户确认 → --apply 执行** 三段护栏, worktree 销毁沿用安全判据 (脏/未合并自动保留, 不丢提交)

🔥 对抗式审查 trellis 任务工件 (prd / design / implement / spec / subtask 文件), 贯穿 plan 前/中/后全程逐分支 stress-test 设计树, 帮用户确认/审查/拆解需求。逐问审 (可一次多问批量确认提效 + 推荐答案 + codebase 能答先查), 产物 = 工件内联批注 + 弱点表 (不改写工件, 由 orchestrate/spec 决定怎么改)。独立全周期可调, plan 前 / planning 中 / start 前 / spec 重构前 / 任意决策点都能用。源于 grill-me (relentless interview) + 项目盲点实证

🎯 在 Trellis 项目 planning 阶段, 指导编写 task 文件夹内的 prd.md / design.md / implement.md, 把任务编排理念 (五要素拆分、执行层选择、资源互斥、失败回退) 内嵌到文档中。让后续 dispatch 与执行有据可依, 而不是写完 PRD 才临时想怎么拆

📐 初始化 / 优化 / 重写 .trellis/spec/ 规则文档, 允许破坏式变更 (丢弃旧版本、合并、拆分、推翻原结构), 把描述性条款改为可机器验证的命令式契约 (MUST / 禁 / 严禁)。流程: 诊断 (初始化跳过) → 提案 → AskUserQuestion 强制审批 → 执行 + 同步 task manifest 引用清单。严禁未确认改写。sediment 模式 = finish 前判定门 (5 正向 + 3 排除 checklist, 有增量才沉淀, 全否跳过); planning 时 spec 加载归 trellisx-orchestrate step 1 grep 门 (本 skill 不负责加载, 仅提供 spec 内容)

📋 维护 `.trellis/task.md` 任务看板 —— trellis 缺的跨任务总览。**一个表格, 一行一个任务**, 列为 id/名称/描述/状态/worktree/前置 (6 列; 状态列承载生命周期阶段: 规划中/实施中/检查中/收尾/已完成/已归档; 前置列=该 task 依赖的前置 task ID, 承载 task 级 DAG, 仅有依赖者标, 无依赖填 —)。在 task create/start/阶段切换/archive/设依赖 后**及时更新**对应行; 并**自动清理超 7 天的已完成行**防膨胀。保持看板与 task.json 实时一致

记忆库升降级维护 — 按金字塔模型 (L4 庞大 → L0 稠密) 自动 promote/demote. 信号: 频率 (近期提及) / 时间 (距今) / 重要度. 规则: 用户反复强调 → 逐级升; L1/L0 允许自动升不允许自动降. 主要工作区 L4-L2; 默认 --apply 落盘 (--dry-run opt-in 预览). 无独立脚本, 调 cortex-extract/save/lint 执行.

知识库构建 ingest — 接受 GitHub/GitLab/Website URL 或 local dir 输入, 自动识别+路由到 项目/<host>/<owner>/<repo>/ (本地 git repo 当 github/gitlab 处理, 非 git → 项目/local/<name>/). 默认 --apply 调度抓取 (gh/git clone/WebFetch 混合) + 落盘 (--dry-run opt-in 仅出 JSON plan 预览).

lint / 校验 / 体检 / audit / 死链 / 孤儿 / 规范化 / frontmatter — cortex 知识库与记忆树的合规检查与可逆 autofix。覆盖 wikilink 死链、frontmatter 缺字段、命名违规、目录同构、孤儿页、等级语义反写、脚本目录用途混淆等 7 类规则。默认 --fix 落盘修复；--check opt-in 仅预览。

整理当前会话上下文 → 记忆库. 自动判定全局 (L0 关键词/跨项目语义) vs 项目级 (默认/含 repo 特定); 用户可 --scope global|project 显式覆盖. 复用 cortex-extract 三轴 + cortex-schema 路径. 任务收尾或显式 'digest 上下文/沉淀' 触发.

extract/提取/promote/整理/归档/digest L4-inbox 收件箱, 按三轴 (抗遗忘度/强度/复用面) 路由到 L1-long/L2-mid/L3-short/项目/领域, 默认 --apply 落盘 + 增量游标 (--dry-run opt-in 仅出 JSON plan 预览). 触发词: 整理 inbox / 提取记忆 / 归档笔记 / promote / digest.