Claude Code Skill · cc-pkm

让笔记可检索、可连接、可输出

cc-pkm 按 WIKI.md 与各目录 SCHEMA.md 路由四类场景：Init 初始化、Raw 归档、Save 落盘、Output 发布。raw → wiki → output，完整的 AI 知识管理工作流。

浏览文章
目录结构
4
核心场景路由
3
知识层级目录
2
输出格式 md / html

路由

四大场景

说出关键词，技能自动识别意图并执行对应流程

01 Init · 工作区初始化

在目标目录按模版建立 WIKI.md、raw/、output/、wiki/、daily/ 等完整 PKM 结构。通过 wiki-init.py 检测差异、处理冲突、一键 apply。
触发：初始化 · pkm · setup 知识库

02 Raw · 素材归档

将 URL、图片、本地文件或粘贴正文归档到 raw/ 目录。支持增量追踪避免重复处理，按 Obsidian Flavored Markdown 规范写入。
触发：raw · 摄入 · 归档 · 抓取网页

03 Save · 对话落盘

把当前对话提炼为结构化笔记：归纳话题与结论，必要时联网补充，默认写入 raw/。含 frontmatter（title、tags、created、source）。
触发：save · 保存笔记 · 落盘

04 Output · 内容发布

生成对外发布的 Astro 文章（md）或 HTML 介绍页。读取 output/_template/ 模版，写入站点对应目录，由 cc-astro 负责构建与部署。
触发：output · 生成页面 · 深度介绍页

概述

cc-pkm 是什么

Claude Code 中的 PKM 知识管理技能，负责路由而非重复定义规则

cc-pkm 不自行发明目录规则，而是以项目内的 WIKI.md 与各目录 SCHEMA.md 为准绳，将用户意图路由到 init、raw、save、output 四条流水线。站点工程（初始化 Astro、本地预览、Cloudflare 部署）则交给姊妹技能 cc-astro 处理。

核心原则：目录含义以 SCHEMA 为准；流程细节见 reference 文档；目标目录未初始化时，先走 init 流程。

结构

cc-pkm 支持的目录结构

Init 模版写入的标准工作区；每个目录自带 SCHEMA.md 定义读写规则

