kj-skills

Claude / Cursor Agent Skills 集合：AI 编程内容创作全链路、个人 Wiki 沉淀、AI 日报、周报、Git 提交推送。目录结构参考 addyosmani/agent-skills。

包含的 Skills

| 目录 | 说明 | |------|------| | skills/ai-programming-topic-planner | AI 编程内容选题策略：输入动态/痛点/想法，输出 3-5 个内容角度 + 推荐工作流 | | skills/coding-session-to-tutorial | 实战记录转教程：原始命令/报错/过程 → 结构化 AI 编程教程初稿 | | skills/course-generator | 单章节课程正文生成：章节大纲 + 参考材料 → 可直接发布的课程正文（口语化、工程视角、无 AI 味）；写完后自动为 [流程图]/[对比图] 生成 SVG 插图 | | skills/course-campaign | 批量章节编排（工头）：按清单逐章调用 course-generator，负责顺序管理、上下文衔接、进度持久化、里程碑 compact、收尾图片规范化审计 | | skills/content-illustrator | 内容插图工具（三模式）：① 文字描述 → SVG；② 分析文章识别「看图比看字快」的位置并自动生成插图；③ 批量补全课程文件中的 [流程图]/[对比图] 占位符 | | skills/course-scraper | 课程抓取 & 双语翻译：登录在线课程平台，抓取所有课时存为 Markdown，翻译成中英对照格式 | | skills/content-creator | 长文 / 短视频 / 小红书等工作流（含 A/B/C/D/E/F 六条分支） | | skills/kangjian-skill | 以康健本人风格创作公众号文章 / 短视频口播 / AI 编程教程 / 演讲稿（去 AI 味门禁） | | skills/web-slide | 生成可交互单文件 HTML 演讲稿：键盘翻页、演讲者备注、全局索引、代码高亮、PDF 导出 | | skills/ai-daily-from-x | 每日 AI 情报日报（X 账号采集 + 评分 rubric） | | skills/ai-daily-websearch | 每日 AI 前沿日报（WebSearch 采集 + P0/P1/P2 分级 + 网站自动发布） | | skills/weekly-report | AI 编程周报多格式输出 | | skills/wiki-doc-sink | 讨论沉淀到个人 Wiki（含 references/ 路由说明，需配置 <WIKI_ROOT>） | | skills/markdown-format | Pandoc/Word 稿 Markdown 格式化（Obsidian 表格、代码块、标题） | | skills/git-push | 一键 add / 生成 commit / push（Conventional Commits + 安全约束） | | skills/wiki-intelligence | Claude Code hook 系统：提示词质量评分、好提示词自动收藏、对话价值分析与知识沉淀引导（详见 docs/wiki-intelligence.md） |

Skills 协作关系

各 skill 不是孤立的，围绕「AI 编程内容稳定输出」形成两条主流水线。

主流水线 A：动态/想法 → 发布

ai-daily-websearch / ai-daily-from-x
        ↓ 素材
ai-programming-topic-planner
        ↓ 角度 + 推荐工作流
content-creator（工作流 B/C/D/F）
        ↓ 初稿
kangjian-skill（风格润色）
        ↓
    发布（公众号 / 短视频 / 小红书）

典型场景：看到 Claude Code 更新了某功能 → 用 ai-programming-topic-planner 找「程序员最关心的切入角度」→ 用 content-creator 工作流 B 孵化成文章 → 用 kangjian-skill 去 AI 味润色 → 发布。

主流水线 B：实战记录 → 教程 → 发布

一段实战记录（命令/报错/截图/过程）
        ↓
coding-session-to-tutorial
        ↓ 结构化教程初稿
ai-programming-topic-planner（可选，用于确认角度/规划系列）
        ↓
content-creator（工作流 C 润色）
        ↓
kangjian-skill（风格门禁）
        ↓
    发布

典型场景：今天用 Cursor 解决了一个棘手问题 → 把过程记录（命令+思路+弯路）交给 coding-session-to-tutorial 生成教程初稿 → 用 content-creator 工作流 C 提升叙事质量 → 用 kangjian-skill 确保有人味 → 发布。

各 Skill 在流水线中的定位

| Skill | 定位 | 接什么 | 输出给什么 | |-------|------|--------|-----------| | ai-daily-websearch / ai-daily-from-x | 素材来源 | — | ai-programming-topic-planner | | ai-programming-topic-planner | 选题决策 | 动态/痛点/想法/实战记录 | content-creator 对应工作流 | | coding-session-to-tutorial | 结构化整理 | 原始实战记录 | content-creator 工作流 C | | course-scraper | 外部课程存档 | 在线课程 URL + 账号 | course-generator（素材）/ wiki-doc-sink（沉淀） | | course-generator | 课程章节生产 | 章节大纲 + 参考材料 | kangjian-skill / 直接发布 | | content-creator | 内容生产 | 角度/素材/初稿 | kangjian-skill | | kangjian-skill | 风格门禁 | 任意初稿 | 发布 | | web-slide | 演讲稿生成 | 主题/大纲/文档 | 独立发布（HTML） | | weekly-report | 定期汇总 | 周内动态 | 独立发布 | | wiki-doc-sink | 知识沉淀 | 讨论结论 | 个人 Wiki | | git-push | 工程辅助 | 代码变更 | 远程仓库 | | wiki-intelligence | 知识自动化 | 高价值提示词 + 对话 | wiki 知识库 |

