SuperAPI AI 工具集

lightweight-ai-workflow

办公与效率

查看项目

更新于 10-16 08:49

技能介绍

用途:在 BK-CI 的 AI 编码任务中做流程分流,判断需求开始前走轻流程、OpenSpec 还是多 Agent,实现前做影响面分析,实现后给出最小验证结论和剩余风险。

主要能力:按 skill-context-first 识别主模块,默认只读 1 个模块主 skill;对单模块、低风险、边界明确的任务,按复杂度选择直接实现或先进入 Plan Mode;对多模块、影响不明或易漏联动点的任务,先完成 impact checklist;命中 OpenSpec 触发条件时先补文档再改代码;需求大、范围模糊、跨端或连续返工时升级多 Agent。

任务分流:轻流程适用于单模块、小范围、低风险、验收清楚;影响面先行适用于跨模块、调用链不明,或配置、权限、数据、i18n 可能受影响;OpenSpec 适用于新增或修改 API、数据结构、数据库脚本、稳定外部契约,跨两个以上微服务或核心模块,涉及权限、兼容性、迁移、灰度、回滚,或验收口径不清;多 Agent 适用于需求范围大且模块归属不清、需要分阶段交接、单 Agent 连续两轮无法收敛,或用户明确要求多 Agent 协作。

清单:Impact Checklist 覆盖主模块 skill、横切 skill、影响层级(Resource、Service、DAO、Model、配置、脚本、前端、Worker、Agent)、API 与数据契约、权限、i18n、事件、缓存、定时任务、调用关系、兼容、灰度、回滚以及是否升级。Verification Checklist 覆盖需求点逐项覆盖、受影响模块是否跑过编译/单测/lint/关键脚本、未跑验证及原因、新增 warning 或失败、剩余风险。

限制与注意:不适用于已明确是某业务模块普通实现(优先读该模块 skill)、已有 openspec/changes/<change>/(优先遵守 openspec-first)、仅问概念或代码解释等不涉及交付流程的问题。轻量入口只负责分流和清单,不承载模块知识;不要为求保险扩大流程。发现重复漏改或流程误判时先沉淀到 ai/evals/,稳定后再调整 rule 或 skill。延伸阅读包括 skill-context-first、openspec-first、multi-agent-workflow 及 ../../HARNESS.md。