@andyqiu/codeforge 0.3.11 → 0.3.13

package/skills/weighted-dimensions/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: weighted-dimensions
+description: 5 维加权打分逻辑；输出 weighted_score ∈ [0,1]，供退出条件判断
+metadata:
+  owner: codeforge
+  group: discover
+version: 1.0.0
+allowed_tools: [read]
+mode: on-demand
+trigger: 每轮对话结束前 / Phase 跳转判定
+---
+
+# Weighted Dimensions
+
+## 5 个维度定义
+
+| 维度 | 含义 | 典型证据 |
+|---|---|---|
+| **Functional** | 功能目标是否清晰：做什么、输出什么、核心流程是否可描述 | 用户能用一句话说出"给谁解决什么 Job" |
+| **UX** | 用户体验诉求：交互形式、感知质量、用户旅程中的关键时刻 | 用户提到了"快"/"简单"/"不要让我多点"等具体体验锚点 |
+| **Technical** | 技术可行性边界：性能要求、技术栈约束、已知依赖或限制 | 提及响应时间、系统限制、第三方 API、数据量级等 |
+| **Constraints** | 业务约束：时间窗口、合规、资源限制、显式排除项 | 提及"本期只做……"/"不做……"/"必须兼容……" |
+| **Edge Cases** | 边界场景：异常路径、零状态、错误处理、极端用户行为 | 用户或 discover 主动列举了"如果……怎么处理" |
+
+---
+
+## 加权公式
+
+**默认权重分配**：
+
+| 维度 | 权重 |
+|---|---|
+| Functional | **30%** |
+| UX | **25%** |
+| Technical | **20%** |
+| Constraints | **15%** |
+| Edge Cases | **10%** |
+
+**计算公式**：
+
+```
+weighted_score = Σ (维度得分 × 权重)
+              = F×0.30 + U×0.25 + T×0.20 + C×0.15 + E×0.10
+```
+
+其中每个维度得分 ∈ [0, 1.0]（0 = 完全未知，0.5 = 部分清晰，1.0 = 充分明确）。
+
+**示例**：
+
+```
+F=0.8, U=0.5, T=0.3, C=0.6, E=0.2
+weighted_score = 0.8×0.30 + 0.5×0.25 + 0.3×0.20 + 0.6×0.15 + 0.2×0.10
+              = 0.24 + 0.13 + 0.06 + 0.09 + 0.02
+              = 0.54
+```
+
+---
+
+## 阈值表
+
+| 阶段跳转 | 所需 weighted_score | 备注 |
+|---|---|---|
+| Phase A → B | **≥ 0.5** | 且 Functional ≥ 0.7，用户能说出核心 Job |
+| Phase B → C | **≥ 0.65** | ≥ 3 个具体场景已确认 |
+| Phase C → D | —（由 challenger 红旗处理状态决定） | 至少 1 轮 challenger 反对被用户正面回应 |
+| Phase D → E | **≥ 0.8** | 或 0.6-0.8 且用户明确说"够了" |
+
+---
+
+## 评分表输出模板
+
+当用户触发「评估 / 打分 / 评分 / 严谨模式 / 看进度 / 澄清度 / 现在多少分 / score / rate」关键词时，或进入 Phase E 前，按此格式输出：
+
+```
+─────────────────────────────────────
+本轮澄清度评分（满分 1.0）：
+| 维度          | 权重 | 当前 | 加权 |
+|---------------|------|------|------|
+| Functional    | 30%  | 0.8  | 0.24 |
+| UX            | 25%  | 0.5  | 0.13 |
+| Technical     | 20%  | 0.3  | 0.06 |
+| Constraints   | 15%  | 0.6  | 0.09 |
+| Edge Cases    | 10%  | 0.2  | 0.02 |
+| **总分**      |      |      | 0.54 |
+
+档位：Insufficient (<0.6) → 继续澄清
+建议下一步：聚焦 Technical 维度（本轮最低分）
+─────────────────────────────────────
+```
+
+**档位规则**：
+
+- **≥ 0.8** → Sufficient，建议进 Phase E 产出 PRD
+- **0.6 ~ 0.8** → Acceptable，可选退出（用户拍板）
+- **< 0.6** → Insufficient，必须继续澄清
+
+---
+
+## 维度打分指南
+
+**Functional 常见打分依据**：
+- 0.0：只说了"做个东西"，完全不知道做什么
+- 0.5：知道大方向（"做个导出"），但不知道输出形式、流程
+- 1.0：输入输出明确，核心流程可描述，用户能说出 Job
+
+**Edge Cases 常见打分依据**：
+- 0.0：完全没讨论过边界
+- 0.5：讨论了 1-2 个正常 happy path，无异常路径
+- 1.0：覆盖了至少 3 个边界场景（空状态/错误/极端输入）

