@dommaker/harness 0.9.0 → 0.10.0

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

@@ -0,0 +1,125 @@
+name: detect-layers
+stage: plan
+description: |
+  检测项目的架构层级结构。
+  
+  通过分析目录结构和依赖关系，自动识别：
+  - 表现层（presentation）
+  - 业务层（business）
+  - 数据层（data）
+  - 基础设施层（infrastructure）
+  
+  用途：
+  - 架构分析
+  - 层级合规检查
+  - 依赖方向验证
+
+agent: codex
+timeout: 300  # 5 分钟
+
+inputs:
+  - name: project_path
+    type: string
+    required: true
+    description: 项目根路径
+    
+  - name: knowledge_graph_path
+    type: string
+    required: false
+    description: 知识图谱文件路径
+    
+  - name: custom_layers
+    type: object
+    required: false
+    description: |
+      自定义层级配置（可选）
+      ```yaml
+      layers:
+        - name: frontend
+          patterns: ["src/components/*", "src/pages/*"]
+        - name: backend
+          patterns: ["src/api/*", "src/services/*"]
+      ```
+
+outputs:
+  - name: layers
+    type: array
+    description: 检测到的层级列表
+    
+  - name: layer_nodes
+    type: object
+    description: 每个层级包含的节点 ID
+    
+  - name: violations
+    type: array
+    description: 层级违规（如数据层调用表现层）
+    
+  - name: report
+    type: string
+    description: Markdown 格式的层级报告
+
+prompt: |
+  检测项目 {{project_path}} 的架构层级结构。
+  
+  ## 任务
+  
+  1. 加载知识图谱
+     - 路径：{{knowledge_graph_path}} 或 .agent/knowledge-graph.json
+     - 如果不存在，先扫描项目结构
+  
+  2. 分析目录结构
+     - 常见模式识别：
+       - `components/`, `pages/`, `views/` → 表现层
+       - `services/`, `usecases/`, `domain/` → 业务层
+       - `repositories/`, `models/`, `data/` → 数据层
+       - `infrastructure/`, `config/`, `utils/` → 基础设施层
+  
+  3. 分析依赖关系
+     - 从知识图谱获取节点和边
+     - 计算依赖方向
+     - 识别层级边界
+  
+  4. 检测层级违规
+     - 数据层不应调用表现层
+     - 基础设施层不应依赖业务层
+     - 记录所有违规依赖
+  
+  5. 生成报告
+  
+  ## 输出格式
+  
+  ```json
+  {
+    "layers": [
+      {
+        "id": "layer-001",
+        "name": "presentation",
+        "description": "前端展示层",
+        "patterns": ["src/components/*", "src/pages/*"],
+        "nodeIds": ["func-001", "func-002"],
+        "stats": {
+          "nodes": 15,
+          "imports": 23,
+          "exports": 12
+        }
+      }
+    ],
+    "violations": [
+      {
+        "from": "data/UserRepository",
+        "to": "presentation/UserCard",
+        "type": "upward_dependency",
+        "severity": "error",
+        "message": "数据层不应依赖表现层"
+      }
+    ]
+  }
+  ```
+
+tools:
+  - file-read
+  - shell-execute
+
+temperature: 0.5
+
+version: "1.0.0"

package/dist/tools/definitions/definitions/std/analysis/generate-tour.yml

