SuperAPI AI 工具集

pod-kb

办公与效率

查看项目

更新于 10-23 23:07

技能介绍

pod-kb 是 CocoPlus 工作流中的一个只读展示技能,命令形式为 $pod kb,用于查看项目专属知识库 lifecycle/kb.md。

用途:该知识库由 CocoCupper 在每次完成阶段后填充,记录跨会话积累的项目特定模式、决策和易踩的坑,供后续任务参考。它与 CocoGrove(团队级模式)和 CocoDream(提示词优化经验)相互区分,只针对当前项目。

主要能力:

  • 校验 .cocoplus/ 是否已初始化;若未初始化,提示先运行 $pod init 后退出。
  • 读取 .cocoplus/lifecycle/kb.md;若文件不存在或为空,提示尚未积累项目知识,并建议运行 $build 开始会话。
  • 统计 ## Patterns、## Decisions、## Gotchas 三个章节的条目数量。
  • 以原文原样展示 kb.md 全部内容,并显示项目名(取自 project.md)、条目统计、最后更新日期(取自 kb.md 的 git log),末尾附带说明:CocoScout 会在每个 Build 任务中加载该文件,CocoCupper 在阶段完成后追加条目。

使用方式:在已初始化的 CocoPlus 项目中执行 $pod kb 即可。该技能为只读操作,不写入、不修改任何文件,也不创建 git 提交。

内容结构参考:CocoCupper 按固定格式写入条目——Patterns 为“模式名: 描述 — 发现于某会话/阶段”,Decisions 为“决策: 理由 — 日期”,Gotchas 为“坑: 描述及规避方式”。

错误处理:kb.md 不存在时给出提示信息并非报错退出;文件格式损坏时输出警告“kb.md appears to have formatting issues. Showing raw content:”并展示原始内容供人工检查。

适用场景:需要了解当前项目已沉淀的约定、历史决策与常见陷阱时;或确认知识库是否已开始积累。

限制:仅用于展示,不负责创建或编辑知识库;依赖 .cocoplus/ 初始化状态;需要 git 记录才能显示最后更新日期(资料未说明无 git 时的行为)。