@dommaker/harness 0.9.0 → 0.10.0

package/dist/tools/definitions/std/analysis/analyze-impact.yml

@@ -0,0 +1,78 @@
+# analyze-impact.yml
+name: analyze-impact
+stage: plan
+description: 分析代码变更影响范围
+agent: codex
+temperature: 0.3
+
+tools:
+  - file-read
+  - git-diff
+
+prompt: |
+  你是代码影响分析专家。分析代码变更的影响范围。
+  
+  {{input}}
+  
+  ## 任务
+  
+  ### 1. 分析变更
+  
+  检查最近的代码变更：
+  ```bash
+  git diff --name-only HEAD~5 2>/dev/null || echo "no git"
+  ```
+  
+  ### 2. 影响范围分析
+  
+  分析每个变更文件：
+  - 谁依赖这个文件？
+  - 这个文件依赖谁？
+  - 变更是破坏性还是兼容的？
+  
+  ### 3. 风险评估
+  
+  评估变更风险：
+  - **低风险**：文档、注释、样式
+  - **中风险**：业务逻辑、工具函数
+  - **高风险**：核心模块、API 接口、数据库模型
+  
+  ### 4. 输出报告
+  
+  创建 `impact-report.md`：
+  ```markdown
+  ## 影响分析报告
+  
+  ### 变更文件
+  - file1.ts (高风险)
+  - file2.ts (中风险)
+  
+  ### 受影响模块
+  - 模块A：依赖 file1.ts
+  - 模块B：依赖 file1.ts
+  
+  ### 风险等级
+  **高风险** - 涉及核心 API
+  
+  ### 建议
+  1. 需要回归测试模块A、模块B
+  2. 建议增加集成测试
+  ```
+  
+  ## 原则
+  
+  - 宁可高估影响范围
+  - 关注跨模块依赖
+  - 识别潜在的破坏性变更
+
+inputs:
+  - name: graph
+    type: KnowledgeGraph
+    description: 知识图谱（可选）
+  
+  - name: changes
+    type: object
+    description: 变更信息（可选）
+
+outputs:
+  - impact-report.md

package/dist/tools/definitions/std/analysis/analyze-requirements.yml

