lightweight-ai-workflow

name	lightweight-ai-workflow
description	处理 BK-CI AI 编码任务分流时使用，例如判断日常任务是否需要 OpenSpec、多 Agent、影响面清单或验证清单。

Lightweight AI Workflow

适用场景

• 用户要求制定、执行或检查 AI 编码流程
• 需求开始前需要判断走轻流程、OpenSpec 还是多 Agent
• 代码实现前需要做影响面分析
• 代码实现后需要给出最小验证结论和剩余风险

不适用场景

• 已经明确是某个业务模块的普通实现，优先读该模块 skill
• 已有 openspec/changes/<change>/，优先遵守 openspec-first
• 用户只问概念、代码解释或不涉及交付流程的问题

快速指导

1. 先按 skill-context-first 识别主模块，默认只读 1 个模块主 skill。
2. 单模块、低风险、边界明确的任务，可按复杂度选择直接实现，或先进入 Plan Mode 梳理方案；不要 直接升级 OpenSpec 或多 Agent。
3. 多模块、影响不明或容易漏联动点的任务，先完成 impact checklist，再决定是否实现。
4. 命中 OpenSpec 触发条件时，先补文档，再改代码。
5. 需求大、范围模糊、跨端或连续返工时，才升级多 Agent。
6. 实现完成后，输出 verification checklist，说明已验证项、未验证项和剩余风险。

任务分流

• 轻流程：单模块、小范围、低风险、验收清楚；读取目标模块 skill 后，可按复杂度选择直接实现，或 先进入 Plan Mode 梳理范围、影响面和方案。
• 影响面先行：跨模块、调用链不明、配置/权限/数据/i18n 可能受影响；先写 impact checklist。
• OpenSpec：新增或修改 API、数据结构、数据库脚本、稳定外部契约；跨 2 个以上微服务或核心模块； 涉及权限、兼容性、迁移、灰度、回滚；或验收口径不清。
• 多 Agent：需求范围大且模块归属不清；需要需求、方案、实现、质量门禁分阶段交接；单 Agent 连续两轮仍无法收敛；或用户明确要求多 Agent 协作。

Impact Checklist

• 本次主要落在哪个模块 skill？是否需要补读 1 个横切 skill？
• 影响哪些层：Resource、Service、DAO、Model、配置、脚本、前端、Worker、Agent？
• 是否影响 API、数据契约、数据库、权限、i18n、事件、缓存或定时任务？
• 是否存在调用方、被调用方、历史兼容、灰度或回滚要求？
• 是否需要 OpenSpec 或多 Agent 升级？

Verification Checklist

• 本次需求点是否逐项覆盖？
• 受影响模块是否至少跑过编译、单测、lint 或关键脚本之一？
• 没跑的验证是什么，原因是什么？
• 是否有新增 warning、失败或规则违反？
• 是否仍有未验证风险、历史遗留问题或需要人工确认的点？

高信号规则

• 轻量入口只负责分流和清单，不承载模块知识。
• 不要为了“保险”扩大流程；小任务优先把 token 用在代码和验证上。
• 发现重复漏改或流程误判时，先沉淀到 ai/evals/，确认稳定后再调整 rule 或 skill。

延伸阅读

• skill-context-first：模块 skill 读取预算
• openspec-first：已有 OpenSpec 变更的文档优先规则
• multi-agent-workflow：大任务或多 Agent 协作规则
• ../../HARNESS.md：rule、skill、reference 与编辑器适配目录边界