zhaoJian's Tech Notes

canon (Claude Code Standards Plugin Marketplace)

GitHub

Claude Code 插件市场。canon：skill 强制 Vue 3.5 / Nuxt UI v4 / Tailwind v4 / TypeScript / Echo / Fastify / PostgreSQL / Astro 官方最新写法，禁废弃语法；canon-chinese：平实中文 output style，禁互联网黑话与 AI 腔。

Help & Support: This project is fully open source and free. You can download and deploy it yourself. For custom development or professional technical support, feel free to contact me.

canon

让 Claude Code 守规范。两个 plugin：canon 管代码写法，强制跟框架官方最新做法走；canon-chinese 管中文表达，强制说平实大白话、严禁互联网黑话和 AI 腔。

Languages: 简体中文 · 繁體中文 · English · 日本語

维护：zhaoJian · 仓库：https://github.com/zhaojiannet/canon

这是什么

一个 Claude Code 插件市场，名字叫 canon（取 canonical，"按正典/规范做法来"）。下面两个独立 plugin，可以各装各的：

Plugin 管什么 怎么生效
canon 代码写法：10 个框架 skill，强制 Vue 3.5 / Nuxt UI v4 / Tailwind v4 / TypeScript / Go Echo v5 + sqlc / Node Fastify v5 / PostgreSQL / Astro 用各自官方最新稳定版的推荐做法，禁用已废弃写法；另含 go/cm 两个手动工作流命令 框架 skill 编辑对应文件时按 paths 自动激活；go/cm 手动调用 /canon:go、/canon:cm
canon-chinese 中文表达：强制平实中文，禁互联网黑话、职场黑话和 AI 腔，保留真正的专业术语 一个 output-style，启用后一直生效

两者是同一种事——给 Claude 立规矩、不让它将就。一个清理代码里的废弃写法，一个清理中文里的黑话。

canon（代码规范）

解决什么问题

写代码反复遇到这种情形：Tailwind、Nuxt UI、Vue、TypeScript、Echo、Fastify、PostgreSQL 官方明明给了最直接的写法，AI 在长会话之后转头就忘，自己造 CSS、绕过官方 API、写上一代旧语法。每次发现都得手动纠正一遍。CLAUDE.md、全局 memory 这种软约束在长会话后压不住。

canon 用 Claude Code 官方的 skill 机制 解决：每个 skill 是一份 markdown 规则文档，按文件类型 paths 自动激活——编辑 .vue 时 Vue / Nuxt UI 规则进 context，编辑 .css 时 Tailwind 规则进 context，编辑 .go 时 Echo / sqlc 规则进 context，编辑 migrations/*.sql 时 PostgreSQL 迁移安全规则进 context。规则现读现用，不会像 CLAUDE.md 在长会话后被淡忘。

安装

# 1. 注册 marketplace
/plugin marketplace add zhaojiannet/canon

# 2. 装代码规范 plugin（含全部 10 个框架 skill + go/cm 工作流命令）
/plugin install canon@canon

# 3. 重新加载使其生效
/reload-plugins

验证：输入 /plugin 进 Installed 标签，能看到 canon。再用 What skills are available? 让 Claude 列出 skill。

包含的 skill

Skill 触发 paths 功能 手动调用
vue **/*.vue Vue 3.5+ SFC：强制 <script setup> + 类型化 defineProps/defineEmits + defineModel + useTemplateRef；禁 Options API / mixins /canon:vue
nuxt-ui **/*.vue 强制用 Nuxt UI v4 组件（U 前缀）而非手写 raw <button> / <input> / <dialog> /canon:nuxt-ui
tailwind .vue/.html/.tsx/.css/.scss Tailwind v4 utility-first：禁 <style scoped> / 旧 utility / 任意值变量；强制 oklch() / (--xxx) 圆括号 / @custom-variant dark /canon:tailwind
typescript **/*.ts, .tsx TypeScript strict：禁 any / @ts-ignore / namespace / 非 const enum；强制 strict tsconfig + unknown 替代 any /canon:typescript
echo **/*.go Echo v5 错误处理：error 冒泡、echo.NewHTTPError 统一错误、集中 HTTPErrorHandler、errors.Is/errors.As、%w wrap /canon:echo
sqlc **/queries/*.sql, sqlc.yaml sqlc v2 + pgx/v5 + 命名规范 + 禁手写 SQL 调用 /canon:sqlc
fastify 含 fastify import 的 .ts/.js Fastify v5 plugin async 写法、fastify-plugin (fp) 何时用、JSON schema 验证、encapsulation、graceful onClose /canon:fastify
pg-schema **/migrations/*.sql, **/schema/*.sql snake_case + BIGSERIAL/UUID 主键 + timestamptz + 外键 ON DELETE 显式 + jsonb 仅用于 schemaless /canon:pg-schema
pg-migrate **/migrations/*.sql 事务包裹 + IF EXISTS 守卫 + 禁裸 DROP/TRUNCATE + NOT NULL 加列分三步 + CREATE INDEX CONCURRENTLY /canon:pg-migrate
astro **/*.astro Astro 静态优先：默认 zero JS、client:visible/client:idle 优于 client:load、server:defer 替代全页 SSR、Content Collections 替代 Astro.glob /canon:astro

