@dommaker/harness 0.13.0 → 0.13.2

package/src/tools/definitions/std/deploy/commit-push.yml

@@ -0,0 +1,33 @@
+# commit-push.yml
+name: commit-push
+stage: deploy
+description: 提交并推送代码
+category: deploy
+version: 1.0.0
+
+inputs:
+  - name: message
+    type: string
+    default: "auto: update code"
+    description: 提交消息
+  
+  - name: branch
+    type: string
+    default: ""
+    description: 目标分支（可选）
+
+outputs:
+  - name: commit-hash
+    type: string
+    description: 提交哈希
+  
+  - name: commit-url
+    type: string
+    description: 提交 URL
+
+execute:
+  type: tool
+  tool: git-commit-push
+  input:
+    message: ${{inputs.message}}
+    branch: ${{inputs.branch}}

package/src/tools/definitions/std/deploy/deploy-backend.yml

@@ -0,0 +1,37 @@
+# deploy-backend.yml
+name: deploy-backend
+stage: deploy
+description: 后端部署
+category: deploy
+version: 1.0.0
+
+inputs:
+  - name: code
+    type: object
+    description: 后端代码
+  
+  - name: platform
+    type: string
+    default: "docker"
+    description: 部署平台（docker/k8s/serverless）
+  
+  - name: env
+    type: string
+    default: "production"
+    description: 环境（production/staging）
+
+outputs:
+  - name: deploy-url
+    type: string
+    description: 部署 URL
+  
+  - name: container-id
+    type: string
+    description: 容器 ID（Docker）
+
+execute:
+  type: tool
+  tool: deploy-backend
+  input:
+    platform: ${{inputs.platform}}
+    env: ${{inputs.env}}

package/src/tools/definitions/std/deploy/deploy-frontend.yml

@@ -0,0 +1,37 @@
+# deploy-frontend.yml
+name: deploy-frontend
+stage: deploy
+description: 前端部署
+category: deploy
+version: 1.0.0
+
+inputs:
+  - name: code
+    type: object
+    description: 前端代码
+  
+  - name: platform
+    type: string
+    default: "vercel"
+    description: 部署平台（vercel/netlify/github-pages）
+  
+  - name: env
+    type: string
+    default: "production"
+    description: 环境（production/staging）
+
+outputs:
+  - name: deploy-url
+    type: string
+    description: 部署 URL
+  
+  - name: build-log
+    type: string
+    description: 构建日志
+
+execute:
+  type: tool
+  tool: deploy-frontend
+  input:
+    platform: ${{inputs.platform}}
+    env: ${{inputs.env}}

package/src/tools/definitions/std/deploy/rollback.yml

@@ -0,0 +1,148 @@
+# rollback.yml - 部署回滚
+# ============================================================================
+# 类型: 部署类步骤
+# 执行方式: 工具调用
+# 用途: 发布失败时回滚到上一个稳定版本
+# ============================================================================
+
+name: rollback
+stage: deploy
+description: 发布失败时回滚到上一个稳定版本
+category: deploy
+version: 1.0.0
+
+# 输入定义
+inputs:
+  - name: project_path
+    type: string
+    required: true
+    description: 项目路径
+  
+  - name: rollback_type
+    type: string
+    default: "previous_commit"
+    description: 回滚类型（previous_commit/tag/branch）
+  
+  - name: target
+    type: string
+    description: 目标版本（tag 或 branch 名称）
+  
+  - name: force_push
+    type: boolean
+    default: true
+    description: 是否强制推送
+
+# 输出定义
+outputs:
+  - name: rollback_commit
+    type: string
+    description: 回滚到的 commit hash
+  
+  - name: status
+    type: string
+    description: 回滚状态
+  
+  - name: report
+    type: string
+    description: 回滚报告
+
+# 执行配置
+execute:
+  type: builtin
+  handler: rollback
+  
+  logic: |
+    ## 回滚流程
+    
+    ### Step 1: 确认当前状态
+    ```bash
+    cd {{project_path}}
+    git status
+    git log -1 --oneline
+    ```
+    
+    ### Step 2: 执行回滚
+    
+    **previous_commit**:
+    ```bash
+    git reset --hard HEAD~1
+    git push --force
+    ```
+    
+    **tag**:
+    ```bash
+    git checkout {{target}}
+    git push --force origin HEAD:main
+    ```
+    
+    **branch**:
+    ```bash
+    git checkout {{target}}
+    git push --force origin HEAD:main
+    ```
+    
+    ### Step 3: 验证回滚
+    ```bash
+    git log -1 --oneline
+    npm test
+    ```
+    
+    ### Step 4: 生成回滚报告
+    ```markdown
+    # 回滚报告
+    
+    **时间**: <timestamp>
+    **项目**: {{project_path}}
+    
+    ## 回滚信息
+    - 类型: {{rollback_type}}
+    - 目标: {{target}}
+    - 回滚 commit: <commit_hash>
+    
+    ## 回滚前状态
+    - Commit: <old_commit>
+    - Message: <old_message>
+    
+    ## 回滚后状态
+    - Commit: <new_commit>
+    - Message: <new_message>
+    
+    ## 验证结果
+    - Git 状态: ✅ 已回滚
+    - 测试状态: ✅ 通过/❌ 失败
+    
+    ## 后续建议
+    1. 检查回滚后的代码
+    2. 修复原始问题
+    3. 重新发布
+    ```
+
+# 错误处理
+error_handling:
+  - error: UNCOMMITTED_CHANGES
+    message: "有未提交的更改，请先处理"
+    action: abort
+  
+  - error: NO_PREVIOUS_COMMIT
+    message: "没有可回滚的 commit"
+    action: abort
+  
+  - error: FORCE_PUSH_FAILED
+    message: "强制推送失败，请检查权限"
+    action: warn
+  
+  - error: TESTS_FAILED
+    message: "回滚后测试失败"
+    action: warn
+
+# 安全检查
+safety_checks:
+  - name: confirm_rollback
+    type: prompt
+    message: "⚠️ 确认要回滚到上一个版本吗？此操作不可逆。"
+    default: false
+  
+  - name: check_production
+    type: environment
+    condition: "NODE_ENV == 'production'"
+    require_confirmation: true

