菜单
lint / 校验 / 体检 / audit / 死链 / 孤儿 / 规范化 / frontmatter — cortex 知识库与记忆树的合规检查与可逆 autofix。覆盖 wikilink 死链、frontmatter 缺字段、命名违规、目录同构、孤儿页、等级语义反写、脚本目录用途混淆等 7 类规则。默认 --fix 落盘修复；--check opt-in 仅预览。
用 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 | cortex-lint |
| description | lint / 校验 / 体检 / audit / 死链 / 孤儿 / 规范化 / frontmatter — cortex 知识库与记忆树的合规检查与可逆 autofix。覆盖 wikilink 死链、frontmatter 缺字段、命名违规、目录同构、孤儿页、等级语义反写、脚本目录用途混淆等 7 类规则。默认 --fix 落盘修复；--check opt-in 仅预览。 |
| argument-hint | [--check|--fix] [target] |
| arguments | [--check|--fix] [路径] |
| user-invocable | true |
| disable-model-invocation | true |
| context | fork |
| agent | cortex-lint-worker |
cortex vault 的 7 类合规检查与可逆 autofix。默认 --fix 落盘修复；--check opt-in 仅预览。
破坏性提示：默认
--fix会改 vault (autofix R2/R4 等可修项)；只想看违规不落盘时显式传--check。
本段由 context: fork 派 cortex-lint-worker 后台跑：默认 --fix 跑 7 规则扫描 + autofix 落盘，产出修复报告。
plugins/tools/cortex/scripts/lint.sh [--rules R1,R2,...] [--target <dir>]
默认 --fix + 全规则；--target 默认 $HOME/.cortex；退出 0=全部 error 已修/无 error，非 0=fix 失败。worker 默认直接落盘 autofix (R2/R4 可修项)，把修复/残留清单 (规则 ID / 文件 / 级别 error|warn / 是否已修) 作为报告返回主会话。
仅预览 (不落盘) 时显式传 --check：
plugins/tools/cortex/scripts/lint.sh --check [--rules R1,R2,...] [--target <dir>]
| ID | 规则 | 级别 | autofix |
|---|---|---|---|
| R1 | wikilink 死链 | warn | 否 |
| R2 | frontmatter 必备字段 | error | 是 (按路径推断) |
| R3 | 命名 (领域 ≥2 级, 脚本 kebab) | warn | 否 |
| R4 | 同构 (memory L0-L4 + 三模块齐全) | error | 是 (mkdir) |
| R5 | 孤儿页 (无反链 + mtime>30d) | warn | 否 |
| R6 | 等级语义一致 (路径↔level) | error | 否 |
| R7 | 脚本目录用途分离 | warn | 否 |
error 命中即非零退出且机器可修；warn 仅打印。
| 任务 | 文件 |
|---|---|
| 查 7 规则具体定义 / 检测策略 | references/rules.md |
| 查 R2 推断 / R4 mkdir / lint.sh + _lint/ 实现 | references/fixers.md |
| 查 stdout/stderr 格式 + fixture + 验证命令 | references/output.md |
cortex-schema (顶层 + 三模块 + 5 级)cortex-schemacortex-schemacortex-extract