jsharness 1.0.0

package/.harness/task-board.md

@@ -0,0 +1,121 @@
+# TaskBoard — 项目任务态势看板
+
+> **维护者**: PM Agent
+> **更新频率**: 每次状态变更时立即更新
+> **最后更新**: 2026-05-20 22:13 (初始化)
+
+---
+
+## 📌 进行中任务
+
+| 任务ID | 标题 | 当前阶段 | 负责Agent | 文档目录 | 上次更新 | 预计完成 |
+|--------|------|----------|-----------|----------|----------|----------|
+| *(暂无)* | - | - | - | - | - | - |
+
+## 📋 待开始任务
+
+| 任务ID | 标题 | 优先级 | 来源 | 关联Issue/PR | 流程变体 |
+|--------|------|--------|------|-------------|----------|
+| *(暂无)* | - | - | - | - | - |
+
+### 待分配需求池
+
+| 来源渠道 | 需求描述 | 接收时间 | 状态 |
+|----------|----------|----------|------|
+| *(待填充)* | - | - | 待路由 |
+
+## ✅ 已完成任务（本月）
+
+| 任务ID | 标题 | 交付结论 | 归档日期 | 实际周期 |
+|--------|------|----------|----------|----------|
+| *(暂无)* | - | - | - | - |
+
+---
+
+## 📊 度量指标区域
+
+### 本周概览（自动计算）
+
+| 指标 | 值 | 目标 | 状态 |
+|------|-----|------|------|
+| 新增需求 | 0 | - | - |
+| 完成交付 | 0 | ≥3 | - |
+| 平均交付周期(天) | - | ≤7 | - |
+| 打回率 | 0% | <15% | - |
+| 各阶段阻塞数 | 0 | =0 | - |
+| 流程违规次数 | 0 | =0 | - |
+
+### 各阶段当前负载
+
+```
+需求分析: [░░░░░] 0 个
+方案设计: [░░░░░] 0 个
+闸门评估: [░░░░░] 0 个
+开发实现: [░░░░░] 0 个
+代码审查: [░░░░░] 0 个
+测试验证: [░░░░░] 0 个
+交付归档: [░░░░░] 0 个
+```
+
+---
+
+## 🔄 TaskBoard 维护 Skill
+
+### 新任务注册流程
+
+```yaml
+触发条件: PM 收到新需求
+步骤:
+  1. 分配唯一 Task ID（格式：TASK-YYYYMMDD-NNN）
+  2. 判断流程变体（标准/Bug修复/热修复/微型）
+  3. 在「待开始任务」表中注册
+  4. 更新度量指标中的"新增需求"
+  5. 如果有相关 Issue，关联到对应列
+```
+
+### 状态变更规则
+
+```
+┌───────────┐   需求分析完成    ┌──────────────┐
+│ 待开始     │ ──────────────→ │ 进行中        │
+│           │                  │              │
+│           │ ←────────────── │              │
+│           │   打回重做       │              │
+└───────────┘                  └──────┬───────┘
+                                     │ 测试通过
+                              ┌──────▼───────┐
+                              │ 已完成       │
+                              │              │
+                              └──────────────┘
+
+每次状态变更必须：
+1. 更新表格中该行的位置
+2. 更新"上次更新"时间戳
+3. 记录变更原因（简短）
+4. 同步更新度量指标
+```
+
+### 交付归档流程
+
+```yaml
+触发条件: 测试验证 PASS
+步骤:
+  1. 将任务从「进行中」移至「已完成」
+  2. 记录交付结论（PASS/CONDITIONAL_PASS + 说明）
+  3. 记录实际交付周期（从进入开发到完成的天数）
+  4. 归档所有阶段文档链接
+  5. 更新度量指标：
+     - 完成交付 +1
+     - 平均交付周期 重算
+     - 如有打回 → 打回率 重算
+  6. 通知相关利益方
+```
+
+---
+
+## ⚠️ 注意事项
+
+1. **TaskBoard 是单一数据源** — 所有任务的状态以此为准，不与其他工具冲突
+2. **PM 对准确性负责** — 过期或错误的信息会影响整个团队效率
+3. **定期 Review** — 每周一 PM Agent 清理过期条目和异常数据
+4. **与外部系统同步** — 可选地与 Jira/GitLab Issues 保持同步

