SuperAPI AI 工具集

manage-knowhow-capture

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:把工作中的可复用知识结构化保存下来,便于后续检索与智能体调用。支持十种类型:session(会话压缩)、template(模板)、recipe(配方/步骤)、reference(参考)、decision(决策/ADR)、tip(提示)、asset(资产)、blueprint(蓝图)、document(文档)、insight(洞察)。

主要能力:按类型收集并生成结构化 Markdown 文件,文件名带前缀(如 TPL-、RCP-、REF-)和日期。写入 YAML frontmatter,含 title、description、type、created、tags 及类型专属字段(template 的 lang、reference 的 source、decision 的 status、asset 的 assetType 与 codePaths、blueprint 的 codePaths)。description 用于搜索结果,未提供时自动截取正文前 240 字符。标签语言需与内容语言一致。

使用方式:命令形如 $manage-knowhow-capture "compact"、$manage-knowhow-capture "template React form pattern --lang typescript"、$manage-knowhow-capture "tip ..." --tag workflow,state、$manage-knowhow-capture "reference Stripe API --source https://docs.stripe.com/api"。常用参数包括 --lang、--source、--tag、--title、--asset-type、--code-paths、--description、--category。类型可由首词识别,也可交互询问。流程含类型检测与内容收集两道强制性门禁,缺少必要字段会阻塞。

限制:所有文件写入仅限 .workflow/knowhow/,绝不修改源代码或该路径外文件。需先初始化 .workflow/,否则报 E001;模板缺代码报 E002,配方缺步骤报 E003;无活动会话、无显式计划、source 抓取失败会给出警告。category 仅在显式提供 --category 时写入,且不默认取 type 值。