package/workflows/bugfix.yaml

@@ -19,7 +19,7 @@ description: |
     7. reviewer 沉淀 bugfix 经验回 KH
 
 trigger: /debug
-# ADR-0027: 跨 step 反馈循环上限
+# ADR:workflow-on-decision-branching — 跨 step 反馈循环上限
 max_loops: 3
 
 steps:
@@ -61,7 +61,7 @@ steps:
     description: 按 planner 选定的根因假设改代码，让复现测试变绿
     inject_context:
       forbid_direct_edit: true
-    # ADR-0026: 完成 stage 后自动跑 npm test 自纠
+    # ADR:workflow-auto-feedback-loop: 完成 stage 后自动跑 npm test 自纠
     # bugfix 失败本质是假设错——escalate 给 planner 重出根因假设，而不是 reviewer
     auto_feedback:
       test_cmd: "npm test"
@@ -79,7 +79,7 @@ steps:
         args:
           action: list
           status: pending
-    # ADR-0027: 三档决策驱动；BLOCK 回 planner 重出根因假设（与 auto_feedback escalate_to=planner 同语义）
+    # ADR:workflow-on-decision-branching: 三档决策驱动；BLOCK 回 planner 重出根因假设（与 auto_feedback escalate_to=planner 同语义）
     on_decision:
       APPROVE: continue           # 进入"落地" step
       REQUEST_CHANGES:

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

package/workflows/feature-dev.yaml

@@ -7,7 +7,7 @@
 # ──────────────────────────────────────────────────────────────
 
 name: feature-dev
-# ADR-0027: 跨 step 反馈循环上限（reviewer→coder REQUEST_CHANGES 反复 goto 兜底）
+# ADR:workflow-on-decision-branching — 跨 step 反馈循环上限（reviewer→coder REQUEST_CHANGES 反复 goto 兜底）
 max_loops: 3
 version: 1.0.0
 description: |
@@ -41,7 +41,7 @@ steps:
     description: 严格按方案 stage 改动；测试失败立刻停下汇报
     inject_context:
       forbid_direct_edit: true
-    # ADR-0026: 完成 stage 后自动跑 npm test 自纠（最多 3 轮，失败 escalate reviewer）
+    # ADR:workflow-auto-feedback-loop: 完成 stage 后自动跑 npm test 自纠（最多 3 轮，失败 escalate reviewer）
     auto_feedback:
       test_cmd: "npm test"
       max_retries: 3
@@ -60,7 +60,7 @@ steps:
         args:
           action: list
           status: pending
-    # ADR-0027: 三档决策驱动 workflow 跳转
+    # ADR:workflow-on-decision-branching: 三档决策驱动 workflow 跳转
     on_decision:
       APPROVE: continue           # 进入"落地" step
       REQUEST_CHANGES:

package/workflows/parallel-explore.yaml

@@ -1,4 +1,4 @@
-# DEPRECATED (ADR-0054 hotfix 2)
+# DEPRECATED (ADR:parallel-progress-feedback hotfix 2)
 #
 # /parallel 命令已由 plugins/subtasks.ts 直接拦截处理（command.execute.before hook），
 # 提供 4 类文字反馈（派出/启动/完成/总结）+ /parallel-status 查询。