@@ -0,0 +1,105 @@
+# analyze-requirements.yml
+name: analyze-requirements
+stage: plan
+description: 分析需求，生成标准化需求文档
+category: analysis
+version: 3.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.3
+
+# 可用工具
+tools:
+  - file-read
+  - file-write
+
+# Prompt
+prompt: |
+  你是一个需求分析师。分析以下需求：
+  
+  {{requirement}}
+  
+  {{#if context}}
+  ## 已知上下文
+  
+  ```json
+  {{{context}}}
+  ```
+  
+  结合上下文，确保需求文档符合约束条件。
+  {{/if}}
+  
+  ## 任务
+  
+  生成 `requirements.md` 文件，**严格遵循以下格式**：
+  
+  ```markdown
+  # 需求文档
+  
+  ## 项目概述
+  <一句话描述项目目标>
+  
+  ## 功能点列表
+  
+  ### P0 (必须实现)
+  - [P0] <功能名称>
+    - 描述: <功能描述>
+    - 验收: <验收标准>
+  
+  ### P1 (重要推荐)
+  - [P1] <功能名称>
+    - 描述: <功能描述>
+    - 验收: <验收标准>
+  
+  ### P2 (可选优化)
+  - [P2] <功能名称>
+    - 描述: <功能描述>
+    - 验收: <验收标准>
+  
+  ## 技术约束
+  
+  | 约束项 | 要求 |
+  |--------|------|
+  | 前端框架 | <框架名称> |
+  | 后端 | <有/无> |
+  | 数据存储 | <存储方式> |
+  | 其他 | <其他约束> |
+  
+  ## 非功能需求
+  
+  - 性能: <性能要求>
+  - 兼容性: <兼容性要求>
+  - 其他: <其他非功能需求>
+  
+  ## 风险点
+  
+  | 风险 | 影响 | 建议 |
+  |------|------|------|
+  | <风险描述> | <影响程度> | <缓解建议> |
+  ```
+  
+  ## 格式要求（重要！）
+  
+  1. 功能点必须以 `- [P0/P1/P2]` 开头，便于程序解析
+  2. 每个功能点包含 `描述:` 和 `验收:` 两行
+  3. 技术约束用表格格式，便于提取
+  4. 不要添加额外内容，保持格式一致
+
+# 输入参数
+inputs:
+  - name: requirement
+    type: string
+    required: true
+    description: 需求描述
+  
+  - name: context
+    type: object
+    required: false
+    description: 上下文信息（项目配置、会议记录、澄清结果）
+
+# 输出
+outputs:
+  - name: requirements.md
+    type: file
+    description: 标准化需求文档

package/dist/tools/definitions/std/analysis/brainstorm-options.yml

@@ -0,0 +1,106 @@
+# brainstorm-options.yml
+name: brainstorm-options
+stage: plan
+description: 方案发散，当需求不明确或需要探索时提供多个候选方案
+category: analysis
+version: 1.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.7
+
+# 可用工具
+tools:
+  - file-read
+  - web-search
+
+# Prompt
+prompt: |
+  你是一个方案策划专家。针对用户的问题，发散思考多个候选方案，帮助用户做出决策。
+  
+  ## 用户问题
+  
+  {{problem}}
+  
+  {{#if context}}
+  ## 已知上下文
+  
+  ```json
+  {{{context}}}
+  ```
+  
+  结合上下文，确保方案符合约束条件。
+  {{/if}}
+  
+  ## 任务
+  
+  输出 **候选方案列表**，格式如下：
+  
+  ```markdown
+  # 方案对比
+  
+  ## 问题分析
+  
+  <问题的核心挑战>
+  
+  ## 候选方案
+  
+  ### 方案 A: <方案名称>
+  
+  | 维度 | 说明 |
+  |------|------|
+  | 核心思路 | <一句话描述> |
+  | 实现复杂度 | ⭐~⭐⭐⭐⭐⭐ |
+  | 时间成本 | <预估时间> |
+  | 优点 | <主要优点> |
+  | 缺点 | <主要缺点> |
+  | 适用场景 | <最适合什么情况> |
+  
+  ### 方案 B: <方案名称>
+  
+  （同上格式）
+  
+  ### 方案 C: <方案名称>（可选）
+  
+  （同上格式）
+  
+  ## 推荐方案
+  
+  **推荐: 方案 X**
+  
+  理由:
+  - <推荐理由 1>
+  - <推荐理由 2>
+  
+  ## 决策点
+  
+  用户需要确认以下决策点：
+  1. <决策点>
+  2. <决策点>
+  ```
+  
+  ## 原则
+  
+  1. 提供 2-3 个方案，不多不少
+  2. 每个方案要具体可行，不是空泛概念
+  3. 明确对比维度，便于决策
+  4. 给出推荐，但保留用户选择权
+  5. 列出决策点，引导用户确认
+
+# 输入参数
+inputs:
+  - name: problem
+    type: string
+    required: true
+    description: 待解决的问题
+  
+  - name: context
+    type: object
+    required: false
+    description: 上下文信息（项目配置、技术约束、历史决策）
+
+# 输出
+outputs:
+  - name: options.md
+    type: content
+    description: 候选方案列表

package/dist/tools/definitions/std/analysis/build-graph.yml

@@ -0,0 +1,154 @@
+name: build-graph
+stage: plan
+description: |
+  构建代码库知识图谱。
+  
+  扫描项目代码，提取：
+  - 组件（函数、类、模块）
+  - 关系（调用、导入、继承）
+  - 架构层级
+  - 复杂度评估
+  
+  用途：
+  - 项目结构理解
+  - 代码导航
+  - 影响分析
+  - 架构可视化
+
+agent: codex
+timeout: 600  # 10 分钟
+
+inputs:
+  - name: project_path
+    type: string
+    required: true
+    description: 项目根路径
+    
+  - name: languages
+    type: array
+    required: false
+    description: |
+      要分析的语言列表（可选，自动检测）。
+      支持：typescript, javascript, python, go, rust, java, cpp, c, ruby, php
+      
+  - name: exclude_patterns
+    type: array
+    required: false
+    default: ["node_modules", "dist", "build", ".git", "vendor"]
+    description: 排除的目录模式
+    
+  - name: output_path
+    type: string
+    required: false
+    default: ".agent/knowledge-graph.json"
+    description: 知识图谱输出路径
+
+outputs:
+  - name: graph
+    type: object
+    description: 知识图谱对象
+    
+  - name: nodes_count
+    type: number
+    description: 节点总数
+    
+  - name: edges_count
+    type: number
+    description: 边总数
+    
+  - name: layers_count
+    type: number
+    description: 层级总数
+    
+  - name: report
+    type: string
+    description: 分析报告
+
+prompt: |
+  构建项目 {{project_path}} 的知识图谱。
+  
+  ## 任务
+  
+  1. 扫描项目结构
+     - 识别主要目录和文件
+     - 检测使用的语言和框架
+     - 排除：{{exclude_patterns}}
+  
+  2. 解析代码文件
+     - 使用 Tree-sitter 提取 AST
+     - 识别函数、类、模块
+     - 提取导入导出关系
+  
+  3. 构建关系图
+     - 调用关系 (calls)
+     - 导入关系 (imports)
+     - 继承关系 (inherits)
+     - 包含关系 (contains)
+  
+  4. 识别架构层级
+     - 分析目录结构
+     - 推断层级划分（如：presentation、business、data）
+     - 关联节点到层级
+  
+  5. 评估复杂度
+     - 函数行数
+     - 参数数量
+     - 嵌套深度
+     - 依赖数量
+  
+  6. 生成知识图谱
+  
+  ## 输出格式
+  
+  保存到 {{output_path}}，格式如下：
+  
+  ```json
+  {
+    "version": "1.0.0",
+    "project": {
+      "name": "my-project",
+      "languages": ["typescript", "python"],
+      "frameworks": ["react", "fastapi"],
+      "description": "...",
+      "analyzedAt": "2026-04-02T...",
+      "gitCommitHash": "abc123..."
+    },
+    "nodes": [
+      {
+        "id": "func-001",
+        "type": "function",
+        "name": "handleSubmit",
+        "filePath": "src/components/Form.tsx",
+        "lineRange": [10, 25],
+        "summary": "处理表单提交",
+        "tags": ["form", "submit"],
+        "complexity": "moderate"
+      }
+    ],
+    "edges": [
+      {
+        "source": "func-001",
+        "target": "func-002",
+        "type": "calls",
+        "direction": "forward",
+        "weight": 0.8
+      }
+    ],
+    "layers": [
+      {
+        "id": "layer-001",
+        "name": "presentation",
+        "description": "前端展示层",
+        "nodeIds": ["func-001", "func-003"]
+      }
+    ],
+    "tour": []
+  }
+  ```
+
+retry:
+  max_attempts: 3
+  backoff: exponential
+  initial_delay: 10000
+
+version: "1.0.0"

package/dist/tools/definitions/std/analysis/clarify-requirements.yml

@@ -0,0 +1,90 @@
+# clarify-requirements.yml
+name: clarify-requirements
+stage: plan
+description: 需求澄清，当用户输入模糊时追问关键信息
+category: analysis
+version: 1.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.5
+
+# 可用工具
+tools:
+  - file-read
+
+# Prompt
+prompt: |
+  你是一个需求澄清专家。用户的需求描述可能不完整或模糊，你的任务是：
+  
+  1. 分析用户输入，识别缺失的关键信息
+  2. 提出针对性的澄清问题
+  3. 不要假设，只追问必要的决策点
+  
+  ## 用户需求
+  
+  {{requirement}}
+  
+  {{#if context}}
+  ## 已知上下文
+  
+  ```json
+  {{{context}}}
+  ```
+  
+  结合上下文，避免重复已知信息。
+  {{/if}}
+  
+  ## 任务
+  
+  输出 **澄清问题列表**，格式如下：
+  
+  ```markdown
+  # 需求澄清
+  
+  ## 已理解的部分
+  - <已明确的需求点>
+  - <已明确的需求点>
+  
+  ## 需要澄清的问题
+  
+  ### 🔴 关键决策（必须确认）
+  1. **<问题主题>**
+     - 背景: <为什么这个问题重要>
+     - 选项: <可选方案列表>
+     - 推荐: <推荐选择及理由>
+  
+  ### 🟡 重要细节（建议确认）
+  1. **<问题主题>**
+     - 背景: <为什么这个问题重要>
+     - 默认: <默认选择>
+  
+  ### 🟢 可延后决策
+  1. **<问题主题>**
+     - 说明: <为什么可以延后>
+  ```
+  
+  ## 原则
+  
+  1. 问题要具体，避免开放式问题
+  2. 提供选项，帮助用户快速决策
+  3. 标注优先级，让用户知道哪些必须确认
+  4. 结合上下文，避免重复已知信息
+
+# 输入参数
+inputs:
+  - name: requirement
+    type: string
+    required: true
+    description: 用户需求描述
+  
+  - name: context
+    type: object
+    required: false
+    description: 上下文信息（项目配置、会议记录、历史决策）
+
+# 输出
+outputs:
+  - name: clarification.md
+    type: content
+    description: 澄清问题列表

package/dist/tools/definitions/std/analysis/detect-context.yml

@@ -0,0 +1,109 @@
+# detect-context.yml
+name: detect-context
+stage: plan
+description: |
+  自动检测项目类型（智能版本）。
+  
+  通过 register-language 工具支持 24 种语言：
+  TypeScript, JavaScript, Python, Go, Rust, Java, C++, C,
+  Ruby, PHP, Swift, Kotlin, Scala, C#, F#, Dart, Elixir,
+  Erlang, Haskell, Lua, Perl, R, SQL, Bash, PowerShell,
+  Vue, Svelte, CSS, SCSS, HTML, JSON, YAML, Markdown
+  
+  核心功能：
+  - 自动识别语言和框架
+  - 注册语言解析配置
+  - 输出结构化项目上下文
+
+agent: codex
+temperature: 0.2
+
+tools:
+  - file-read
+  - code/register-language
+
+prompt: |
+  你是项目分析专家。检测项目的技术栈和配置。
+  
+  {{input}}
+  
+  ## Step 0: 注册已知语言
+  
+  ```bash
+  # 查看支持的语言
+  register-language.sh --list
+  
+  # 显示常用语言配置
+  register-language.sh --show typescript
+  register-language.sh --show python
+  register-language.sh --show go
+  ```
+  
+  ## Step 1: 检测语言和框架
+  
+  检查关键文件：
+  - `package.json` → Node.js / TypeScript / JavaScript
+  - `pyproject.toml` / `requirements.txt` → Python
+  - `go.mod` → Go
+  - `Cargo.toml` → Rust
+  - `pom.xml` / `build.gradle` → Java
+  - `composer.json` → PHP
+  
+  ## Step 2: 识别框架
+  
+  从依赖推断：
+  - React/Vue/Next.js/Svelte → 前端框架
+  - Express/Fastify/NestJS → Node.js 后端
+  - Django/FastAPI/Flask → Python 后端
+  - Gin/Echo → Go 后端
+  - Actix/Rocket → Rust 后端
+  
+  ## Step 3: 注册项目语言
+  
+  根据检测结果注册语言：
+  ```bash
+  # 示例：注册 TypeScript
+  register-language.sh typescript
+  
+  # 示例：注册自定义扩展名
+  register-language.sh typescript ".ts,.tsx,.mts"
+  ```
+  
+  ## Step 4: 输出项目上下文
+  
+  创建 `project-context.json`：
+  ```json
+  {
+    "language": "TypeScript",
+    "languages": ["TypeScript", "JavaScript"],
+    "framework": "Express",
+    "frameworks": ["Express", "Prisma", "Jest"],
+    "type": "backend",
+    "packageManager": "npm",
+    "hasTests": true,
+    "hasDocker": false,
+    "registeredLanguages": [
+      {
+        "name": "typescript",
+        "extensions": [".ts", ".tsx", ".mts", ".cts"],
+        "features": ["functions", "classes", "interfaces", "types", "enums", "imports", "exports"]
+      }
+    ]
+  }
+  ```
+  
+  ## 原则
+  
+  - 只检测，不修改代码
+  - 基于文件证据推断
+  - 不确定时标注 unknown
+  - 注册检测到的所有语言
+
+inputs:
+  - name: projectPath
+    type: string
+    default: "."
+    description: 项目路径
+
+outputs:
+  - project-context.json