package/.harness/workflow/definition.yaml

@@ -0,0 +1,504 @@
+# Harness 主流程状态机定义
+
+## 流程概览
+
+```mermaid
+stateDiagram-v2
+    [*] --> 需求分析: PM路由新需求
+    
+    需求分析 --> 方案设计: 需求文档✅
+    需求分析 --> 需求分析: 打回重做
+    需求分析 --> [*]: 取消
+    
+    方案设计 --> 闸门评估: 设计文档✅
+    方案设计 --> 方案设计: 打回重做
+    方案设计 --> 需求分析: 需要澄清需求(变更请求)
+    
+    闸门评估 --> 开发实现: PASS放行
+    闸门评估 --> 方案设计: BLOCK/需要修改方案
+    闸门评估 --> 需求分析: HOLD/需求问题
+    闸门评估 --> [*]: BLOCK且无法解决/取消
+    
+    开发实现 --> 代码审查: PR创建+自检通过✅
+    开发实现 --> 开发实现: 自检未通过
+    开发实现 --> 方案设计: 发现设计与实际不符
+    
+    代码审查 --> 测试验证: PASS/条件PASS通过✅
+    代码审查 --> 开发实现: FAIL打回修改
+    代码审查 --> 闸门评估: 安全红线问题升级
+    
+    测试验证 --> 交付归档: 全部测试PASS✅
+    测试验证 --> 开发实现: 缺陷修复(P1/P2)
+    测试验证 --> 方案设计: 设计缺陷导致无法验收
+    测试验证 --> 闸门评估: 安全漏洞阻断
+    
+    交付归档 --> [*]: 完成
+```
+
+## 七个阶段完整定义
+
+```yaml
+workflow:
+  name: "产研测标准流程"
+  version: "1.0.0"
+  description: "面向 Web 全栈应用的标准七阶段开发工作流"
+  
+  stages:
+    - id: requirements-analysis
+      name: "需求分析"
+      order: 1
+      agent: requirements-analyst
+      model_tier: standard
+      max_turns: 10
+      
+      inputs:
+        - name: "原始需求"
+          source: "pm_routing"
+          format: "natural_language / issue"
+          required: true
+        - name: "TaskBoard 状态"
+          source: "task_board"
+          format: "markdown"
+          required: true
+        - name: "dev-map 参考文档"
+          source: "dev_map"
+          format: "markdown"
+          required: true
+      
+      outputs:
+        - name: "需求文档"
+          format: "markdown"
+          template: ".harness/templates/requirements.md"
+          required: true
+        - name: "验收标准列表"
+          format: "markdown"
+          required: true
+        - name: "用户故事集"
+          format: "markdown"
+          required: false
+      
+      transitions:
+        - to: solution-design
+          trigger: "需求文档审核通过"
+          guard: "所有必需产出物齐全 + 验收标准可测"
+        - to: self
+          trigger: "打回重做"
+          condition: "需求不清晰 / 遗漏关键信息"
+        - to: cancelled
+          trigger: "取消需求"
+          
+      rules_referenced:
+        - "rules/global/process-discipline.md"   # 下游不得改上游
+
+    - id: solution-design
+      name: "方案设计"
+      order: 2
+      agent: solution-designer
+      model_tier: standard
+      max_turns: 15
+      
+      inputs:
+        - name: "需求文档"
+          source: "requirements_analysis.outputs.需求文档"
+          required: true
+        - name: "验收标准"
+          source: "requirements_analysis.outputs.验收标准列表"
+          required: true
+        - name: "dev-map 架构参考"
+          source: "dev_map"
+          required: true
+        - name: "ADR 历史决策"
+          source: "dev-map/decisions.md"
+          required: false
+      
+      outputs:
+        - name: "技术设计文档"
+          format: "markdown"
+          required: true
+        - name: "API 定义"
+          format: "yaml (OpenAPI)"
+          required: true
+        - name: "数据模型"
+          format: "markdown"
+          required: true
+        - name: "技术决策记录（如有新决策）"
+          format: "markdown (ADR)"
+          required: false
+      
+      transitions:
+        - to: gate-evaluation
+          trigger: "设计方案完成"
+          guard: "所有必需产出物齐全"
+        - to: self
+          trigger: "打回重做"
+          condition: "方案不完整 / 不符合需求"
+        - to: requirements-analysis
+          trigger: "变更请求 — 需求澄清"
+          type: "upstream_request"
+          
+      rules_referenced:
+        - "rules/global/coding-standard.md"
+
+    - id: gate-evaluation
+      name: "闸门评估"
+      order: 3
+      agent: gate-controller
+      model_tier: strong
+      max_turns: 8
+      
+      inputs:
+        - name: "需求文档"
+          from: "requirements_analysis"
+          required: true
+        - name: "技术设计文档"
+          from: "solution_design"
+          required: true
+        - name: "Gate 快速检查结果"
+          source: "gate_scripts"
+          format: "json"
+          required: false
+        - name: "资源可用情况"
+          source: "human_input"
+          format: "text"
+          required: false
+      
+      outputs:
+        - name: "可行性报告"
+          format: "markdown"
+          required: true
+        - name: "风险清单"
+          format: "markdown"
+          required: true
+        - name: "裁决决定"
+          format: "json { decision: PASS|BLOCK|HOLD, reason }"
+          required: true
+      
+      decisions:
+        - outcome: PASS
+          to: development
+          condition: "无阻塞风险 + 所有中高风险有缓解措施"
+        - outcome: BLOCK-to-design
+          to: solution-design
+          condition: "方案层面的问题可修正"
+        - outcome: BLOCK-cancel
+          to: cancelled
+          condition: "根本不可行或资源永远不足"
+        - outcome: HOLD
+          to: self
+          condition: "需等待外部条件（POC/审批/资源）"
+        - outcome: BLOCK-to-requirements
+          to: requirements-analysis
+          condition: "需求层面的根本性问题"
+      
+      rules_referenced:
+        - "rules/global/security-baseline.md"
+        - "rules/global/process-discipline.md"
+
+    - id: development
+      name: "开发实现"
+      order: 4
+      agent: developer
+      model_tier: standard
+      max_turns: 20
+      
+      inputs:
+        - name: "技术设计文档"
+          from: "solution_design"
+          required: true
+        - name: "API 定义"
+          from: "solution_design"
+          required: true
+        - name: "Rule 规则集"
+          source: "harness_rules"
+          required: true
+        - name: "Skill 动作集"
+          source: "harness_skills"
+          required: true
+        - name: "dev-map 结构参考"
+          source: "dev_map"
+          required: true
+      
+      outputs:
+        - name: "实现代码"
+          format: "source code (ts/tsx/js/jsx/java)"
+          location: "src/"
+          required: true
+        - name: "单元测试"
+          format: "source code (.test.*)"
+          location: "src/"
+          required: true
+        - name: "Git Commit 历史"
+          source: "git_log"
+          required: true
+        - name: "dev-map 更新"
+          format: "markdown"
+          location: "dev-map/"
+          condition: "有结构性变化时"
+        - name: "自检报告"
+          format: "markdown"
+          required: true
+        - name: "PR/MR"
+          source: "git_platform"
+          required: true
+      
+      internal_steps:
+        - step: 1
+          action: "阅读设计文档 + dev-map"
+          skill: null
+        - step: 2
+          action: "实现核心逻辑"
+          skill: null
+        - step: 3
+          action: "编写/更新单元测试"
+          skill: "test-unit"
+        - step: 4
+          action: "运行构建 Skill（按技术栈选择）"
+          # 条件引用：检测 pom.xml → java-build；检测 package.json → vue-frontend-build
+          # 详见 skills/build.md（已废弃，保留为路由参考）
+          skill: "java-build | vue-frontend-build"
+          gate: "编译失败 → 返回 Step 2"
+        - step: 5
+          action: "运行 Test Unit Skill"
+          skill: "test-unit"
+          gate: "测试失败 → 返回 Step 2/3"
+        - step: 6
+          action: "运行 Lint Check Skill"
+          skill: "lint-check"
+          gate: "Lint 失败 → 自动修复后重新检查"
+        - step: 7
+          action: "更新 dev-map"
+          skill: "docs-update"
+        - step: 8
+          action: "规范 Commit + 创建 PR/MR"
+          gate: "Commit 格式不符合 → 修正后提交"
+      
+      transitions:
+        - to: code-review
+          trigger: "PR 创建 + 三步自检全部通过"
+        - to: self
+          trigger: "自检任一步失败"
+          auto_retry: 3
+        - to: solution-design
+          trigger: "发现设计与实际情况严重不符"
+          type: "escalation"
+          
+      rules_referenced:
+        - "rules/global/coding-standard.md"
+        - "rules/global/security-baseline.md"
+        - "rules/global/commit-convention.md"
+        - "rules/project/java-backend.md"          # Java 后端项目级规范
+        - "rules/project/frontend-vue3.md"          # Vue3 前端项目级规范
+
+    - id: code-review
+      name: "代码审查"
+      order: 5
+      agent: code-reviewer
+      model_tier: strong
+      max_turns: 12
+      
+      inputs:
+        - name: "PR/MR Diff"
+          source: "git_diff"
+          required: true
+        - name: "技术设计文档"
+          from: "solution_design"
+          required: true
+        - name: "自检报告"
+          from: "development"
+          required: true
+        - name: "Gate 快速扫描"
+          source: "gate_scripts"
+          required: false
+        - name: "Code Review Checklist"
+          source: "skills/code-review.md"
+          required: true
+      
+      outputs:
+        - name: "审查报告"
+          format: "markdown"
+          required: true
+        - name: "裁决决定"
+          format: "enum { PASS | CONDITIONAL_PASS | FAIL }"
+          required: true
+      
+      decisions:
+        - outcome: PASS
+          to: testing
+          condition: "总分 ≥ 90% 且无安全问题和必修问题"
+        - outcome: CONDITIONAL_PASS
+          to: testing
+          condition: "总分 ≥ 80% 且必修问题已在 PR 中标记并确认会修"
+        - outcome: FAIL
+          to: development
+          condition: "安全红线 / A<60% / 无测试 / 覆盖率回归>5%"
+          require_fix: true
+        - outcome: ESCALATE
+          to: gate-evaluation
+          condition: "发现架构级安全问题"
+          type: "security_escalation"
+      
+      review_dimensions:
+        - id: quality
+          name: "代码质量"
+          weight: 30
+          checks: ["A1-A6"]
+        - id: compliance
+          name: "规范遵循"
+          weight: 15
+          checks: ["B1-B5"]
+        - id: security
+          name: "安全与风险"
+          weight: 25
+          checks: ["C1-C5"]
+        - id: performance
+          name: "性能考量"
+          weight: 10
+          checks: ["D1-D4"]
+        - id: testing
+          name: "测试覆盖"
+          weight: 20
+          checks: ["E1-E3"]
+
+    - id: testing
+      name: "测试验证"
+      order: 6
+      agent: tester
+      model_tier: strong
+      max_turns: 15
+      
+      inputs:
+        - name: "需求文档"
+          from: "requirements_analysis"
+          required: true
+        - name: "技术设计文档"
+          from: "solution_design"
+          required: true
+        - name: "实现代码"
+          from: "development"
+          required: true
+        - name: "验收标准"
+          from: "requirements_analysis"
+          required: true
+        - name: "审查报告"
+          from: "code_review"
+          required: true
+        - name: "Skill 测试动作集"
+          source: "skills/test-*.md"
+          required: true
+      
+      outputs:
+        - name: "测试计划"
+          format: "markdown"
+          required: true
+        - name: "测试报告"
+          format: "markdown"
+          required: true
+        - name: "缺陷列表"
+          format: "markdown"
+          required: true
+        - name: "回归风险评估"
+          format: "markdown"
+          required: true
+        - name: "Gate 验证结果"
+          format: "json"
+          required: true
+      
+      test_types:
+        - name: "unit_tests"
+          skill: "test-unit"
+          executor: "ci_pipeline"
+          required: true
+          # 前端: Vitest/Jest + coverage ≥80% | 后端: JUnit5/Mockito + JaCoCo ≥80%
+          threshold: "coverage >= baseline (前端 Vitest / 后端 JaCoCo)"
+        - name: "api_integration"
+          skill: "test-api"
+          executor: "tester_agent"
+          required: true
+          # 前端: Pactum | 后端: REST Assured (MockMvc) / Newman
+          threshold: "no breaking changes (前端 Pactum / 后端 REST Assured)"
+        - name: "e2e_critical_path"
+          skill: "test-e2e"
+          executor: "tester_agent"
+          required: true
+          threshold: "all critical paths pass"
+        - name: "security_scan"
+          skill: "lint-check"
+          executor: "gate_scripts"
+          required: true
+          threshold: "no HIGH/CRITICAL vulnerabilities"
+        - name: "performance_test"
+          executor: "tester_agent"
+          required: false
+          condition: "涉及性能 NFR 时"
+        - name: "regression_test"
+          executor: "tester_agent"
+          required: true
+          threshold: "no P0/P1 regressions"
+      
+      decisions:
+        - outcome: PASS
+          to: delivery
+          condition: "P0=P1=0 + 核心 E2E 通过 + 无回归 + 覆盖率达标"
+        - output: FIX_AND_RETEST
+          to: development
+          condition: "发现 P1/P2 缺陷"
+          with_defects: true
+        - output: DESIGN_ISSUE
+          to: solution-design
+          condition: "设计缺陷导致功能无法验收"
+          type: "upstream_request"
+        - output: SECURITY_BLOCK
+          to: gate-evaluation
+          condition: "发现安全漏洞"
+          type: "security_escalation"
+
+    - id: delivery
+      name: "交付归档"
+      order: 7
+      agent: project-manager
+      model_tier: lite
+      max_turns: 5
+      
+      inputs:
+        - name: "所有阶段产物"
+          from: "all_stages"
+        - name: "测试报告"
+          from: "testing"
+          required: true
+        - name: "Gate 完整验证结果"
+          from: "gate_scripts"
+          required: true
+      
+      outputs:
+        - name: "交付摘要"
+          format: "markdown"
+          required: true
+        - name: "TaskBoard 归档更新"
+          source: "task-board"
+          required: true
+        - name: "度量数据记录"
+          source: "metrics_store"
+          required: true
+      
+      actions:
+        - "汇总全链路交付物"
+        - "更新 TaskBoard 为已完成"
+        - "记录度量指标（周期时间、各阶段耗时、打回次数等）"
+        - "通知相关利益方"
+        - "归档所有阶段文档到交付目录"
+
+      transitions:
+        - to: completed
+          trigger: "所有归档完成"
+
+  # === 回退规则全局声明 ===
+  rollback_policy:
+    max_rollbacks_per_stage: 3     # 每阶段最大回退次数
+    total_max_rollbacks: 10         # 整个流程最大总回退次数
+    escalation_threshold: 2         # 同一阶段连续回退 N 次触发人工介入
+    
+  # === 全局规则引用 ===
+  global_rules:
+    - "rules/global/process-discipline.md"
+    - "rules/global/coding-standard.md"
+    - "rules/global/security-baseline.md"