package/src/tools/definitions/std/design/analyze-architecture-impact.yml

@@ -0,0 +1,113 @@
+# analyze-architecture-impact.yml - 架构影响分析
+# ============================================================================
+# 类型: Agent 执行
+# 用途: 分析新功能对现有架构的影响，识别需要修改/新增的模块
+# ============================================================================
+
+name: analyze-architecture-impact
+stage: plan
+description: 分析新功能对现有架构的影响
+category: design
+version: 1.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.3
+
+# 可用工具
+tools:
+  - file-read
+  - bash
+
+# Prompt
+prompt: |
+  你是一个系统架构师。请分析新功能对现有架构的影响。
+  
+  ## 输入信息
+  
+  **新功能需求**: {{requirements}}
+  
+  **现有架构**: {{existing_architecture}}
+  
+  **现有模块**: {{existing_modules}}
+  
+  ## 任务
+  
+  分析新功能对现有架构的影响，输出以下内容：
+  
+  ### 1. 影响分析
+  
+  评估变更范围：
+  - 影响程度: 低/中/高
+  - 是否需要架构调整: 是/否
+  - 是否有破坏性变更: 是/否
+  
+  ### 2. 需要修改的模块
+  
+  列出需要修改的现有模块：
+  ```json
+  ["module/path/1", "module/path/2"]
+  ```
+  
+  ### 3. 需要新增的模块
+  
+  列出需要新增的模块：
+  ```json
+  ["new/module/1", "new/module/2"]
+  ```
+  
+  ### 4. 破坏性变更
+  
+  列出可能影响现有功能的变更：
+  - API 变更
+  - 数据模型变更
+  - 接口变更
+  
+  ## 输出格式（JSON）
+  
+  ```json
+  {
+    "impact_analysis": {
+      "level": "medium",
+      "requires_architecture_change": false,
+      "has_breaking_changes": false,
+      "summary": "简要分析说明"
+    },
+    "modules_to_modify": ["module/path/1"],
+    "modules_to_add": ["new/module/1"],
+    "breaking_changes": []
+  }
+  ```
+
+# 输入参数
+inputs:
+  - name: requirements
+    type: string
+    description: 新功能需求
+    required: true
+  
+  - name: existing_architecture
+    type: string
+    description: 现有架构描述
+  
+  - name: existing_modules
+    type: array
+    description: 现有模块列表
+
+# 输出
+outputs:
+  - name: impact_analysis
+    type: object
+    description: 影响分析结果
+  
+  - name: modules_to_modify
+    type: array
+    description: 需要修改的模块列表
+  
+  - name: modules_to_add
+    type: array
+    description: 需要新增的模块列表
+  
+  - name: breaking_changes
+    type: array
+    description: 破坏性变更列表

package/src/tools/definitions/std/design/design-api.yml

@@ -0,0 +1,55 @@
+# design-api.yml
+name: design-api
+stage: plan
+description: API 接口设计
+agent: codex
+temperature: 0.3
+
+tools:
+  - file-read
+  - file-write
+
+prompt: |
+  你是 API 架构师。根据需求和架构定义 API 接口契约。
+  
+  {{input}}
+  
+  ## 职责
+  
+  **输出 OpenAPI 3.0 规范**：
+  - 所有 API 端点
+  - 请求/响应格式
+  - 数据模型定义
+  - 错误响应格式
+  
+  ## 输出格式
+  
+  创建 `openapi.yaml` 文件，包含完整的 API 定义。
+  
+  ## 原则
+  
+  - RESTful 风格
+  - 统一的错误处理
+  - 版本化 API（/api/v1/）
+  - 清晰的命名规范
+  
+  ## 验证
+  
+  生成后检查：
+  - 所有端点都有描述
+  - 请求/响应 schema 完整
+  - 错误码定义清晰
+
+inputs:
+  - name: spec
+    type: object
+    required: true
+    description: 技术规格
+  
+  - name: style
+    type: string
+    default: "rest"
+    description: API 风格（rest/graphql/rpc）
+
+outputs:
+  - openapi.yaml

