CC-Skill

个人 Claude Code skill 集合，打包成 plugin，方便在新机器上一次装齐。

目前包含两个 sub skill：Notion 写作约定（标题、图标、层级、安全编辑、Markdown 陷阱）和 nvim 快捷键记忆卡（从本机实际配置查证作答，按类别累积到 Notion）。

---

新机快速安装

/plugin marketplace add ZhenyuZhang-sys/CC-Skill
/plugin install cc-skill@cc-skill-marketplace
/reload-plugins

如果要用 Notion 相关功能，还得装官方 plugin —— 它提供 Notion MCP server 连接，没有它 Claude 连不上 Notion：

/plugin marketplace add makenotion/claude-code-notion-plugin
/plugin install notion-workspace-plugin@notion-plugin-marketplace
/reload-plugins

首次使用时 Notion MCP 会走一次 OAuth 授权，按提示在浏览器点同意即可。

清理重复副本

如果之前手动往 ~/.claude/skills/ 放过同名 skill，装完 plugin 后要删掉，否则同一个 skill 会加载两遍：

rm -rf ~/.claude/skills/notion-pages ~/.claude/skills/nvim-cheatsheet

验证

/plugin

应该能看到 cc-skill 是 enabled。

---

已有 sub skill

Skill	覆盖内容
notion-pages	Notion 页面的标题、图标、层级与链接、安全编辑命令、Notion-flavored Markdown 陷阱、技术笔记格式、中英文混排
nvim-cheatsheet	LazyVim 快捷键从本机安装查证作答，按 leader 前缀分类累积到 Notion「Nvim 速查表」，每条拆开讲字母含义帮助记忆

---

架构：为什么是 plugin 而不是"父 skill"

Claude Code 没有"父 skill / 子 skill"的层级机制 —— skill 是扁平的，每个就是一个 SKILL.md。

真正能当"总容器"的是 plugin：一个 plugin 可以打包任意多个 skill。所以这个仓库的结构是：

cc-skill                        ← plugin（"总的"）
└── skills/
    ├── notion-pages/           ← sub skill
    │   └── SKILL.md
    └── nvim-cheatsheet/        ← sub skill
        └── SKILL.md

要加新 skill（不限于 Notion —— nvim-cheatsheet 就跟 Notion 无关），在 skills/ 下新建目录放一个 SKILL.md 即可，自动成为这个 plugin 的 sub skill，记得同步更新上面的表格。

为什么不把 Notion 官方那 4 个 skill 也复制进来

官方 plugin 提供 notion-knowledge-capture、notion-research-documentation、notion-meeting-intelligence、notion-spec-to-implementation 四个流程类 skill。

不复制，而是并存 + 声明优先级，理由：

1. 复制过来就要自己跟上游同步更新
2. 两份同名 skill 会双重触发，给出矛盾指令
3. 它们和本 plugin 是互补关系，不是替代关系 —— 见下面的分工表

---

优先级（Notion 相关工作）

notion-pages 声明了最高优先级，和官方 plugin 的 skill 分工：

本 plugin 说了算（不可协商）	官方 plugin 说了算（本 plugin 没覆盖的）
页面标题 —— 短，不要冒号 + 枚举	内容类型模板（决策记录 / FAQ / how-to / 复盘）
图标 —— Notion 内置 SVG URL，不用 emoji	跨页研究与综合
页面位置、重新挂载、交叉链接的写法	会议 pre-read / agenda 结构
用哪个 update 命令才安全	spec → 任务拆解与进度跟踪
Notion-flavored Markdown 语法	hub 链接、可发现性流程
写 file:line 前必须核对源码	判断什么内容值得记录

三条规则：

1. 冲突时本 plugin 赢 —— 即使官方 skill 的示例是另一种写法
2. 本 plugin 没说的，用官方 skill
3. 先满足本 plugin 的约束，再跑官方 skill 的流程

举例：官方 knowledge-capture 说"新页面要从 hub 页链进去，别变成孤儿页" —— 照做，但链接形式按 notion-pages 第 3 节（引用用 <mention-page>，重新挂载用 notion-move-pages），标题和图标按第 1、2 节。

---

更新

改完 skills/*/SKILL.md 之后：

cd ~/CC-Skill
git add -A
git commit -m "更新说明"
git push

其它机器拉取更新：

/plugin marketplace update cc-skill-marketplace
/reload-plugins

---

本地开发

不想每次都过 GitHub 的话，直接把本地目录加成 marketplace：

/plugin marketplace add ~/CC-Skill

改完 SKILL.md 后 /reload-plugins 即可生效。

---

License

MIT