plugins/tools/cortex/skills/cortex-lint/SKILL.md
lint / 校验 / 体检 / audit / 死链 / 孤儿 / 规范化 / frontmatter — cortex 知识库与记忆树的合规检查与可逆 autofix。覆盖 wikilink 死链、frontmatter 缺字段、命名违规、目录同构、孤儿页、等级语义反写、脚本目录用途混淆等 7 类规则。默认 --fix 落盘修复;--check opt-in 仅预览。
npx skillsauth add lazygophers/ccplugin cortex-lintInstall 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.
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-extracttools
--- 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 内部) 互补.