SuperAPI AI 工具集

knowledge-sync

通用与其它

查看项目

更新于 10-16 09:32

技能介绍

用途:把 PPBT 区域的 ADO 工作项和 ICM 事故转化为可持续积累的知识。每次运行只拉取上次同步之后变更的条目,知识随时间累积而非覆盖。手动调用方式为 /knowledge-sync,也会被 /review、/workitem、/pac-cli-update 在知识库超过 7 天未更新时自动内联调用,无需手动调度。

主要能力:读取 memory/ado-knowledge.md(按运行日期分组的追加式日志,从不覆盖)与 memory/MEMORY.md(提炼后的硬性规则、模式与技能清单)。通过 ado-knowledge.md 顶部的 ## Last sync 记录进度;首次运行(文件不存在)以过去 90 天作为引导窗口。

使用方式:先读取上次同步日期,若不存在则用 @Today - 90;再配置 ADO 组织(az devops configure --defaults organization=... project=...,必要时 az login --use-device-code);随后用 az boards query 的 WIQL 查询活动项及上次同步后关闭/解决的项,逐项获取完整详情(每次运行完整详情上限 30 条,其余仅按标题与状态汇总);查询 ICM 事故,若 icm CLI 不可用则回退为在 ADO 中检索含 IcM 引用的工作项。

分类与落盘:将新条目归类为复发缺陷/根因、已知解决方法、架构决策、依赖冲突/漏洞模式、任务契约变更、ICM 缓解措施等,只记录解决说明或 ICM 缓解中明确陈述的事实,不做推测;随后向 ado-knowledge.md 追加带日期的章节,并仅在有新事实时更新对应 SKILL.md 文件与 MEMORY.md,最后确认 ## Last sync 日期正确并输出同步窗口、处理数量、新提取事实与更新文件清单。

适用场景:需要为 PPBT 扩展维护长期项目知识、复现调试手册、依赖硬性规则与评审清单的团队工作流。

限制:资料未提供该技能的许可、价格、平台覆盖范围、对 ADO 与 ICM 之外数据源的兼容性、完整的错误处理行为以及依赖安装方式;具体可用性取决于本地 az/icm CLI 与环境权限。