本文主要带你知道
cgzskill做了什么,对于你的 Claude Code 赋能什么技能
背景
最近我心血来潮做了一个爆款分析产品,整个开发过程中我全程使用了 cc(Claude Code 的缩写)。一开始,我就安装了一些可能用于项目开发的 skill:
一、UI/UX 设计
| 命令 | 用途 |
|---|---|
| /ui-ux-pro-max | 50+ 风格 / 161 配色 / 99 UX 规范 / 10 技术栈的 UI 智能库(含 shadcn MCP) |
二、Claude Code 系统级
| 命令 | 用途 |
|---|---|
| /claude-hud:setup / :configure | 配置状态栏 HUD |
后续,我主要基于项目自主研发了适用于项目的 cgzskill 记忆体系。这套体系在最初设计时就考虑到了上下文缺失的风险,并且显著加快了项目进度。可以说,这套自研 skill 是整个项目的核心,几乎贯穿了项目的每一个环节。
下面,我将详细介绍 cgzskill 的功能及其应用, 还有一些管理知识库的拓展方向。
三、cgzskill
3.1 什么是 cgzskill
cgzskill是我在 GitHub 上开源的 Skill 集合(仓库地址:cgzskill),基于 Agent Skills 规范 的 Claude Code marketplace ------ 我自己反复打磨的工作流 skill 集合,每个 skill 作为一个独立可安装的 plugin 列在 marketplace 下。
3.2 为什么有这个仓库
- 整理我反复用的 skill,共享出来给同样工作流场景的人用
- 用 marketplace 形式分发,用户挑自己要的装,不用整包 clone
- 每个 skill 都来自自己的真实使用需求,先解决我自己反复遇到的问题,再整理成可复用的开源版本
3.3 核心 Skill 模块
| skill 名称 | 功能描述 | 自动触发 | 显示触发 |
|---|---|---|---|
cgz-focused-discussion |
对话纪律 ------ 强制 Claude 单线收敛,禁止一问就甩 ABCD、禁止推理外放、禁止主动塞工时优先级。专治"一对话就跑偏"。 | 用户讨论 PR / 产品 / 架构 / UX 时;或说「跑偏了」「聚焦」「先停一下」「先看反馈」 | /cgz-focused-discussion |
cgz-archive-session |
会话归档 ------ 对话变长、主题变多、工作完成或准备交接时,把上下文写进项目 docs,禁止新增分析。 | 用户说「归档」「收尾」「先到这」「交接」;或 agent 自检发现上下文过长 / 分支过多时主动建议归档 | /cgz-archive-session |
cgz-focused-reading |
专注阅读 ------ 看文档、源码、PR、日志、网页、图文和长上下文时只回答当前问题,禁止扩题。 | 用户说「读一下」「看看文档」「理解上下文」「看这个 PR / 日志 / 图文」 | /cgz-focused-reading |
cgz-init |
启动检测 ------ 在新项目里扫描 AGENTS.md / docs/ai-lessons.md / docs/archives/ 是否就位,缺失则询问后生成;同时询问并写入 obsidian_vault 配置供 cgz-daily-recap 使用。一次性操作。 |
用户说「初始化 cgz」「启动 cgz」「让 AI 学这套」;或在新项目首次调用其他 cgz skill 但缺记忆架构时主动建议 | /cgz-init |
cgz-daily-recap |
每日复盘 ------ 按天聚合当日 docs/archives/ / docs/ai-lessons.md / 会话上下文,写一份 Obsidian 友好的 Daily/YYYY-MM-DD.md(YAML frontmatter + [[wikilinks]])到 obsidian_vault。 |
用户说「今天复盘」「收尾今天」「daily recap」「日报」;或当天首次启动检测到昨天有未复盘归档时主动建议 | /cgz-daily-recap |
每个 skill 的
references/都遵循同一份五大节骨架:五原则 / 五维度 / 五心理学 / 对话严苛规则 / 语言纯化规则。
3.4 Claude Code:三种姿势
A. Marketplace 安装(推荐)
bash
/plugin marketplace add sakanaovo/cgzskill
/plugin install cgz-all@cgzskill
只想装单个 skill 时,把 cgz-all 换成对应 plugin 名,例如:
bash
/plugin install cgz-focused-discussion@cgzskill
B. 本地 plugin-dir 调试(开发模式)
bash
git clone https://github.com/sakanaovo/cgzskill.git
claude --plugin-dir ./cgzskill
C. 退化到 standalone skill(不用 plugin / marketplace)
bash
cp -r skills/<skill-name> ~/.claude/skills/ # 或项目内的 .claude/skills/
3.5 🚀 总结
🔹 上下文记忆体系
解决了长对话/开发循环中上下文丢失的问题,自动保留关键流程节点与用户意图。
🔹 流程驱动 Skill 模块
每个 skill 都代表一类任务:
例如规范总结、自动提示模板、结构化生成、复用场景执行等。
🔹 易于集成与复用
- 可作为
skill安装到Claude Code的目录; - 可按项目/场景拆分、组合、扩展;
四、拓展:与 Obsidian 搭建个人知识库
4.1 什么是 Obsidian
Obsidian 是一个基于 Markdown 的本地笔记管理工具,特点包括:
- 本地存储:所有笔记保存在本地文件夹,无需云端依赖
- 双向链接:支持笔记间互相关联,便于构建知识网络
- 插件丰富:支持 Dataview、Templates、Calendar 等插件,扩展功能强大
- 可视化网络图:通过 Graph View 展示笔记之间的关系
Obsidian 不仅是笔记工具,更是个人知识库和长期工作流管理的利器。
4.2 为什么考虑结合 cgzskill
虽然目前我们还没有实现自动导出功能,但 思路是可行的:
cgzskill生成的内容(如复盘记录、模板、对话摘要)可以整理成 Markdown 文件- 通过 Obsidian,笔记可以按项目/主题分类,并利用双向链接和标签形成知识网络
- 可以作为长期知识积累与复用的平台,把项目经验沉淀下来
⚠️ 注意:目前仓库并未提供自动导出 Markdown 的功能,需要手动整理或者二次开发实现,后续我开发了这一块,到时候输出一篇文章
五、说在结尾的话
每次写完内容,我通常会发呆一会儿,想一些事情,大大小小,既有担忧,又有感概。这篇文章应该发在2个平台,一个是我之前经常输出内容的,一个是抖音。
说来也巧,之前抖音评论了一个我后续应该要开源我的skill, 没想到这么多人蹲,看来大家对知识还是充满了热情。
抖音熟悉我的朋友都知道,之前做的是摄影赛道相关,今天莫名其妙输出了这一篇,所以有些懵。
掘金平台的粉丝,因为之前输出的都是技术相关的文章,这边的兄弟习以为常了。
但是我不是想说,2个平台有什么区别,只是想说一些此时此刻写到这里的心里话,不是水文字,如果是水文字,肯定不是像这样水。
聊一些其他话题,很多朋友其实都没有用上过我说的这些,但是你也不需要焦虑,担心害怕取代你什么的,反而你应该去学习掌控他。不管你是用codex、claude code等等这些。
就像我输出这个skill,可能你对于自己的知识库没什么概念。我想问一下,你有没有停下来思考过,你今天看这个知识视频,明天看那篇知识文章,点了一个收藏和喜欢,觉得就是哪天再回来看,后续多了你也是在收藏里面慢慢翻,你记不住关键词,又变回了去搜索。但是你找不到当初想要的那篇。
但是,此时你有一个知识库,你用AI赋能,总结关键词,后续你的知识库,就是你的个人财产,不管AI如何进化,只要他看了你的知识库,知道你的脾性,知道你聊天的习惯,知道你正在学习的内容。他就永远是一个懂你为你服务的智能体。