@andyqiu/codeforge 0.3.12 → 0.3.13

package/workflows/discover-flow.yaml

@@ -0,0 +1,150 @@
+# ──────────────────────────────────────────────────────────────
+# discover-flow.yaml — Discover Agent 5 阶段需求澄清流程
+# trigger: /discover
+# 流程：phase-a 入口门控 → phase-b JTBD 挖掘 → phase-c 对抗审查
+#       → phase-d 假设暴露 + 补边界 → phase-e PRD + handoff 生成
+#
+# ⚠️ Schema 适配说明（reviewer REQUEST_CHANGES 修复 1，选项 A）：
+#    lib/workflow-loader.ts 的 WorkflowSchema.strict() 只接受
+#    name / description / version / trigger / context_template /
+#    max_loops / steps 这些顶层字段；StepSchema.strict() 只接受
+#    name / agent / description / inject_context / requires_human_approval /
+#    actions / on_error / max_retries / timeout / auto_feedback /
+#    on_decision —— 不允许 id / skills / exit_when / on_success /
+#    on_fail / artifacts。
+#
+#    Session 3 原始设计中那些"声明字段"的语义（每阶段允许调哪些
+#    skill、退出条件、产物路径）按 ADR-discover-phase1 D4 决策属于
+#    **声明 ≠ 调用**：workflow runner 不解析、不强制，由 discover
+#    agent 在对话中通过 opencode `skill` 工具按需执行。因此本次修复
+#    把这些信息全部下沉到每个 step 的 `description:` 文本块中作为
+#    可审计的契约声明，loader 把它当普通字符串处理，不影响 schema
+#    校验，"声明仍是 source of truth"。
+# ──────────────────────────────────────────────────────────────
+
+name: discover-flow
+version: 1.0.0
+description: |
+  双 agent（discover + discover-challenger）协作的 5 阶段需求澄清流程：
+    phase-a 入口门控   → 判断用户输入是否清晰到可进入挖掘
+    phase-b JTBD 挖掘  → 澄清 job-to-be-done + 核心 user story
+    phase-c 对抗审查   → 召唤 challenger 子 agent 做反 sycophancy 强对抗
+    phase-d 假设暴露   → 处理红旗 + Example Mapping 补 case
+    phase-e PRD+handoff → 输出 PRD.md + handoff.yaml
+  本 workflow 不直接调用 skill，由 discover agent 按 ## Skill 路由表 决定。
+
+trigger: /discover
+max_loops: 5
+
+steps:
+  - name: phase-a 入口模糊度门控
+    agent: discover
+    description: |
+      [阶段 A] 入口门控
+      ─────────────────────────────────────
+      职责：首次接到用户输入，判断 5 维度清晰度（who/what/why/scope/criteria）；
+            模糊则要求用户补充，清晰则进入 phase-b。
+
+      允许调用 skill（声明，由 agent 按需触发，runner 不强制）：
+        - ambiguity-gate
+        - weighted-dimensions
+
+      退出条件（声明，由 agent 自检；不通过则在本 step 继续澄清）：
+        - weighted_score >= 0.5
+        - user_intent 字段已确立
+
+      成功后跳转：phase-b
+      失败回退：留在本 step 继续追问
+
+      产物（可选）：
+        - handoff.draft.yaml（草稿，本阶段非必需）
+
+  - name: phase-b JTBD 挖掘
+    agent: discover
+    description: |
+      [阶段 B] JTBD 挖掘
+      ─────────────────────────────────────
+      职责：澄清 job-to-be-done + 核心 user story；中段调用 example-mapping
+            挖 BDD 场景；每轮末调用 weighted-dimensions 更新加权分。
+
+      允许调用 skill（声明）：
+        - weighted-dimensions
+        - example-mapping
+
+      退出条件（声明）：
+        - weighted_score >= 0.65
+        - core_user_story 字段已确立
+
+      成功后跳转：phase-c
+      失败回退：留在本 step 继续澄清
+
+      产物（必须）：
+        - handoff.draft.yaml
+
+  - name: phase-c 对抗审查
+    agent: discover
+    description: |
+      [阶段 C] 对抗审查
+      ─────────────────────────────────────
+      职责：召唤 discover-challenger 子 agent 前，调用 devils-advocate 准备
+            4 种 combo（A/B/C/D）对抗框架；challenger 返回红旗判定
+            （YES/NO）后由 discover 决定下一步。
+
+      允许调用 skill（声明）：
+        - devils-advocate
+        - weighted-dimensions
+
+      退出条件（声明）：
+        - red_flags_handled == true（challenger 报告中的红旗已全部回应）
+
+      成功后跳转：phase-d
+      失败回退：留在本 step 继续处理红旗
+
+      产物（必须）：
+        - handoff.draft.yaml（更新红旗处理记录）
+
+  - name: phase-d 假设暴露与补边界
+    agent: discover
+    description: |
+      [阶段 D] 假设暴露 + 补边界
+      ─────────────────────────────────────
+      职责：处理 challenger 报告中的红旗 + 漏洞；末段调用 example-mapping
+            补充边界 case；Question 卡 ≤ 2 张时收敛进入 phase-e。
+
+      允许调用 skill（声明）：
+        - example-mapping
+        - weighted-dimensions
+
+      退出条件（声明）：
+        - red_flags == [] （或全部已处理）
+        - weighted_score >= 0.75
+
+      成功后跳转：phase-e
+      失败回退：留在本 step 继续补边界
+
+      产物（必须）：
+        - handoff.draft.yaml（更新边界 case）
+
+  - name: phase-e PRD 与 handoff 生成
+    agent: discover
+    description: |
+      [阶段 E] PRD + handoff 生成
+      ─────────────────────────────────────
+      职责：调用 success-criteria 把 user story + example mapping 转成 SMART
+            验收清单；调用 ears-zh 把验收套 EARS 中文句式；最终产出
+            PRD.md + handoff.yaml。
+
+      允许调用 skill（声明）：
+        - success-criteria
+        - ears-zh
+
+      退出条件（声明）：
+        - handoff_yaml_complete == true
+        - weighted_score >= 0.8
+
+      成功后跳转：__end__（workflow 结束）
+      失败回退：留在本 step 继续完善 PRD
+
+      产物（必须）：
+        - PRD.md
+        - handoff.yaml