SuperAPI AI 工具集

knowhow-capture

写作与研究

查看项目

更新于 10-15 22:13

技能介绍

用途:从当前对话、外部文件或 reflect 环节采集 knowhow,统一记录到知识库 inbox,不直接写入 wiki、skills、workflows。

前置条件:当前工作区需存在 .knowhow/ 目录,可用 ls -d .knowhow/ 2>/dev/null 检查;不存在则需先运行 knowhow-init。

采集模式:默认从当前对话历史扫描;也可读取用户提供的外部文件,文件超过约500行或3个以上时按 batch-ingest.md 处理;knowhow-reflect 完成后也可直接调用该流程。用户未指明时需询问来源。

识别类型:decision、pattern、troubleshooting、concept、lesson、candidate-skill、candidate-workflow,每段内容可含多类,需拆分为独立条目。若被要求将已有条目升级为 skill,可创建带 promote_of 的 candidate-skill。

流程:扫描 → 展示候选列表(emoji、类型、摘要)→ 用户逐条或批量确认保留、修改、删除 → 为每条生成 .knowhow/inbox/YYYY-MM-DD-slug.md,并将原文来源保存到 raw/ 同名文件,设置 source_file → 写入 wiki/log.md 日志 → 向用户确认结果并建议运行 knowhow-distill。格式读取 page-formats.md,不硬编码。支持 --then-distill 在采集后直接提炼。

限制:只写 inbox,不合并、不去重、不自动写入;必须经用户确认;raw 来源不能留空,也不能指向 inbox 文件本身。其他细节暂未提供。