@@ -0,0 +1,102 @@
+name: generate-tour
+stage: plan
+description: |
+  生成项目导览。
+  
+  为新开发者创建学习路径：
+  - 从简单到复杂的组件介绍
+  - 架构层级概览
+  - 语言/框架特定的说明
+  
+  用途：
+  - 新人入职
+  - 项目交接
+  - 学习材料生成
+
+agent: codex
+timeout: 300  # 5 分钟
+
+inputs:
+  - name: project_path
+    type: string
+    required: true
+    description: 项目根路径
+    
+  - name: knowledge_graph_path
+    type: string
+    required: false
+    description: 知识图谱文件路径
+    
+  - name: target_audience
+    type: string
+    required: false
+    default: "junior"
+    description: |
+      目标受众：
+      - "junior" - 初级开发者
+      - "senior" - 高级开发者
+      - "non-technical" - 非技术人员
+      
+  - name: focus_areas
+    type: array
+    required: false
+    description: 重点关注领域（如：["auth", "api"]）
+
+outputs:
+  - name: tour
+    type: array
+    description: 导览步骤列表
+    
+  - name: tour_count
+    type: number
+    description: 导览步骤数量
+    
+  - name: report
+    type: string
+    description: Markdown 格式的导览文档
+
+prompt: |
+  为项目 {{project_path}} 生成学习导览。
+  
+  ## 任务
+  
+  1. 加载知识图谱
+     - 路径：{{knowledge_graph_path}} 或 .agent/knowledge-graph.json
+  
+  2. 分析组件结构
+     - 识别入口点
+     - 追踪核心流程
+     - 确定依赖关系
+  
+  3. 生成学习路径
+     - 从简单到复杂
+     - 按层级组织
+     - 关联相关组件
+  
+  4. 添加说明
+     - 每个组件的用途
+     - 关键代码片段
+     - 语言/框架特定提示
+  
+  ## 输出格式
+  
+  ```json
+  {
+    "tour": [
+      {
+        "order": 1,
+        "title": "项目入口",
+        "description": "从 main.ts 开始理解项目启动流程",
+        "nodeIds": ["func-001", "func-002"],
+        "languageLesson": "TypeScript 项目通常从 main.ts 或 index.ts 启动..."
+      }
+    ]
+  }
+  ```
+
+retry:
+  max_attempts: 2
+  backoff: exponential
+  initial_delay: 5000
+
+version: "1.0.0"

package/dist/tools/definitions/definitions/std/analysis/search-enhance.yml

@@ -0,0 +1,105 @@
+name: search-enhance
+stage: plan
+description: |
+  增强搜索能力，支持模糊搜索和语义搜索。
+  
+  使用 Fuse.js 进行模糊匹配：
+  - 组件名搜索
+  - 文件路径搜索
+  - 代码内容搜索
+  
+  用途：
+  - 快速定位组件
+  - 代码导航
+  - 重构影响分析
+
+agent: codex
+timeout: 180  # 3 分钟
+
+inputs:
+  - name: project_path
+    type: string
+    required: true
+    description: 项目根路径
+    
+  - name: query
+    type: string
+    required: true
+    description: 搜索查询
+    
+  - name: search_type
+    type: string
+    required: false
+    default: "all"
+    description: |
+      搜索类型：
+      - "components" - 只搜索组件
+      - "files" - 只搜索文件
+      - "code" - 只搜索代码内容
+      - "all" - 全部搜索
+      
+  - name: limit
+    type: number
+    required: false
+    default: 20
+    description: 返回结果数量限制
+
+outputs:
+  - name: results
+    type: array
+    description: 搜索结果列表
+    
+  - name: total
+    type: number
+    description: 总结果数
+    
+  - name: index_path
+    type: string
+    description: 搜索索引文件路径
+
+prompt: |
+  在项目 {{project_path}} 中搜索 "{{query}}"。
+  
+  ## 任务
+  
+  1. 加载或构建搜索索引
+     - 索引路径：.agent/search-index.json
+     - 包含：组件名、文件路径、函数名、类名
+  
+  2. 执行模糊搜索
+     - 使用 Fuse.js 算法
+     - 支持拼写错误容忍
+     - 支持部分匹配
+  
+  3. 过滤结果
+     - 按 search_type 过滤
+     - 按相关度排序
+  
+  4. 返回结果
+  
+  ## 输出格式
+  
+  ```json
+  {
+    "results": [
+      {
+        "type": "component",
+        "name": "UserCard",
+        "filePath": "src/components/UserCard.tsx",
+        "line": 1,
+        "score": 0.95,
+        "matches": ["UserCard", "User Card"],
+        "context": "export function UserCard({ user }) { ... }"
+      }
+    ],
+    "total": 5
+  }
+  ```
+
+tools:
+  - file-read
+  - shell-execute
+
+temperature: 0.3
+
+version: "1.0.0"

package/dist/tools/definitions/definitions/std/backlog/add.yml

