@dommaker/harness 0.13.0 → 0.13.2

package/src/tools/definitions/std/design/generate-spec.yml

@@ -0,0 +1,182 @@
+# generate-spec.yml - 将规划文档转换为 Spec 文档
+# ============================================================================
+# 类型: 转换步骤
+# 用途: 将 architecture.md（规划文档）转换为 ARCHITECTURE.md（Spec 文档）
+# 输入: 规划文档路径或内容
+# 输出: Spec 格式文档（包含版本号、审批区、变更历史）
+# ============================================================================
+
+name: generate-spec
+stage: plan
+description: 将规划文档转换为 Spec 文档（增加版本号、审批区、变更历史）
+category: design
+version: 1.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.2
+
+# 可用工具
+tools:
+  - file-read
+  - file-write
+
+# Prompt
+prompt: |
+  你是一个架构文档转换专家。将规划文档转换为标准 Spec 文档。
+  
+  ## 输入
+  
+  **源文档**: {{inputs.source}}
+  **项目路径**: {{project.path}}
+  **Spec 模式**: {{inputs.spec_mode}}
+  
+  ## 转换规则
+  
+  1. **增加版本号**: 初始版本为 `1.0.0`
+  2. **增加审批区**: 预留审批记录位置
+  3. **增加变更历史**: 初始记录
+  4. **标准化格式**: 便于程序验证
+  
+  ## 输出格式
+  
+  生成 `ARCHITECTURE.md` 文件，格式如下：
+  
+  ```markdown
+  # ARCHITECTURE.md
+  
+  > **Spec Version**: 1.0.0
+  > **Created**: {{current_date}}
+  > **Author**: {{inputs.author}}
+  > **Constraint Level**: {{inputs.constraint_level}}
+  
+  ---
+  
+  ## 审批记录
+  
+  | 版本 | 审批人 | 角色 | 状态 | 时间 | 备注 |
+  |------|--------|------|------|------|------|
+  | 1.0.0 | - | - | pending | - | 初始版本 |
+  
+  ---
+  
+  ## 变更历史
+  
+  | 版本 | 日期 | 变更内容 | 变更人 | 审批状态 |
+  |------|------|----------|--------|----------|
+  | 1.0.0 | {{current_date}} | 初始架构设计 | {{inputs.author}} | pending |
+  
+  ---
+  
+  ## 技术栈
+  
+  | 类别 | 选择 | 理由 |
+  |------|------|------|
+  | 框架 | <框架名> | <选择理由> |
+  | 语言 | <语言> | <选择理由> |
+  | 存储 | <存储方式> | <选择理由> |
+  | 构建 | <构建工具> | <选择理由> |
+  
+  ## 模块划分
+  
+  ### 模块: <模块路径>
+  - **职责**: <模块职责>
+  - **依赖**: <依赖的其他模块>
+  - **接口**: <对外暴露的接口>
+  
+  ## 目录结构
+  
+  ```
+  <项目名>/
+  ├── <目录>/
+  │   └── <文件>
+  └── ...
+  ```
+  
+  ## 数据模型
+  
+  ### <模型名>
+  ```typescript
+  {
+    <字段名>: <类型>  // <说明>
+  }
+  ```
+  
+  ## API 设计
+  
+  | 方法 | 路径 | 功能 | 请求体 | 响应体 |
+  |------|------|------|--------|--------|
+  | GET | /api/xxx | <功能描述> | - | <响应结构> |
+  | POST | /api/xxx | <功能描述> | <请求结构> | <响应结构> |
+  
+  ## 约束条件
+  
+  ### 模块边界
+  - <模块A> 不得直接依赖 <模块B> 的内部实现
+  - <模块> 只能通过 <接口> 访问 <资源>
+  
+  ### API 契约
+  - API 版本化: `/api/v1/...`
+  - 响应格式: `{ success: boolean, data: any, error?: string }`
+  
+  ### 性能要求
+  - 响应时间 < 200ms
+  - 并发支持 > 100 QPS
+  
+  ---
+  
+  > **注意**: 此文档为 Spec 文档，变更需要经过审批流程。
+  ```
+
+# 输入参数
+inputs:
+  - name: source
+    type: string
+    required: true
+    description: 源文档路径或内容（architecture.md）
+  
+  - name: spec_mode
+    type: enum
+    default: flexible
+    options: [none, flexible, strict]
+    description: Spec 模式
+  
+  - name: constraint_level
+    type: enum
+    default: advisory
+    options: [none, advisory, binding]
+    description: 约束级别
+  
+  - name: author
+    type: string
+    default: system
+    description: 作者名称
+
+# 输出
+outputs:
+  - name: ARCHITECTURE.md
+    type: file
+    description: Spec 格式架构文档
+  
+  - name: spec_version
+    type: string
+    description: Spec 版本号
+  
+  - name: changes
+    type: array
+    description: 变更列表（用于审批）
+    items:
+      type: object
+      properties:
+        type:
+          type: string
+          description: 变更类型
+        description:
+          type: string
+          description: 变更描述
+
+# 元数据
+metadata:
+  author: system
+  created_at: 2026-04-14
+  tags: [spec, architecture, design]

