Lightweight AI Workflow
适用场景
- 用户要求制定、执行或检查 AI 编码流程
- 需求开始前需要判断走轻流程、OpenSpec 还是多 Agent
- 代码实现前需要做影响面分析
- 代码实现后需要给出最小验证结论和剩余风险
不适用场景
- 已经明确是某个业务模块的普通实现，优先读该模块 skill
- 已有
openspec/changes/<change>/，优先遵守openspec-first - 用户只问概念、代码解释或不涉及交付流程的问题
快速指导
- 先按
skill-context-first识别主模块，默认只读1个模块主 skill。 - 单模块、低风险、边界明确的任务，可按复杂度选择直接实现，或先进入 Plan Mode 梳理方案；不要 直接升级 OpenSpec 或多 Agent。
- 多模块、影响不明或容易漏联动点的任务，先完成 impact checklist，再决定是否实现。
- 命中 OpenSpec 触发条件时，先补文档，再改代码。
- 需求大、范围模糊、跨端或连续返工时，才升级多 Agent。
- 实现完成后，输出 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 与编辑器适配目录边界