kaba-skills
一个面向 Claude Code 的个人技能集合仓库，当前主要围绕 raw -> wiki 的知识整理工作流构建，适合把网页、论文、仓库文档、播客转录、截图文字等原始资料整理为可沉淀到个人知识库中的 Markdown 内容。
仓库定位
- 这是一个 Claude Code skills/plugin collection，不是常规应用项目。
- 技能入口由
.claude-plugin/plugin.json 定义，技能根目录是 ./skills。
.claude-plugin/marketplace.json 提供插件市场元数据。- 仓库几乎没有共享运行时代码；每个技能都以
skills/<skill-name>/SKILL.md 的形式独立定义。
- 当前技能说明以中文为主，面向中文知识整理场景。
当前包含的技能
/wiki-workflow
一个面向多 source 的工作流技能，用于把多个原始信息源串成统一入库流程。
特点：
- 为多个 source 启动多个 subagent 并行 ingest
- 在 ingest 完成后把全部
raw/... 路径一次性传给 wiki-digest 做一轮批量 digest
- 在 digest 后统一运行 lint 审计
- 把“是否修复 lint 问题”的决定交给用户
/raw-ingest
将原始资料高保真清洗后整理为适合保存到 raw/ 的 Markdown。
适用输入：
- 网页
- 论文
- 仓库文档
- 播客转录
- 截图文字
- 手动剪藏内容
特点：
- 重点是“保真摄取”，不是泛化总结
- 清洗广告、导航、页眉页脚等噪音，但尽量保留正文信息密度
- 按“内容主题”组织目标路径，而不是按媒体形式分类
/wiki-digest
将 raw/ 中的原始资料消化为 wiki/ 中可链接、可复用的原子化知识笔记。
特点：
- 遵循 Atomic Notes 思路拆分知识单元
- 将
raw/ 视为只读事实来源
- 在
wiki/ 中创建或更新页面
- 同步更新
wiki/index.md 与 wiki/log.md
/wiki-lint
对 wiki/ 做健康检查，发现结构性问题并输出建议清单。
重点检查：
- 页面间明显矛盾
- 明显过时的内容
- 孤立页面
- 被频繁提及但缺少独立页的概念
- 严重缺失 cross-ref 的地方
默认行为是先报告建议，再等待用户确认，而不是直接做大规模修改。
整体工作流
现在有两种使用方式：
手动串行使用
/raw-ingest：接收并清洗原始资料，沉淀到 raw//wiki-digest：把 raw/ 内容拆成 wiki/ 中的原子知识页/wiki-lint：检查 wiki/ 的结构质量、矛盾和缺失链接
用 /wiki-workflow 统一编排
- 接收一个或多个 source
- 为每个 source 并行执行 ingest
- 将成功产出的全部
raw/... 一次性传给 wiki-digest 执行一轮 digest
- 对更新后的
wiki/ 运行 lint 审计
- 由用户决定是否继续执行 lint 修复
如果你把这个仓库理解成一个系统，它的核心不是“模块调用关系”，而是“技能提示词驱动的知识加工流水线”。
仓库结构
.claude-plugin/ Claude 插件与市场元数据
scripts/ 维护脚本
skills/ 技能定义目录
wiki-workflow/
SKILL.md
raw-ingest/
SKILL.md
wiki-digest/
SKILL.md
wiki-lint/
SKILL.md
开发与维护
当前仓库没有现成的：
- build 命令
- lint 命令
- test 命令
- 单测入口
也就是说，这个仓库目前不是通过自动化构建/测试来验证，而是通过检查技能 frontmatter、提示词逻辑以及跨技能约定是否一致来维护。
同步并发布某个技能
仓库中现有的维护脚本：
bash scripts/sync-push.sh <skill-name> "<commit message>"
这个脚本会：
- 从本地
~/.claude/skills/<skill-name>/ 同步内容到仓库镜像中的 skills/<skill-name>/
- 自动递增
.claude-plugin/plugin.json 和 .claude-plugin/marketplace.json 的补丁版本号
- 提交并推送变更
脚本依赖：
并假定以下路径已存在：
~/.claude/skills/<skill-name>~/.claude/kaba-skills-repo
维护时需要注意
- 修改技能时，frontmatter 与正文提示词要保持一致。
- 如果改动了插件元数据版本，需要同时更新：
.claude-plugin/plugin.json.claude-plugin/marketplace.json
- 跨技能的一致性主要体现在这些共享约定上：
raw/wiki/wiki/index.mdwiki/log.md
许可证
MIT
sickn33
obra
affaan-m
wshobson
xhyqaq