@dommaker/harness 0.13.0 → 0.13.2

package/src/tools/definitions/std/quality/check-quality.yml

@@ -0,0 +1,241 @@
+# check-quality.yml - 代码质量检查
+# ============================================================================
+# 类型: 质量类步骤
+# 执行方式: 调用 Agent
+# 用途: 执行代码质量检查，包括 lint、安全漏洞、性能问题
+# ============================================================================
+
+name: check-quality
+stage: verify
+description: 代码质量检查（lint + 安全 + 性能）
+category: quality
+version: 2.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.2
+
+# 可用工具
+tools:
+  - file-read
+  - npm-lint
+  - npm-audit
+
+# 输入定义
+inputs:
+  - name: project_path
+    type: string
+    required: true
+    description: 项目路径
+  
+  - name: checks
+    type: array
+    default: ["lint", "security", "performance"]
+    description: 检查项目
+  
+  - name: files
+    type: array
+    description: 要检查的文件列表（可选，默认检查全部）
+
+# 输出定义
+outputs:
+  - name: score
+    type: number
+    description: 质量评分（0-100）
+  
+  - name: issues
+    type: array
+    description: 发现的问题列表
+  
+  - name: report
+    type: object
+    description: 详细报告
+  
+  - name: report_file
+    type: string
+    description: 报告文件路径
+
+# Prompt 模板
+prompt: |
+  你是代码质量检查专家。对项目进行质量检查并生成报告。
+  
+  ## 📁 项目路径
+  {{project_path}}
+  
+  ## 🔍 检查项目
+  {{checks}}
+  
+  {{#if files}}
+  ## 📄 检查文件
+  {{#each files}}
+  - {{this}}
+  {{/each}}
+  {{/if}}
+  
+  ---
+  
+  ## 🛠️ 检查流程
+  
+  ### Step 1: Lint 检查
+  
+  ```bash
+  cd {{project_path}}
+  npm run lint 2>&1 || echo "Lint check completed with issues"
+  ```
+  
+  分析 lint 输出，识别：
+  - 错误数量
+  - 警告数量
+  - 具体问题列表
+  
+  ### Step 2: 安全检查
+  
+  ```bash
+  npm audit --json 2>&1 || echo "{}"
+  ```
+  
+  分析安全审计结果，识别：
+  - 高危漏洞
+  - 中危漏洞
+  - 低危漏洞
+  - 建议修复方案
+  
+  ### Step 3: 性能问题检查
+  
+  静态分析代码，识别常见性能问题：
+  - 未使用的依赖
+  - 大文件/大函数
+  - 同步阻塞操作
+  - 内存泄漏风险
+  - N+1 查询问题
+  
+  ### Step 4: 计算质量评分
+  
+  ```javascript
+  // 评分算法
+  let score = 100;
+  
+  // Lint 问题扣分
+  score -= lintErrors * 5;      // 每个错误 -5
+  score -= lintWarnings * 1;    // 每个警告 -1
+  
+  // 安全漏洞扣分
+  score -= criticalVulns * 20;  // 每个高危 -20
+  score -= highVulns * 10;      // 每个中危 -10
+  score -= moderateVulns * 5;   // 每个低危 -5
+  
+  // 性能问题扣分
+  score -= perfIssues * 3;      // 每个问题 -3
+  
+  score = Math.max(0, score);   // 最低 0 分
+  ```
+  
+  ### Step 5: 生成报告
+  
+  创建 `quality-report.md`：
+  
+  ```markdown
+  # 代码质量检查报告
+  
+  **项目**: {{project_path}}
+  **检查时间**: <timestamp>
+  **质量评分**: <score>/100
+  
+  ---
+  
+  ## 📊 评分明细
+  
+  | 检查项 | 问题数 | 扣分 |
+  |--------|--------|------|
+  | Lint 错误 | X | -X*5 |
+  | Lint 警告 | X | -X*1 |
+  | 高危漏洞 | X | -X*20 |
+  | 中危漏洞 | X | -X*10 |
+  | 低危漏洞 | X | -X*5 |
+  | 性能问题 | X | -X*3 |
+  
+  ---
+  
+  ## 🔴 严重问题
+  
+  ### Lint 错误
+  
+  | 文件 | 行号 | 规则 | 描述 |
+  |------|------|------|------|
+  | ... | ... | ... | ... |
+  
+  ### 高危漏洞
+  
+  | 漏洞 | 依赖 | 描述 | 修复方案 |
+  |------|------|------|---------|
+  | ... | ... | ... | ... |
+  
+  ---
+  
+  ## 🟡 中等问题
+  
+  ### Lint 警告
+  
+  ...
+  
+  ### 中危漏洞
+  
+  ...
+  
+  ---
+  
+  ## 🟢 性能建议
+  
+  1. ...
+  2. ...
+  
+  ---
+  
+  ## 📝 总结
+  
+  <总结内容>
+  
+  ## 🎯 建议行动
+  
+  1. **立即修复**: 高危漏洞、严重 lint 错误
+  2. **尽快修复**: 中危漏洞、lint 警告
+  3. **建议优化**: 性能问题
+  ```
+  
+  ---
+  
+  ## 📤 输出格式
+  
+  ```json
+  {
+    "score": 85,
+    "issues": {
+      "lint_errors": [...],
+      "lint_warnings": [...],
+      "security_vulnerabilities": [...],
+      "performance_issues": [...]
+    },
+    "summary": {
+      "total_issues": 15,
+      "critical": 2,
+      "high": 3,
+      "medium": 5,
+      "low": 5
+    },
+    "report_file": "quality-report.md"
+  }
+  ```
+
+# 执行配置
+execute:
+  type: agent
+  agent: codex
+  temperature: 0.2
+  output:
+    content:
+      score: score
+      issues: issues
+      report: report
+    file:
+      path: "{{project_path}}/quality-report.md"
+      content: report_file

package/src/tools/definitions/std/quality/debug-systematic.yml

@@ -0,0 +1,163 @@
+# debug-systematic.yml - 系统性调试
+# ============================================================================
+# 能力类型: quality（步骤型）
+# 来源: Superpowers - systematic-debugging
+# 版本: 2026-03-28 (需手动同步)
+# 执行方式: 调用 Agent 进行系统性调试
+# 铁律: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
+# 用途: 系统性地定位和修复问题
+# ============================================================================
+
+name: debug-systematic
+stage: verify
+description: |
+  Systematic debugging workflow - find root cause before fixing
+
+category: quality
+version: 1.0.0
+
+iron_law:
+  rule: "NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST"
+  message: "在修复问题之前，必须先找到根本原因"
+
+inputs:
+  - name: error_message
+    type: string
+    required: true
+    description: 错误信息
+  
+  - name: code_path
+    type: path
+    required: true
+    description: 代码路径
+  
+  - name: context
+    type: ProjectContext
+    description: 项目上下文
+  
+  - name: reproduction_steps
+    type: array
+    required: false
+    description: 重现步骤
+    default: []
+
+outputs:
+  - name: root_cause
+    type: object
+    description: 根本原因分析
+  
+  - name: fix_suggestion
+    type: object
+    description: 修复建议
+  
+  - name: verification_steps
+    type: array
+    description: 验证步骤
+
+execute:
+  type: agent
+  prompt: |
+    你是一个系统性调试专家。
+    
+    ## 任务
+    系统性地分析问题，找到根本原因后再提出修复方案。
+    
+    ## 错误信息
+    ```
+    {{inputs.error_message}}
+    ```
+    
+    ## 代码路径
+    {{inputs.code_path}}
+    
+    ## 重现步骤
+    {{inputs.reproduction_steps}}
+    
+    ## 调试流程（必须严格按顺序执行）
+    
+    ### Phase 1: 根本原因调查
+    1. **仔细阅读错误消息**
+       - 提取关键信息：错误类型、位置、相关变量
+       - 不要跳过任何细节
+    
+    2. **稳定重现问题**
+       - 确认重现步骤
+       - 记录每次重现的条件
+    
+    3. **检查最近的更改**
+       - 查看 git log
+       - 找到引入问题的 commit
+    
+    4. **跟踪数据流**
+       - 从错误位置向上追踪
+       - 找到数据的来源和变化
+    
+    ### Phase 2: 模式分析
+    1. **找到工作的例子**
+       - 搜索类似的正常工作代码
+       - 对比差异
+    
+    2. **对比差异**
+       - 逐行比较工作代码和问题代码
+       - 找出关键差异点
+    
+    ### Phase 3: 假设测试
+    1. **形成一个清晰的假设**
+       - "问题是因为 X 导致 Y"
+       - 假设必须可验证
+    
+    2. **设计最小测试验证/证伪**
+       - 编写最小测试用例
+       - 确认假设正确或错误
+    
+    ### Phase 4: 修复验证
+    1. **修复根本原因，不是症状**
+       - 不要只是修复错误消息
+       - 解决导致错误的根本原因
+    
+    2. **写测试覆盖此 bug**
+       - 防止回归
+       - 文档化问题
+    
+    3. **验证无回归**
+       - 运行所有相关测试
+       - 确认没有引入新问题
+    
+    ## 铁律
+    ⚠️ **NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST**
+    
+    - 禁止在没有找到根本原因的情况下修复问题
+    - 禁止只修复症状而不解决根本原因
+    - 禁止跳过测试验证
+    
+    ## 输出格式
+    
+    ```json
+    {
+      "root_cause": {
+        "type": "数据流错误",
+        "location": "src/utils/parser.ts:42",
+        "description": "变量 X 在条件 Y 下未正确初始化",
+        "evidence": [
+          "日志显示 X 为 undefined",
+          "条件 Y 在步骤 3 触发"
+        ]
+      },
+      "fix_suggestion": {
+        "file": "src/utils/parser.ts",
+        "line": 42,
+        "before": "const result = process(data);",
+        "after": "const result = data ? process(data) : defaultValue;",
+        "explanation": "在调用 process 前检查 data 是否存在"
+      },
+      "verification_steps": [
+        "npm test",
+        "手动重现原问题，确认已修复",
+        "检查边界情况"
+      ]
+    }
+    ```
+    
+    开始系统性调试。记住：先找根本原因，再修复！
+  
+  temperature: 0.3

package/src/tools/definitions/std/quality/handle-feedback.yml

@@ -0,0 +1,108 @@
+# handle-feedback.yml - 处理审查反馈
+# ============================================================================
+# 能力类型: quality（步骤型）
+# 来源: Superpowers - receiving-code-review
+# 版本: 2026-03-28 (需手动同步)
+# 执行方式: 调用 Agent 处理代码审查反馈
+# 用途: 处理代码审查反馈，修改代码并回复
+# ============================================================================
+
+name: handle-feedback
+stage: verify
+description: |
+  Handle code review feedback - process comments and make necessary changes
+
+category: quality
+version: 1.0.0
+
+inputs:
+  - name: feedback
+    type: object
+    required: true
+    description: 审查反馈（包含 comments, suggestions）
+  
+  - name: code_path
+    type: path
+    required: true
+    description: 代码路径
+  
+  - name: context
+    type: ProjectContext
+    description: 项目上下文
+
+outputs:
+  - name: changes
+    type: array
+    description: 修改列表
+  
+  - name: replies
+    type: array
+    description: 回复列表
+  
+  - name: resolved_count
+    type: number
+    description: 已解决的反馈数
+
+execute:
+  type: agent
+  prompt: |
+    你是一个代码审查反馈处理专家。
+    
+    ## 任务
+    处理以下代码审查反馈，做出必要的修改并回复。
+    
+    ## 审查反馈
+    {{inputs.feedback}}
+    
+    ## 代码路径
+    {{inputs.code_path}}
+    
+    ## 处理原则
+    
+    ### 1. 优先级判断
+    - 🔴 **必须修改**: 安全问题、性能问题、严重 bug
+    - 🟡 **建议修改**: 代码风格、可读性、最佳实践
+    - 🟢 **可选修改**: 个人偏好、微小优化
+    
+    ### 2. 回复策略
+    - 明确说明修改内容和原因
+    - 如果不修改，解释原因
+    - 感谢审查者的建议
+    
+    ### 3. 修改原则
+    - **最小化修改**: 只修改必要的部分
+    - **保持一致**: 与现有代码风格保持一致
+    - **测试验证**: 修改后运行相关测试
+    
+    ## 铁律
+    - NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
+    - 修改前必须理解问题根本原因
+    - 修改后必须验证测试通过
+    
+    ## 输出格式
+    
+    ```json
+    {
+      "changes": [
+        {
+          "file": "path/to/file",
+          "line": 42,
+          "type": "modify",
+          "before": "原代码",
+          "after": "修改后代码",
+          "reason": "修改原因"
+        }
+      ],
+      "replies": [
+        {
+          "comment_id": "xxx",
+          "reply": "感谢建议，已在 xxx 中修改"
+        }
+      ],
+      "resolved_count": 5
+    }
+    ```
+    
+    开始处理反馈。
+  
+  temperature: 0.3

package/src/tools/definitions/std/quality/review-code.yml

@@ -0,0 +1,128 @@
+# review-code.yml
+name: review-code
+stage: verify
+description: |
+  代码审查（智能版本）。
+  
+  通过 fingerprint 工具区分变更级别：
+  - STRUCTURAL: 深度审查（架构、依赖、测试）
+  - COSMETIC: 快速审查（格式、注释）
+  - NONE: 跳过
+  
+  节省审查时间 30-50%。
+category: quality
+version: 3.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.3
+
+# 可用工具
+tools:
+  - file-read
+  - file-write
+  - code/fingerprint
+  - npm-build
+  - npm-test
+
+# Prompt
+prompt: |
+  你是代码审查专家。使用智能策略审查代码。
+  
+  ## 输入
+  
+  项目目录：{{input}}
+  
+  ## Step 0: 智能变更检测
+  
+  ```bash
+  # 获取最近的变更
+  CHANGED_FILES=$(git diff --name-only HEAD~1 2>/dev/null || find . -name "*.ts" -o -name "*.tsx" | head -20)
+  
+  # 对每个文件检测变更级别
+  for FILE in $CHANGED_FILES; do
+    fingerprint.sh "$FILE" "." "previous"
+  done
+  ```
+  
+  根据变更级别选择审查策略：
+  
+  | 变更级别 | 审查策略 | 检查项 |
+  |---------|---------|--------|
+  | STRUCTURAL | 深度审查 | 架构、依赖、安全、测试 |
+  | COSMETIC | 快速审查 | 格式、注释、文档 |
+  | NONE | 跳过 | - |
+  
+  ## Step 1: 扫描代码
+  
+  ```bash
+  # 扫描所有代码文件
+  find . -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" | head -50
+  ```
+  
+  ## Step 2: 运行 Lint
+  
+  ```bash
+  # 如果有 ESLint
+  npm run lint 2>/dev/null || npx eslint . --ext .ts,.tsx 2>/dev/null || echo "No ESLint"
+  ```
+  
+  ## Step 3: 安全扫描
+  
+  ```bash
+  # 检查敏感信息
+  grep -r "password\|secret\|api_key\|token" --include="*.ts" --include="*.js" . | grep -v ".env.example" || echo "No secrets found"
+  ```
+  
+  ## Step 4: 自动修复
+  
+  对于发现的问题，直接修复代码：
+  - 代码风格问题：运行 `npm run lint -- --fix`
+  - 简单 Bug：直接修改代码
+  - 复杂问题：记录到 review.md
+  
+  ## Step 5: 输出报告
+  
+  创建 `review.md`：
+  ```markdown
+  # 代码审查报告
+  
+  ## 变更级别统计
+  
+  | 级别 | 文件数 | 审查策略 |
+  |------|--------|---------|
+  | STRUCTURAL | X | 深度审查 |
+  | COSMETIC | Y | 快速审查 |
+  | NONE | Z | 跳过 |
+  
+  ## 总体评分: X/10
+  
+  ## 已修复问题
+  - [x] 问题1
+  - [x] 问题2
+  
+  ## 需人工处理
+  - [ ] 复杂问题1（原因：xxx）
+  
+  ## 建议
+  - 建议1
+  ```
+  
+  ## 输出标准
+  
+  - 修复所有可自动修复的问题
+  - 记录无法自动修复的问题
+  - 输出 review.md
+
+# 输入参数
+inputs:
+  - name: project_path
+    type: path
+    required: true
+    description: 项目路径
+
+# 输出
+outputs:
+  - name: review.md
+    type: file
+    description: 审查报告