wiki-doc-sink：配置 WIKI_ROOT（使用前必读）

wiki-doc-sink 会把讨论沉淀到你个人的 LLM Wiki 仓库，而不是当前打开项���的 docs/。skill 内用占位符 <WIKI_ROOT> 表示 Wiki 根目录——安装插件不会自动替你填路径，需要你在本机先声明一次。

前置条件

1. 已有（或新建）个人 Wiki 仓库，且根目录存在 SCHEMA.md 与 CLAUDE.md（目录规范与 Ingest 流程以这两份文件为准）。
2. 记下该仓库在本机的绝对路径，例如 /Users/you/llm-wiki。

设置方式（任选其一）

Claude Code — 全局规则（推荐）

在 ~/.claude/CLAUDE.md 中增加（路径改成你的）：

## 个人 Wiki（wiki-doc-sink）

- WIKI_ROOT: `/Users/you/llm-wiki`
- 使用 wiki-doc-sink 或「沉淀到文档」时，将 skill 中的 `<WIKI_ROOT>` 替换为上述路径。
- 写入前用 Read 核对：`<WIKI_ROOT>/SCHEMA.md`、`<WIKI_ROOT>/CLAUDE.md`。

Cursor — User Rules 或项目规则

在 Cursor Settings → Rules → User Rules，或项目 .cursor/rules/ 下新增 alwaysApply 规则，内容与上面相同，把 WIKI_ROOT 写成你的绝对路径。

Fork / 单 skill 复制 — 直接改 skill

若只在本机使用、不依赖全局规则，可编辑 skills/wiki-doc-sink/SKILL.md，将文中所有 <WIKI_ROOT> 替换为你的绝对路径（fork 后维护即可）。

使用前自检

ls /Users/you/llm-wiki/SCHEMA.md /Users/you/llm-wiki/CLAUDE.md

两条路径都能读到，再 @ wiki-doc-sink 或说「沉���到文档」。

未设置 WIKI_ROOT 时

若已 @ wiki-doc-sink 或触发「沉淀到文档」，但 Agent 不知道 Wiki 根目录：

1. 先停止写入当前项目的 docs/、README 等默认落点（除非你在同一句里明确指定「就写在本仓库某路径」）。
2. 按上一节完成 WIKI_ROOT 配置，并确认 SCHEMA.md / CLAUDE.md 可读���
3. 重新发起沉淀请求；Agent 应按 Wiki 规范写入 wiki/，且 raw/ 只读。

更完整的流程与约束见 skills/wiki-doc-sink/SKILL.md 与同目录 references/。

若你同时维护组织/公司业务 Wiki（例如信贷前端专用库），公司库路由请保留在本机 ~/.claude/rules/，本仓库 skill 仅覆盖个人 <WIKI_ROOT>。

课程图片生成协议（image-protocol）

course-generator 和 course-campaign 内置了图片生成协议，让课程图文并茂不再依赖手动截图。

工作方式

写课程正文时，在需要放图的位置用占位注释标记：

<!-- [流程图] 描述：三层 CLAUDE.md 加载顺序，从上到下依次叠加：① 用户级（浅蓝底）→ ② 项目根（浅绿底）→ ③ 子目录（浅橙底）；标注「三层叠加生效，下层可覆盖上层」 -->

course-generator 写完章节正文后（Step 3.5），自动扫描并处理：

| 占位类型 | 处理方式 | |---------|---------| | [流程图] | ✅ 自动生成 SVG，写入 assets/ | | [对比图] | ✅ 自动生成 SVG，写入 assets/ | | [截图] | 保留注释，录课时手动补 | | [录屏建议] | 保留注释，录课时执行 |

生成后，注释与图片引用并存（A 方案），描述永不丢失：

<!-- [流程图] 描述：三层 CLAUDE.md 加载顺序... -->
![CLAUDE.md 层级示意图](../../../../assets/lessons-claudecode/cc005-claudemd-hierarchy.svg)

批量写课后的图片报告（course-campaign）

course-campaign 全部章节完成后自动执行 Step E：

1. E1 规范化：将章节里 ![](*.png) 语法的截图统一替换为 <img width="620"> HTML 标签，确保 SVG 与 PNG 等宽一致
2. E2 报告：输出完成度清单，告诉你哪些截图/录屏还需要手动补充

📊 图片完成度报告
✅ SVG 已生成：14 张
🖼️ PNG 已规范化：3 处（统一为 width=620）
📷 截图待补：18 处
   - CC-007:37 — Plan Mode 界面截图
   ...
🎬 录屏待录：2 处

SVG 风格规范

