plugins/tools/cortex/skills/cortex-refactor/SKILL.md
vault 重构 — rename/merge/split/dedupe/extract/inline/migrate-locale/evolution-apply, --apply 才落盘 backup。仅显式触发。Triggers on "重命名", "rename", "merge", "split", "重构 vault".
npx skillsauth add lazygophers/ccplugin cortex-refactorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
vault 大动干戈类操作的统一入口。全部默认 dry-run, 用户明确 --apply 才改盘。
/cortex:lint 命中 path-naming-violation / filename-illegal 后用户授权修复/cortex:refactor evolution-apply 消化 cortex-digest 抽出的 proposal| 子操作 | 说明 | References |
|---|---|---|
| rename | 改文件名 + 全 vault wikilink 同步 | rename-merge.md |
| merge | 两页合一, src 移到 归档/ | rename-merge.md |
| migrate-locale | 切 vault.lang 时一次性 rename 业务目录 | rename-merge.md |
| dedupe | TF-IDF cosine 找相似页对, --apply 调 merge | rename-merge.md |
| split | 一页按 H2 拆多页, 原页留 callout | split-page.md |
| extract | 抽 H2 节为独立 concept 页 | split-page.md |
| inline | 子页内联回父页, 子页归档 | split-page.md |
| graph-rebalance | orphan/hub 扫, 自动补 link_gaps | split-page.md |
| evolution-apply | 消化 cortex-digest 写的 proposal, patch SKILL/AGENT | evolution-apply.md |
--apply 前在 _meta/.cortex-backup/refactor-<op>/<ts>/ 全量 backup 涉及文件--apply 跑一个文件验证, 再扩大范围auto 后缀触发)--apply 显式时才落盘)--apply)evolution-apply 不接 AUTO_MODE 跳问, 仍走 AskUserQuestion 一条条问 (单条用户授权)| 文件 | 用途 |
|---|---|
| references/rename-merge.md | rename / merge / migrate-locale / dedupe 详细命令 + dry-run 输出示例 |
| references/split-page.md | split / extract / inline / graph-rebalance 详细命令 |
| references/evolution-apply.md | evolution-apply 串行流程 + safety gate + AskUserQuestion 单条循环 |
tools
--- name: trellisx-workspace description: 维护 `.trellis/task.md` 任务看板 —— trellis 缺的跨任务总览。**一个表格, 一行一个任务**, 列为 id/名称/描述/状态/阶段/进度/worktree (状态/阶段中文显示)。在 task create/start/阶段切换/archive 后**及时更新**对应行; 并**自动清理超 7 天的已完成行**防膨胀。保持看板与 task.json 实时一致。 when_to_use: 维护 / 创建 / 更新 `.trellis/task.md` 任务看板时; task 生命周期任一节点 (create/start/阶段推进/archive) 之后同步看板时; 用户问"当前有哪些任务 / 任务进度 / 任务看板"时。被 trellisx-flow 与 trellisx-apply 注入的流程引用。 user-invocable: true argument-hint: [show|update|sync|cleanup ...] [task id] arguments:
testing
强制以 Trellis task 闭环处理用户指定的请求 (自判新建/并入 → plan→exec→check→finish 全程不跳步)。**仅用户显式主动调用** (/trellisx-flow 或明确要求"强制走 task 处理这个"); **禁止自动 / 被动 / 推断式调用** —— 不要因为某个请求"看起来该建 task"就自动触发本 skill, 那是 apply 注入的 no_task 倾向的职责。
testing
把 强推task + subtask拆分 + worktree隔离 + 闭环收尾 四维度增量注入当前项目 .trellis/ (workflow.md 的 no_task/planning/in_progress 块 + spec 背书文档 + trellis 生命周期 hook worktree 自动化)。强推 task 与闭环为纯 prompt 软约束 (非平台 hook 硬拦截)。**纯增量追加, 绝不替换 trellis 原生文本** (no_task 分类+征同意/check/finish/前缀全保留)。幂等 (marker 包裹)。
development
Claude Code 会话历史整理 — 扫 ~/.claude/projects/**/*.jsonl 全部 session transcripts, 提取学习增量 (用户校正/决策/踩坑/L0 规则) → 全局记忆库 ~/.cortex/.wiki/memory/. 默认 --apply 落盘 (--dry-run opt-in 仅出 JSON plan 预览). 与 cortex-extract (L4-inbox 内部) 互补.