工作区根目录Init 模版一键写入WIKI.md工作区入口 · cc-pkm 路由中枢_meta/cache · log · 增量追踪raw/原始素材 · AI 只增不改wiki/LLM 结构化知识daily/cc-loop 定时输出output/对外发布内容code/ · product/ · other/SCHEMA.md + _template/_template/{分类}.mdYYYY-MM-DD/按日期归档_template/md.md · html.md生成规则清单site/astro/Astro 静态站点 · cc-astro 负责工程post/*.md博客文章html/*.html深度介绍页Raw / Save → Wiki 结构化Output 发布 → Astro 站点图例摄入层 raw/知识层 wiki/发布层 output/模版文件WIKI.md知识流转各目录含 SCHEMA.md 定义读写规则 · Init 模版写入 · cc-pkm 路由 · cc-astro 构建部署

Init 建立骨架 → Raw/Save 写入素材 → Wiki 结构化 → Output 按模版生成 → cc-astro 构建上线

路径作用谁维护
WIKI.md工作区总览；cc-pkm 据此识别目录含义与路由场景Init 写入，用户可读
_meta/cache.md 记录已处理素材，log.md 记录操作日志，避免重复归档AI 自动更新
raw/SCHEMA.md规定素材分类、frontmatter、只增不改；指向 raw/_template/Init 写入
raw/_template/按 code / product / other 等分类的归档生成规则Init 写入
wiki/SCHEMA.md结构化知识页的加工流程与保存规则Init 写入
daily/SCHEMA.md定时任务产出按 YYYY-MM-DD/ 日期目录归档Init 写入 · cc-loop 调度
output/SCHEMA.md发布路径、格式选择、禁止改站点工程；指向 output/_template/Init 写入
output/_template/md.md / html.md 内容生成清单（技能链、meta、封面图等）Init 写入
output/site/astro/Astro 站点；cc-pkm 只写 post/ 与 html/ 内容，工程走 cc-astro内容 AI · 工程 cc-astro

规则

SCHEMA.md 与模版做什么

两层规则：SCHEMA 定「在哪写、怎么约束」；模版定「写什么、按什么步骤生成」

S

SCHEMA.md — 目录契约

每个目录下的 SCHEMA.md 是 AI 的「读写边界」： 约定该目录存什么、禁止什么、文件落在哪里、frontmatter 长什么样。 cc-pkm 进入任一场景时必须先读对应 SCHEMA，再执行 init / raw / save / output。

  • →raw/SCHEMA.md：素材只增不改，必须进分类子目录
  • →output/SCHEMA.md：只写内容页，不得改 Astro 组件与配置
  • →路径表：md → src/data/post/，html → src/content/html/

效果：无论换哪次对话、哪个 AI，目录语义一致，不会乱写文件或覆盖站点工程。

T

_template/ — 生成清单

模版不是示例文案，而是待执行的生成规则。 以 [ ] 勾选项列出必须完成的步骤； AI 须逐项执行后再落盘。

  • →raw/_template/code.md：归档代码类素材的 frontmatter 与结构
  • →output/_template/md.md：cc-deep-intro + 封面图 + YAML frontmatter
  • →output/_template/html.md：cc-deep-intro + design-taste 美化 + head meta

效果：同类型内容产出形态统一——列表有封面、SEO 字段齐全、HTML 介绍页视觉一致。

用户意图「归档 / 发布」cc-pkm读 SCHEMA.mdSCHEMA.md路径 · 约束 · 格式_template/*.md[ ] 生成清单落盘文件结构一致

示范

本站即 cc-pkm 的产出示范

你正在阅读的页面，以及站点上的每一篇文章，都由这套技能链生成

本 Astro 站点的内容层（博客文章、HTML 介绍页、本 About 页说明）均通过 cc-pkm 的 Output 流程产出： 读取 output/SCHEMA.md 确定路径与约束， 再按 output/_template/ 清单调用 cc-deep-intro、design-taste-frontend 等姊妹技能生成。 站点工程（主题、组件、部署）由 cc-astro 维护，与内容生成分工明确。

2

src/data/post/*.md

Markdown 博客文章

6

src/content/html/*.html

深度介绍 HTML 页

1

about.astro

本页 · cc-pkm 工作流说明

本站内容示例格式生成路径
contextual-retrieval-introhtmloutput/_template/html.md
claude-tap · ego-lite-deep-dive 等htmlcc-deep-intro + design-taste 美化
ego-lite-ai-agent-browsermdoutput/_template/md.md
welcome · 本 About 页astro 组件用户明确要求更新站点说明页

流程

端到端工作流

从空白目录到可访问网站的完整路径

01 Initwiki-init.py建立目录结构02 RawURL / 文件 / 图片归档到 raw/03 WikiLLM 结构化实体页 / 交叉引用04 Outputmd / htmlAstro 内容05 Deploycc-astroCloudflare PagesSave 对话落盘 / 查询结果归档回 wiki用户输入：URL / 对话 / 文件 / 「生成介绍页」

Init 建结构 → Raw 摄入 → Wiki 结构化 → Output 发布 → Deploy 上线

raw/article.md

Raw Layer

原始剪藏 · AI 不可修改

wiki/entity.md

Wiki Layer

结构化知识 · LLM 维护

output/site/astro

Output Layer

对外发布 · Astro 静态站点

流转

知识流转关系

WIKI.md 居中调度，素材经 raw → wiki → output 层层提炼

WIKI.md路由中枢raw/原始素材AI 不可修改wiki/结构化知识output/对外发布daily/定时任务 · cc-loopcc-pkm + cc-astro + cc-deep-intro + cc-loop

完整目录树与各文件职责见上方 目录结构 一节。

效果

使用 cc-pkm 前后对比

从散乱笔记到可发布知识资产

未使用 cc-pkm

  • ✗剪藏堆在浏览器书签，找不到也联不起来
  • ✗对话结论散落在聊天记录，无法检索
  • ✗笔记格式不统一，Obsidian 与网站各写各的
  • ✗发布网站需要手动复制粘贴、改格式
  • ✗目录结构每人不同，AI 无法稳定路由

使用 cc-pkm 后

  • ✓URL/文件一键归档到 raw/，增量追踪防重复
  • ✓对话 say「save」自动落盘为结构化笔记
  • ✓SCHEMA.md 统一约定，AI 按规则读写
  • ✓say「生成介绍页」自动产出美化 HTML 文章
  • ✓Init 脚本一键建立标准 PKM 工作区

关注 cc-pkm 即将发布的版本

cc-pkm 仍在持续演进——新技能链、模版规范与站点能力会陆续上线。感兴趣的话留下邮箱，版本发布时我们会通知你。

提交即表示你同意我们的 隐私政策。

发布

Output 发布流程

从用户意图到可访问网页的四步流水线

1

确定格式

md 或 html，默认 md

2

读取模版

output/_template/

3

生成内容

cc-deep-intro + 美化

4

写入站点

post/ 或 html/

格式写入路径访问 URL适用场景
mdsrc/data/post//blog/{slug}博客文章、可继续编辑
htmlsrc/content/html//blog/{slug}深度介绍页、SVG 可视化
# 本地预览
cd output/site/astro && npm run dev

# 构建静态站点
npm run build

# 部署到 Cloudflare Pages
wrangler pages deploy dist
用户意图「做介绍页」cc-pkm读 SCHEMAcc-deep-intro调研 + SVGdesign-taste美化 HTMLcc-astrobuild + deployLive

协作

技能协作矩阵

cc-pkm 是指挥中枢，专业任务交给姊妹技能

技能职责触发场景
cc-pkm路由四类场景，读取 SCHEMA，协调流程初始化、归档、落盘、发布
cc-astroAstro 站点初始化、本地 dev、Cloudflare 部署astro、wrangler、部署、预览
cc-deep-intro深度调研 + 图文并茂介绍（SVG、评分）介绍页、深度文章、展示页
cc-loop注册定时任务，扫描 _cron/*.md 调度 Claude定时任务、daily 目录
design-taste-frontendAnti-slop 前端美化，editorial 风格HTML 介绍页视觉优化