生成的 SVG 遵循统一规范（详见 skills/course-generator/references/image-protocol.md）：

• 画布 620×480，字体 PingFang SC / Microsoft YaHei
• 三层配色：浅蓝（#E8F4FD）/ 浅绿（#EAF7EE）/ 浅橙（#FEF3E8）
• 每条箭头必须有文字标注，生成后用 open 本地预览验证

本地 Skills 同步（sync-claude-skills.sh）

~/.claude/skills/ 通过 symlink 指向本仓库的 skills/ 子目录。新增 skill 后需运行一次同步脚本，让全局 Claude 立即可见：

# 全量同步
npm run sync
# 或直接运行脚本
./sync-claude-skills.sh

只安装某个（或某几个）skill：

npm run sync:one:claude -- content-creator
npm run sync:one:claude -- content-creator git-push course-generator
# 或直接运行脚本
./sync-claude-skills.sh content-creator git-push

脚本会自动扫描 skills/ 下所有目录与 .skill 文件，对缺失的 symlink 进行补建，已存在的跳过不动。

修改已有 skill 内容无需运行脚本，symlink 实时生效。只有新增 skill 目录时才需要执行一次。

新增 skill 时，请同步更新本 README 的「包含的 Skills」清单；若会影响协作流程、安装方式或命令帮助，也要同步更新「Skills 协作关系」、安装说明和 .claude/commands/kj-help.md 等相关文档。贡献前可对照 CONTRIBUTING.md 的新增 skill 检查项。

Codex：本地 Skills 注册

Codex 用户级 skills 默认位于 ~/.codex/skills/（若设置了 CODEX_HOME，则为 $CODEX_HOME/skills/）。运行脚本可把本仓库 skills/ 下的目录或 .skill 文件软链过去：

./sync-codex-skills.sh

只注册某几个 skill：

./sync-codex-skills.sh content-creator git-push

脚本会自动创建目标目录，并跳过已存在的同名条目。注册新 skill 后，重启 Codex 或开启新会话让技能列表重新加载。

Claude Code：Marketplace 安装（推荐）

将下列 chengkj99/kj-skills 换成你 fork 后的 owner/repo，并同步修改 .claude-plugin/marketplace.json 里 plugins[0].source.repo（否则 marketplace 仍指向原仓库）：

/plugin marketplace add chengkj99/kj-skills
/plugin install kj-skills@kj-agent-skills

若 marketplace 克隆走 SSH 报错，可改用 HTTPS 添加源：

/plugin marketplace add https://github.com/chengkj99/kj-skills.git
/plugin install kj-skills@kj-agent-skills

安装后可使用插件命令 /kj-help 快速查看各 skill 路径。

Claude Code：本地克隆 + 插件目录

git clone https://github.com/chengkj99/kj-skills.git
claude --plugin-dir /path/to/kj-skills

--plugin-dir 指向仓库根目录（包含 .claude-plugin 的那一层）。

Cursor：插件安装

仓库已包含 .cursor-plugin/ 清单，支持 Cursor 插件体系（与 Claude Code 的 .claude-plugin/ 并存）。

| 场景 | 做法 | |------|------| | 本地调试 | ln -s /path/to/kj-skills ~/.cursor/plugins/local/kj-skills，重启 Cursor | | 团队分发 | Dashboard → Plugins → Team Marketplaces → Import https://github.com/chengkj99/kj-skills | | 公开发布 | 提交 Cursor Marketplace 审核后，对话中 /add-plugin kj-skills |

不要在 Cursor 里执行 /plugin marketplace add（那是 Claude Code 命令）。详见 docs/cursor-setup.md。

Codex：插件安装

仓库已包含 .codex-plugin/ 清单和 .agents/plugins/marketplace.json，支持作为 Codex 本地插件安装。

本地克隆后，在 Codex 里添加本仓库 marketplace，然后安装插件：

codex plugin marketplace add /path/to/kj-skills
codex plugin add kj-skills@kj-agent-skills

本地开发期间若修改了 .codex-plugin/plugin.json 或新增 skill，请重新执行安装命令，并开启新会话测试。只想把 skills 直接注册到用户级目录时，用上面的 ./sync-codex-skills.sh 即可。

单 skill 安装

不克隆仓库（推荐）

发布到 npm 后，任意机器一条命令搞定：

# 默认安装到 Claude Code
npx kj-skills install git-push

# 指定平台
npx kj-skills install git-push --for cursor
npx kj-skills install git-push --for codex

内部通过 degit 只下载该 skill 子目录，无需 clone 整个仓库。

已克隆仓库

只需某一目录时，按平台选一条：

| 平台 | 命令 | 目标路径 | |------|------|---------| | Claude Code | npm run sync:one:claude -- <skill-name> | ~/.claude/skills/ | | Codex | npm run sync:one:codex -- <skill-name> | ~/.codex/skills/ | | Cursor | npm run sync:one:cursor -- <skill-name> | ~/.cursor/skills/ |

许可证

MIT，见 LICENSE。