package/src/tools/definitions/std/development/develop-api.yml

@@ -0,0 +1,85 @@
+name: develop-api
+stage: develop
+description: |
+  API 开发步骤。
+  
+  实现 API 接口：
+  - RESTful API
+  - GraphQL API
+  - WebSocket 接口
+  
+  输入：
+  - requirement: 需求描述
+  - api_contract: API 契约
+  - data_model: 数据模型（可选）
+
+agent: codex
+timeout: 600  # 10 分钟
+
+inputs:
+  - name: requirement
+    type: string
+    required: true
+    description: 需求描述
+    
+  - name: api_contract
+    type: string
+    required: true
+    description: API 契约路径
+    
+  - name: data_model
+    type: string
+    required: false
+    description: 数据模型路径
+
+outputs:
+  - name: implemented
+    type: boolean
+    description: 是否完成实现
+    
+  - name: endpoints
+    type: array
+    description: 实现的端点列表
+    
+  - name: files_changed
+    type: array
+    description: 变更的文件列表
+
+prompt: |
+  # API 开发任务
+  
+  ## 需求
+  {{requirement}}
+  
+  ## API 契约
+  参考：{{api_contract}}
+  
+  {{#if data_model}}
+  ## 数据模型
+  参考：{{data_model}}
+  {{/if}}
+  
+  ## 任务
+  
+  1. 阅读现有代码结构
+  2. 实现 API 路由
+  3. 实现请求验证
+  4. 实现响应格式化
+  5. 添加错误处理
+  6. 自测功能
+  
+  ## 输出格式
+  
+  完成后提供：
+  - 实现的端点列表
+  - 变更的文件
+  - 测试建议
+
+tools:
+  - file-read
+  - file-write
+  - shell-execute
+
+temperature: 0.7
+
+version: "1.0.0"

package/src/tools/definitions/std/development/develop-backend.yml

@@ -0,0 +1,88 @@
+name: develop-backend
+stage: develop
+description: |
+  后端开发步骤。
+  
+  根据需求和设计文档实现后端功能：
+  - API 接口实现
+  - 业务逻辑
+  - 数据库操作
+  - 中间件配置
+  
+  输入：
+  - requirement: 需求描述
+  - design_doc: 设计文档路径
+  - api_contract: API 契约
+
+agent: codex
+timeout: 600  # 10 分钟
+
+inputs:
+  - name: requirement
+    type: string
+    required: true
+    description: 需求描述
+    
+  - name: design_doc
+    type: string
+    required: false
+    description: 设计文档路径
+    
+  - name: api_contract
+    type: string
+    required: false
+    description: API 契约路径
+
+outputs:
+  - name: implemented
+    type: boolean
+    description: 是否完成实现
+    
+  - name: files_changed
+    type: array
+    description: 变更的文件列表
+    
+  - name: api_endpoints
+    type: array
+    description: 实现的 API 端点列表
+
+prompt: |
+  # 后端开发任务
+  
+  ## 需求
+  {{requirement}}
+  
+  {{#if design_doc}}
+  ## 设计文档
+  参考：{{design_doc}}
+  {{/if}}
+  
+  {{#if api_contract}}
+  ## API 契约
+  参考：{{api_contract}}
+  {{/if}}
+  
+  ## 任务
+  
+  1. 阅读现有代码结构
+  2. 实现数据模型
+  3. 实现 API 接口
+  4. 实现业务逻辑
+  5. 添加错误处理
+  6. 自测功能
+  
+  ## 输出格式
+  
+  完成后提供：
+  - 实现的 API 端点
+  - 变更的文件
+  - 测试建议
+
+tools:
+  - file-read
+  - file-write
+  - shell-execute
+
+temperature: 0.7
+
+version: "1.0.0"

package/src/tools/definitions/std/development/develop-frontend.yml

@@ -0,0 +1,87 @@
+name: develop-frontend
+stage: develop
+description: |
+  前端开发步骤。
+  
+  根据需求和设计文档实现前端功能：
+  - 组件开发
+  - 样式实现
+  - 状态管理
+  - API 集成
+  
+  输入：
+  - requirement: 需求描述
+  - design_doc: 设计文档路径
+  - api_contract: API 契约（可选）
+
+agent: codex
+timeout: 600  # 10 分钟
+
+inputs:
+  - name: requirement
+    type: string
+    required: true
+    description: 需求描述
+    
+  - name: design_doc
+    type: string
+    required: false
+    description: 设计文档路径
+    
+  - name: api_contract
+    type: string
+    required: false
+    description: API 契约路径
+
+outputs:
+  - name: implemented
+    type: boolean
+    description: 是否完成实现
+    
+  - name: files_changed
+    type: array
+    description: 变更的文件列表
+    
+  - name: summary
+    type: string
+    description: 实现总结
+
+prompt: |
+  # 前端开发任务
+  
+  ## 需求
+  {{requirement}}
+  
+  {{#if design_doc}}
+  ## 设计文档
+  参考：{{design_doc}}
+  {{/if}}
+  
+  {{#if api_contract}}
+  ## API 契约
+  参考：{{api_contract}}
+  {{/if}}
+  
+  ## 任务
+  
+  1. 阅读现有代码结构
+  2. 实现前端组件和页面
+  3. 确保样式一致
+  4. 集成 API（如有）
+  5. 自测功能
+  
+  ## 输出格式
+  
+  完成后提供：
+  - 实现的组件列表
+  - 变更的文件
+  - 测试建议
+
+tools:
+  - file-read
+  - file-write
+  - shell-execute
+
+temperature: 0.7
+
+version: "1.0.0"

package/src/tools/definitions/std/development/develop-shared-types.yml

@@ -0,0 +1,74 @@
+name: develop-shared-types
+stage: develop
+description: |
+  共享类型开发步骤。
+  
+  实现前后端共享的类型定义：
+  - TypeScript 接口
+  - API 请求/响应类型
+  - 数据模型类型
+  
+  输入：
+  - requirement: 需求描述
+  - api_contract: API 契约
+
+agent: codex
+timeout: 300  # 5 分钟
+
+inputs:
+  - name: requirement
+    type: string
+    required: true
+    description: 需求描述
+    
+  - name: api_contract
+    type: string
+    required: false
+    description: API 契约路径
+
+outputs:
+  - name: implemented
+    type: boolean
+    description: 是否完成实现
+    
+  - name: types_defined
+    type: array
+    description: 定义的类型列表
+    
+  - name: files_changed
+    type: array
+    description: 变更的文件列表
+
+prompt: |
+  # 共享类型开发任务
+  
+  ## 需求
+  {{requirement}}
+  
+  {{#if api_contract}}
+  ## API 契约
+  参考：{{api_contract}}
+  {{/if}}
+  
+  ## 任务
+  
+  1. 阅读现有类型定义
+  2. 定义数据模型接口
+  3. 定义 API 请求/响应类型
+  4. 确保前后端兼容
+  5. 导出所有类型
+  
+  ## 输出格式
+  
+  完成后提供：
+  - 定义的类型列表
+  - 变更的文件
+  - 使用建议
+
+tools:
+  - file-read
+  - file-write
+
+temperature: 0.7
+
+version: "1.0.0"

package/src/tools/definitions/std/development/develop-task.yml

@@ -0,0 +1,122 @@
+# develop-task.yml - 开发单个任务（含 review 循环）
+# ============================================================================
+# 类型: Agent 执行
+# 用途: 根据任务描述开发单个功能，包含实现 → 审核 → 修复循环
+# 超能力: per-task review 循环（方案 A 轻量版）
+# ============================================================================
+
+name: develop-task
+stage: develop
+description: 开发单个任务（含 spec 审核）
+category: development
+version: 2.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.3
+
+# 可用工具
+tools:
+  - file-read
+  - file-write
+  - bash
+  - npm-test
+
+# Prompt
+prompt: |
+  你是资深开发者。请完成以下开发任务，并按流程执行。
+  
+  ## 任务信息
+  
+  **任务 ID**: {{task.id}}
+  **任务名称**: {{task.name}}
+  **任务描述**: {{task.description}}
+  
+  ## 验收标准
+  
+  {{task.acceptance}}
+  
+  ## 项目上下文
+  
+  **项目路径**: {{project.path}}
+  **技术栈**: {{project.tech_stack}}
+  
+  ## 开发流程（必须严格按此顺序执行）
+  
+  ### Phase 1: 实现
+  1. 创建/修改相关文件
+  2. 确保代码符合验收标准
+  3. 运行测试验证
+  
+  ### Phase 2: 自我审核
+  检查以下内容：
+  - [ ] 代码是否符合所有验收标准
+  - [ ] 测试是否通过
+  - [ ] 是否有潜在的 bug
+  
+  ### Phase 3: 修复（如需要）
+  如果审核发现问题，修复后重新审核。
+  
+  ### Phase 4: 提交
+  审核通过后，使用以下命令提交：
+  ```bash
+  git add -A
+  git commit -m "feat({{task.id}}): {{task.name}}"
+  ```
+  
+  ## 输出
+  
+  完成后请报告：
+  1. 创建/修改了哪些文件
+  2. 测试结果
+  3. 审核结论
+  4. 提交 hash（如果有）
+
+# 输入参数
+inputs:
+  - name: task
+    type: object
+    required: true
+    properties:
+      id:
+        type: string
+      name:
+        type: string
+      description:
+        type: string
+      acceptance:
+        type: array
+    description: 任务对象
+  
+  - name: project
+    type: object
+    required: true
+    properties:
+      path:
+        type: string
+      tech_stack:
+        type: object
+    description: 项目上下文
+  
+  - name: previous_outputs
+    type: array
+    description: 前序任务的输出
+
+# 输出
+outputs:
+  - name: files_changed
+    type: array
+    description: 修改的文件列表
+  
+  - name: tests_passed
+    type: boolean
+    description: 测试是否通过
+  
+  - name: commit_hash
+    type: string
+    description: 提交 hash
+  
+  - name: status
+    type: string
+    enum: [success, failed]
+    description: 任务状态

package/src/tools/definitions/std/development/develop-tests.yml

@@ -0,0 +1,76 @@
+# develop-tests.yml
+name: develop-tests
+stage: develop
+description: 编写测试用例
+agent: codex
+temperature: 0.3
+
+tools:
+  - file-read
+  - file-write
+  - npm-test
+
+prompt: |
+  你是测试工程师。为项目编写测试用例。
+  
+  {{input}}
+  
+  ## 项目目录
+  {{project_dir}}
+  
+  ## 任务
+  
+  ### 如果有现有测试
+  
+  1. 查找最近修改的文件
+     ```bash
+     git diff --name-only HEAD~5 2>/dev/null || echo "no git"
+     ```
+     
+  2. 为修改的代码补充测试
+     - 分析修改内容
+     - 添加缺失的测试用例
+     
+  ### 如果没有测试
+  
+  1. 识别核心模块
+     - 入口文件
+     - 业务逻辑
+     - API 端点
+     
+  2. 创建基本测试结构
+     - 使用项目现有测试框架
+     - 测试文件放在 tests/ 目录
+     
+  3. 编写测试用例
+     - 核心功能测试
+     - 边界条件测试
+     - 错误处理测试
+  
+  ## 要求
+  
+  - **不要安装额外依赖**
+  - 使用现有测试框架
+  - 优先测试关键路径
+  - 测试应该独立、可重复
+  - 使用有意义的测试名称
+  
+  ## 输出
+  
+  创建测试报告 `test-report.md`：
+  - 创建了哪些测试文件
+  - 覆盖了哪些功能
+  - 测试数量统计
+
+inputs:
+  - name: projectDir
+    type: string
+    required: true
+    description: 项目目录
+  
+  - name: focus
+    type: string
+    description: 重点测试的模块
+
+outputs:
+  - test-report.md