@@ -0,0 +1,51 @@
+# backlog/add - 添加待办项
+#
+# 输入：
+#   - project_path: 项目路径
+#   - item: 待办项对象
+#
+# 输出：
+#   - item: 创建的待办项
+#   - backlog_path: backlog 文件路径
+
+id: backlog/add
+stage: plan
+name: 添加待办项
+description: 向项目 Backlog 添加新的待办项
+category: backlog
+execute:
+  type: builtin
+  handler: backlog/add
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  item:
+    type: object
+    description: 待办项内容
+    required: true
+    properties:
+      type:
+        type: string
+        enum: [bug, feature, enhancement, performance, tech-debt, patch]
+      title:
+        type: string
+      priority:
+        type: string
+        enum: [critical, high, medium, low]
+      labels:
+        type: array
+      description:
+        type: string
+      error_log:
+        type: string
+
+outputs:
+  - name: item
+    type: object
+    description: 创建的待办项（含 ID）
+  - name: backlog_path
+    type: string
+    description: backlog.yml 文件路径

package/dist/tools/definitions/definitions/std/backlog/decide.yml

@@ -0,0 +1,39 @@
+# backlog/decide - 智能决策下一个待处理项
+#
+# 输入：
+#   - project_path: 项目路径
+#
+# 输出：
+#   - recommendation: 推荐的待办项
+#   - suggested_workflow: 建议使用的工作流
+#   - reason: 推荐理由
+#   - queue: 待处理队列（前 5 个）
+
+id: backlog/decide
+stage: plan
+name: 智能决策
+description: 根据优先级和类型推荐下一个待处理项
+category: backlog
+execute:
+  type: builtin
+  handler: backlog/decide
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+
+outputs:
+  - name: recommendation
+    type: object
+    description: 推荐的待办项
+  - name: suggested_workflow
+    type: string
+    description: 建议使用的工作流 ID
+  - name: reason
+    type: string
+    description: 推荐理由
+  - name: queue
+    type: array
+    description: 待处理队列（前 5 个）

package/dist/tools/definitions/definitions/std/backlog/github-sync.yml

@@ -0,0 +1,161 @@
+# backlog/github-sync - GitHub Issues 同步
+# ============================================================================
+# 功能：backlog.yml 与 GitHub Issues 双向同步
+# 设计：AW-015
+# ============================================================================
+#
+# 输入：
+#   - project_path: 项目路径
+#   - direction: 同步方向 (to_github | from_github | bidirectional)
+#   - conflict_strategy: 冲突策略（可选）
+#
+# 输出：
+#   - sync_result: 同步结果统计
+#   - conflicts: 冲突列表（如有）
+#
+# 冲突策略：
+#   - github_wins: GitHub 优先
+#   - backlog_wins: backlog.yml 优先
+#   - timestamp_wins: 时间戳优先
+#   - human_confirm: 人工确认
+#   - ai_merge: AI 智能合并（推荐）
+#   - layered: 分层策略（不同字段不同策略）
+#
+# 分层策略默认配置：
+#   status: github_wins
+#   title: ai_merge
+#   priority: timestamp_wins
+#   labels: merge
+#   description: human_confirm
+
+id: backlog/github-sync
+stage: plan
+name: GitHub Issues 同步
+description: backlog.yml 与 GitHub Issues 双向同步
+category: backlog
+execute:
+  type: builtin
+  handler: backlog/github-sync
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  
+  direction:
+    type: string
+    description: 同步方向
+    enum: [to_github, from_github, bidirectional]
+    default: bidirectional
+  
+  conflict_strategy:
+    type: string
+    description: 冲突处理策略
+    enum: [github_wins, backlog_wins, timestamp_wins, human_confirm, ai_merge, layered]
+    default: layered
+  
+  # 分层策略配置（仅 layered 模式）
+  layered_config:
+    type: object
+    description: 分层策略字段级配置
+    default:
+      status: github_wins
+      title: ai_merge
+      priority: timestamp_wins
+      labels: merge
+      description: human_confirm
+
+outputs:
+  - name: sync_result
+    type: object
+    description: 同步结果统计
+    properties:
+      to_github:
+        type: object
+        properties:
+          created: number
+          updated: number
+          skipped: number
+      from_github:
+        type: object
+        properties:
+          created: number
+          updated: number
+          skipped: number
+      conflicts:
+        type: number
+  
+  - name: conflicts
+    type: array
+    description: 冲突详情列表
+    items:
+      type: object
+      properties:
+        item_id: string
+        github_issue_number: number
+        field: string
+        backlog_value: string
+        github_value: string
+        resolution: string
+
+# ============================================================================
+# 实现逻辑
+# ============================================================================
+# 
+# 1. 读取 backlog.yml
+#    - 解析 items 列表
+#    - 读取 github_sync 配置
+#
+# 2. 获取 GitHub Issues
+#    - gh issue list --repo ${repo} --json number,title,state,labels,body
+#    - 解析 Issues 列表
+#
+# 3. 建立映射
+#    - backlog item.id → GitHub issue number
+#    - 通过 github_issue_number 字段或 title 匹配
+#
+# 4. 对比差异
+#    - status: backlog.status vs GitHub state
+#    - title: backlog.title vs GitHub title
+#    - priority: backlog.priority vs GitHub labels
+#    - description: backlog.description vs GitHub body
+#
+# 5. 处理冲突
+#    - 根据冲突策略选择处理方式
+#    - layered: 按字段策略分别处理
+#
+# 6. 执行同步
+#    - to_github: gh issue create/edit
+#    - from_github: 更新 backlog.yml
+#
+# 7. 生成报告
+#    - 统计同步结果
+#    - 输出冲突列表
+#
+# ============================================================================
+# gh CLI 命令示例
+# ============================================================================
+#
+# 创建 Issue：
+# gh issue create --repo ${repo} \
+#   --title "${title}" \
+#   --body "${description}" \
+#   --label "${labels}"
+#
+# 更新 Issue：
+# gh issue edit ${number} --repo ${repo} \
+#   --title "${title}" \
+#   --body "${description}"
+#
+# 添加标签：
+# gh issue edit ${number} --repo ${repo} \
+#   --add-label "${label}"
+#
+# 关闭 Issue：
+# gh issue close ${number} --repo ${repo}
+#
+# 获取 Issues：
+# gh issue list --repo ${repo} --json number,title,state,labels,body,updatedAt
+#
+# ============================================================================