激活方式：

  • 自动：编辑匹配 paths 的文件时 Claude Code 自动加载对应 skill 进 context
  • 手动：/canon:<skill-name>，例如 /canon:echo

工作流命令（手动触发）

除了上面 10 个按文件类型自动激活的框架 skill，canon 还含两个手动触发的工作流命令。它们设了 disable-model-invocation: true：只在你输入 / 时手动调用，Claude 不会自动触发，description 也不进 context、只当 / 菜单里的标签。

命令 做什么 调用
go 一套贯穿任务的工作纪律：开始干活先查官方最新文档再动手、选最佳方案不选临时做法；遇到问题不糊弄、不绕过；做错时诚实承认；有遗留时如实交代、不谎报完成 /canon:go
cm 把当前改动分批分类提交：按主题分组、一个 commit 只做一件事，commit message 按规范写，提交前列给你确认，未经同意不 push /canon:cm

这两个是作者的个人工作流命令。go 是通用纪律，谁装都能用；cm 的 commit message 格式引用作者全局 ~/.claude/CLAUDE.md 里的规范，你可以换成自己的提交规范。

canon-chinese（朴素中文）

做什么

强制 Claude Code 用平实中文，禁互联网黑话与职场黑话（根因、二开、兜底、对齐、抓手、闭环、赋能、沉淀、链路、落地……），同时保留真正的专业术语（解耦、幂等、并发、复用……），不矫枉过正。还专门管 AI 自造腔和口癖（底层逻辑、本质上、"不是 X 而是 Y"拉踩句式、"综上所述"总结腔……）。

核心是一个 output-style。output-style 直接改 Claude Code 的系统提示词，比 CLAUDE.md（用户消息层）约束力更强，是目前唯一能稳定影响 Claude 措辞的官方手段。

需要说清楚：没有任何方法能 100% 杜绝。模型是概率生成文本，提示词约束是"强烈倾向"而非硬过滤。这个 plugin 用的是约束力最强的软办法，能让这类词几乎绝迹，但偶尔仍可能漏一两个。

安装

# marketplace 已注册的话跳过这步
/plugin marketplace add zhaojiannet/canon

# 装朴素中文 plugin
/plugin install canon-chinese@canon
/reload-plugins

启用

这个 plugin 的 output-style 设了 force-for-plugin: true，装完启用就自动生效，不用手动选。它会覆盖你当前的 output-style 设置。

output-style 是系统提示的一部分，Claude Code 每次会话开始时读一次。改完要 /clear 或开新会话才生效。

想临时关掉：在 /plugin 里禁用 canon-chinese。想自己手动管理 output-style（而不是自动强制）：把 plugins/chinese/output-styles/plain-chinese.md 里的 force-for-plugin: true 删掉，改用 /config → Output style 手动选。

注意：旧的 /output-style 命令在 Claude Code v2.1.73 弃用、v2.1.91 移除，现在统一用 /config。

从旧版（lockstep-run）迁移

这个 repo 之前叫 claude-skills、marketplace 叫 lockstep-run。升级到 canon：

# 1. 卸载旧 plugin
/plugin uninstall lockstep-run@lockstep-run

# 2. 移除旧 marketplace
/plugin marketplace remove lockstep-run

# 3. 注册新 marketplace 并安装
/plugin marketplace add zhaojiannet/canon
/plugin install canon@canon
/plugin install canon-chinese@canon
/reload-plugins

skill 调用名也变短了：/lockstep-run:tailwind-utility-first → /canon:tailwind。

How it works

canon 的每个 skill 是一份 markdown 规则文档，包含：核心原则、禁用项 + 简短原因、旧 API → 新 API 对照表、表达不出来时报告而非绕过的 STOP 信号、场景化规则、写完自查的 grep 清单。Claude Code 在编辑匹配 paths 的文件时把对应 SKILL.md 载入 context，按需加载而非长期占用。

canon-chinese 的 output-style 把禁用词对照表、AI 口癖清单、专业术语白名单、自检清单加进系统提示，每轮回复都生效。

Development

本地加载（开发/调试用，不需安装）：

cd <你的项目>
claude --plugin-dir ~/Cores/Projects/canon/plugins/code \
       --plugin-dir ~/Cores/Projects/canon/plugins/chinese

改完 SKILL.md 或 output-style 后，在已运行的 Claude Code 内执行 /reload-plugins 生效。校验结构：claude plugin validate .。

官方参考：Skills / Plugins / Plugin Marketplaces / Output styles。

名字由来

canon 取自 canonical——"按正典、规范的做法来"。两个 plugin 是一回事：代码按官方规范写，中文按平实规范说。

这个项目前身代号 lockstep（"齐步走"）。改名时想起我的好兄弟薛贵文（跑哥）。大学军训，教官一脸严肃让他带全系喊口号，他连续 N 次把"齐步走"喊成"齐步跑"，从此成为传说中的跑哥。

License

MIT

Back to Home