package/src/tools/definitions/std/design/design-architecture.yml

@@ -0,0 +1,97 @@
+# design-architecture.yml
+name: design-architecture
+stage: plan
+description: 架构设计，生成标准化架构文档
+category: design
+version: 3.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.3
+
+# 可用工具
+tools:
+  - file-read
+  - file-write
+
+# Prompt
+prompt: |
+  你是一个系统架构师。根据需求文档设计架构。
+  
+  请先读取 requirements.md 文件了解需求。
+  
+  ## 任务
+  
+  生成 `architecture.md` 文件，**严格遵循以下格式**：
+  
+  ```markdown
+  # 架构设计
+  
+  ## 技术栈
+  
+  | 类别 | 选择 | 理由 |
+  |------|------|------|
+  | 框架 | <框架名> | <选择理由> |
+  | 语言 | <语言> | <选择理由> |
+  | 存储 | <存储方式> | <选择理由> |
+  | 构建 | <构建工具> | <选择理由> |
+  
+  ## 模块划分
+  
+  ### 模块: <模块路径>
+  - 职责: <模块职责>
+  - 依赖: <依赖的其他模块，无则填"无">
+  
+  ### 模块: <模块路径>
+  - 职责: <模块职责>
+  - 依赖: <依赖的其他模块>
+  
+  ## 目录结构
+  
+  ```
+  <项目名>/
+  ├── <目录>/
+  │   └── <文件>
+  └── ...
+  ```
+  
+  ## 数据模型
+  
+  ### <模型名>
+  ```typescript
+  {
+    <字段名>: <类型>  // <说明>
+  }
+  ```
+  
+  ## API 设计
+  
+  | 方法 | 路径 | 功能 |
+  |------|------|------|
+  | GET | /api/xxx | <功能描述> |
+  | POST | /api/xxx | <功能描述> |
+  
+  ## 实现建议
+  
+  1. <建议1>
+  2. <建议2>
+  ```
+  
+  ## 格式要求（重要！）
+  
+  1. 技术栈用表格格式，便于程序提取
+  2. 模块划分必须用 `### 模块:` 格式，每个模块包含 `职责:` 和 `依赖:` 两行
+  3. 依赖关系必须明确，便于生成任务依赖图
+  4. 不要添加额外内容，保持格式一致
+
+# 输入参数
+inputs:
+  - name: requirements
+    type: string
+    description: 需求文档路径（可选，默认读取 requirements.md）
+
+# 输出
+outputs:
+  - name: architecture.md
+    type: file
+    description: 标准化架构文档

package/src/tools/definitions/std/design/design-db.yml

@@ -0,0 +1,81 @@
+# design-db.yml
+name: design-db
+stage: plan
+description: 数据库设计
+agent: codex
+temperature: 0.3
+
+tools:
+  - file-read
+  - file-write
+
+prompt: |
+  你是数据库架构师。根据 API 契约设计数据库模型。
+  
+  {{input}}
+  
+  ## 任务
+  
+  ### 1. 分析数据需求
+  
+  从 API 契约中识别：
+  - 数据实体
+  - 关系类型（一对一、一对多、多对多）
+  - 查询模式
+  
+  ### 2. 设计数据模型
+  
+  使用 Prisma Schema：
+  - 定义模型和字段
+  - 设置关系
+  - 添加索引
+  - 考虑性能优化
+  
+  ### 3. 输出
+  
+  创建 `prisma/schema.prisma`：
+  ```prisma
+  datasource db {
+    provider = "sqlite"
+    url      = "file:./dev.db"
+  }
+  
+  generator client {
+    provider = "prisma-client-js"
+  }
+  
+  model User {
+    id        String   @id @default(uuid())
+    email     String   @unique
+    name      String?
+    posts     Post[]
+    createdAt DateTime @default(now())
+  }
+  
+  model Post {
+    id        String   @id @default(uuid())
+    title     String
+    content   String?
+    author    User     @relation(fields: [authorId], references: [id])
+    authorId  String
+  }
+  ```
+  
+  ## 原则
+  
+  - 先设计，后优化
+  - 保持简单（YAGNI）
+  - 考虑扩展性
+
+inputs:
+  - name: apiSpec
+    type: object
+    required: true
+    description: API 契约
+  
+  - name: requirements
+    type: object
+    description: 需求文档
+
+outputs:
+  - prisma/schema.prisma