package/dist/tools/definitions/definitions/std/backlog/list.yml

@@ -0,0 +1,53 @@
+# backlog/list - 列出待办项
+#
+# 输入：
+#   - project_path: 项目路径
+#   - type: 过滤类型（可选）
+#   - status: 过滤状态（可选）
+#   - priority: 过滤优先级（可选）
+#   - limit: 限制数量（可选）
+#
+# 输出：
+#   - items: 待办项列表
+#   - stats: 统计信息
+
+id: backlog/list
+stage: plan
+name: 列出待办项
+description: 列出项目 Backlog 中的待办项
+category: backlog
+execute:
+  type: builtin
+  handler: backlog/list
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  type:
+    type: string
+    enum: [bug, feature, enhancement, performance, tech-debt, patch]
+    required: false
+  status:
+    type: string
+    enum: [open, in_progress, resolved, closed]
+    required: false
+  priority:
+    type: string
+    enum: [critical, high, medium, low]
+    required: false
+  limit:
+    type: number
+    required: false
+
+outputs:
+  - name: items
+    type: array
+    description: 待办项列表
+  - name: stats
+    type: object
+    description: 统计信息
+  - name: total
+    type: number
+    description: 返回的待办项数量

package/dist/tools/definitions/definitions/std/backlog/load.yml

@@ -0,0 +1,46 @@
+# backlog/load - 加载特定 Backlog 项
+# ============================================================================
+# 类型: 内置处理器
+# 用途: 从 backlog 中加载特定 Feature/Bug（通过 item_id）
+# ============================================================================
+
+name: backlog/load
+stage: plan
+description: 从 Backlog 加载特定 Feature 或 Bug
+category: backlog
+version: 1.0.0
+
+# 输入定义
+inputs:
+  - name: project_path
+    type: string
+    description: 项目路径
+    required: true
+  
+  - name: item_id
+    type: string
+    description: Backlog 项 ID（如 F-001, B-001）
+    required: true
+
+# 输出定义
+outputs:
+  - name: feature
+    type: object
+    description: Feature/Bug 对象
+  
+  - name: feature_title
+    type: string
+    description: Feature/Bug 标题
+  
+  - name: feature_description
+    type: string
+    description: Feature/Bug 描述
+  
+  - name: feature_acceptance
+    type: array
+    description: 验收标准列表
+
+# 执行配置
+execute:
+  type: builtin
+  handler: backlog/load