SuperAPI AI 工具集

issue-flow

编程与开发

查看项目

更新于 10-15 17:27

技能介绍

用途:Issue Flow 用于处理必须被复现并交付的已报告缺陷。它组合仓库中的其他技能,本身不替代它们。

前置条件:先阅读 AGENTS.md、仓库验证说明及相关领域/运行时指引。仅在需要时加载工具:仓库要求隔离工作树时加载 worktree 指引;浏览器可见行为用 agent-browser;仅当本地无法获得证据时使用 live/log/trace/database 工具;非平凡交付前运行 code-review;分支、PR 与反馈生命周期用 git-workflow。不得改动生产、远程数据或无关本地变更。若前置条件无法运行,记录命令、输出与阻塞点,不得声称已复现或验证。

状态机:intake → reproduce → baseline → investigate → implement → verify → deterministic-checks → local-review → delivery → final-evidence → reflect → done。只有满足完成条件才推进状态。同场景验证失败则回到 investigate;评审发现问题回到 implement;缺少必要证据或批准时停在 blocked。

主要阶段:1) 受理与验收目标:把报告转为可测试契约,含报告人/上下文、受影响页面/API/任务、账号/租户或安全夹具、相关标识符、精确观察与预期行为、前置条件、输入、序列、权限、边界/负例、具体验收标准及可证伪证据。2) 复现与基线:优先使用现有项目设置、夹具、导入与运行时说明;浏览器可见行为须用真实浏览器流程,静态检查与单元测试不能替代。在生产代码修改前捕获基线证据。3) 调查根因:端到端追踪受影响路径,区分症状与根因,选择能修复所有受影响调用方的最小共享位置。4) 实现:在根因位置做最小正确改动,保留契约,必要时添加确定性回归测试。5) 同场景验证:除预期修复外重复基线场景,记录步骤、预期与实际结果。6) 确定性检查与本地评审:从正确根目录运行仓库要求的聚焦检查,非平凡变更运行 code-review 直至 RESULT: PASSED。7) 交付与最终证据:经授权后用 git-workflow 交付分支/PR,未经授权不得提交、推送或发布。8) 独立反思:交付后可单独记录可复用流程经验,不改变问题结论、不延迟交付、不扩大 PR。

完成定义:复现目标、基线证据、根因修复、同场景证据、必需确定性检查、本地评审与最终证据全部通过;被请求且获授权时 Git 交付完成。

停止条件:缺少产品意图、无安全数据/运行时、记录尝试后仍无法复现、必需检查失败、存在未解决的重要评审发现、远程变更未获批准或用户要求停止时,停止并报告 blocked。绝不编造证据或静默跳过状态。