@dommaker/harness 0.9.0 → 0.11.0

package/dist/tools/definitions/definitions/core/file/copy.yml

@@ -0,0 +1,88 @@
+# file-copy.yml - 复制文件
+# ============================================================================
+# 能力类型: 文件操作（工具型）
+# 执行方式: 纯脚本，复制文件或目录
+# ============================================================================
+
+name: file-copy
+description: 复制文件或目录
+
+# 输入参数
+input:
+  src:
+    type: path
+    required: true
+    description: 源路径
+    
+  dst:
+    type: path
+    required: true
+    description: 目标路径
+    
+  create_dirs:
+    type: boolean
+    required: false
+    description: 是否创建父目录
+    default: true
+    
+  overwrite:
+    type: boolean
+    required: false
+    description: 是否覆盖已存在的文件
+    default: true
+
+# 输出
+output:
+  src:
+    type: path
+    description: 源路径
+    
+  dst:
+    type: path
+    description: 目标路径
+
+# 执行命令
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  SRC="{{src}}"
+  DST="{{dst}}"
+  CREATE_DIRS="{{create_dirs}}"
+  OVERWRITE="{{overwrite}}"
+  
+  echo "📋 复制文件"
+  echo "  源: $SRC"
+  echo "  目标: $DST"
+  
+  # 检查源文件是否存在
+  if [ ! -e "$SRC" ]; then
+    echo "❌ 源路径不存在: $SRC"
+    exit 1
+  fi
+  
+  # 创建父目录
+  if [ "$CREATE_DIRS" = "true" ]; then
+    mkdir -p "$(dirname "$DST")"
+  fi
+  
+  # 复制
+  if [ -d "$SRC" ]; then
+    # 目录
+    if [ "$OVERWRITE" = "true" ]; then
+      cp -r "$SRC" "$DST"
+    else
+      cp -rn "$SRC" "$DST" 2>/dev/null || echo "⚠️  目标已存在，跳过"
+    fi
+    echo "  复制目录完成"
+  else
+    # 文件
+    if [ "$OVERWRITE" = "true" ]; then
+      cp "$SRC" "$DST"
+    else
+      cp -n "$SRC" "$DST" 2>/dev/null || echo "⚠️  目标已存在，跳过"
+    fi
+    echo "  复制文件完成"
+  fi
+  
+  echo "✅ 复制完成"

package/dist/tools/definitions/definitions/core/file/read.yml

@@ -0,0 +1,69 @@
+# file-read.yml - 读取文件
+# ============================================================================
+# 能力类型: 文件操作（工具型）
+# 执行方式: 纯脚本，读取文件内容
+# ============================================================================
+
+name: file-read
+description: 读取文件内容
+
+# 输入参数
+input:
+  path:
+    type: path
+    required: true
+    description: 文件路径
+    
+  encoding:
+    type: string
+    required: false
+    description: 文件编码
+    default: "utf-8"
+    
+  max_lines:
+    type: integer
+    required: false
+    description: 最大行数（0 表示不限制）
+    default: 0
+
+# 输出
+output:
+  content:
+    type: string
+    description: 文件内容
+    
+  lines:
+    type: integer
+    description: 总行数
+
+# 执行命令
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  FILE_PATH="{{path}}"
+  MAX_LINES="{{max_lines}}"
+  
+  echo "📖 读取文件: $FILE_PATH"
+  
+  if [ ! -f "$FILE_PATH" ]; then
+    echo "❌ 文件不存在: $FILE_PATH"
+    exit 1
+  fi
+  
+  # 统计行数
+  TOTAL_LINES=$(wc -l < "$FILE_PATH")
+  echo "  总行数: $TOTAL_LINES"
+  
+  # 读取内容
+  if [ "$MAX_LINES" -gt 0 ]; then
+    head -n "$MAX_LINES" "$FILE_PATH"
+    echo ""
+    echo "⚠️  已截断，只显示前 $MAX_LINES 行"
+  else
+    cat "$FILE_PATH"
+  fi
+  
+  echo ""
+  echo "✅ 文件读取完成"
+  echo "LINES=$TOTAL_LINES"

package/dist/tools/definitions/definitions/core/file/write.yml

@@ -0,0 +1,75 @@
+# file-write.yml - 写入文件
+# ============================================================================
+# 能力类型: 文件操作（工具型）
+# 执行方式: 纯脚本，写入文件内容
+# ============================================================================
+
+name: file-write
+description: 写入文件内容
+
+# 输入参数
+input:
+  path:
+    type: path
+    required: true
+    description: 文件路径
+    
+  content:
+    type: string
+    required: true
+    description: 文件内容
+    
+  mode:
+    type: string
+    required: false
+    description: 写入模式（overwrite/append）
+    default: "overwrite"
+    
+  create_dirs:
+    type: boolean
+    required: false
+    description: 是否创建父目录
+    default: true
+
+# 输出
+output:
+  path:
+    type: path
+    description: 文件路径
+    
+  bytes:
+    type: integer
+    description: 写入字节数
+
+# 执行命令
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  FILE_PATH="{{path}}"
+  CONTENT="{{content}}"
+  MODE="{{mode}}"
+  CREATE_DIRS="{{create_dirs}}"
+  
+  echo "📝 写入文件: $FILE_PATH"
+  echo "  模式: $MODE"
+  
+  # 创建父目录
+  if [ "$CREATE_DIRS" = "true" ]; then
+    mkdir -p "$(dirname "$FILE_PATH")"
+  fi
+  
+  # 写入内容
+  if [ "$MODE" = "append" ]; then
+    echo "$CONTENT" >> "$FILE_PATH"
+  else
+    echo "$CONTENT" > "$FILE_PATH"
+  fi
+  
+  # 统计字节数
+  BYTES=$(wc -c < "$FILE_PATH")
+  echo "  写入: $BYTES 字节"
+  
+  echo "✅ 文件写入完成"
+  echo "PATH=$FILE_PATH"
+  echo "BYTES=$BYTES"

package/dist/tools/definitions/definitions/core/git/branch.yml

@@ -0,0 +1,61 @@
+# branch.yml - Git 创建分支
+# ============================================================================
+# 能力类型: git 操作（工具型）
+# 执行方式: 纯脚本，不调用 Agent
+# ============================================================================
+
+name: git-branch
+description: 创建并切换 Git 分支
+
+input:
+  repo_path:
+    type: path
+    required: true
+    description: 仓库路径
+    
+  branch_name:
+    type: string
+    required: true
+    description: 分支名称
+    
+  base_branch:
+    type: string
+    required: false
+    description: 基础分支（可选，默认当前分支）
+    default: ""
+
+output:
+  branch:
+    type: string
+    description: 创建的分支名
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  REPO_PATH="{{repo_path}}"
+  BRANCH_NAME="{{branch_name}}"
+  BASE_BRANCH="{{base_branch}}"
+  
+  cd "$REPO_PATH"
+  
+  echo "🌿 创建分支..."
+  echo "  路径: $REPO_PATH"
+  echo "  分支: $BRANCH_NAME"
+  
+  # 检查是否已存在分支
+  if git show-ref --verify --quiet "refs/heads/$BRANCH_NAME"; then
+    echo "⚠️ 分支已存在，切换到该分支"
+    git checkout "$BRANCH_NAME"
+  else
+    if [ -n "$BASE_BRANCH" ]; then
+      echo "  基于分支: $BASE_BRANCH"
+      git checkout -b "$BRANCH_NAME" "$BASE_BRANCH"
+    else
+      git checkout -b "$BRANCH_NAME"
+    fi
+  fi
+  
+  echo ""
+  echo "✅ 分支创建成功: $BRANCH_NAME"
+  echo "BRANCH=$BRANCH_NAME"

package/dist/tools/definitions/definitions/core/git/cleanup-worktree.yml

@@ -0,0 +1,50 @@
+# cleanup-worktree.yml - 清理 Git Worktree
+# ============================================================================
+# 能力类型: git 操作（工具型）
+# 执行方式: 纯脚本，清理隔离工作空间
+# 用途: 完成开发后清理 git worktree
+# ============================================================================
+
+name: git-cleanup-worktree
+description: 开发完成后清理 Git Worktree 隔离工作空间
+
+input:
+  worktree_path:
+    type: path
+    required: true
+    description: 工作树路径
+  
+  force:
+    type: boolean
+    default: false
+    description: 强制删除（即使有未提交的更改）
+
+output:
+  result:
+    type: string
+    description: 删除结果
+
+script: |
+  #!/bin/bash
+  set -e
+  
+  WORKTREE_PATH="${input.worktree_path}"
+  FORCE="${input.force:-false}"
+  
+  if [ ! -d "$WORKTREE_PATH" ]; then
+    echo "Worktree not found: $WORKTREE_PATH"
+    exit 1
+  fi
+  
+  # 切换到主仓库
+  MAIN_REPO=$(git -C "$WORKTREE_PATH" worktree list | head -1 | cut -f1)
+  cd "$MAIN_REPO"
+  
+  # 删除 worktree
+  if [ "$FORCE" = "true" ]; then
+    git worktree remove --force "$WORKTREE_PATH"
+  else
+    git worktree remove "$WORKTREE_PATH"
+  fi
+  
+  echo "Worktree removed: $WORKTREE_PATH"

package/dist/tools/definitions/definitions/core/git/clone.yml

@@ -0,0 +1,69 @@
+# clone.yml - 克隆仓库
+# ============================================================================
+# 能力类型: git 操作（工具型）
+# 执行方式: 纯脚本，不调用 Agent
+# 调用方式: engine/core/workflow.sh capability git/clone --repo_url "<url>"
+# ============================================================================
+
+name: git-clone
+description: 克隆 Git 仓库到本地
+
+# 输入参数
+input:
+  repo_url:
+    type: string
+    required: true
+    description: 仓库 URL（支持 HTTPS 和 SSH）
+    
+  version:
+    type: string
+    required: false
+    description: 版本/分支/标签（可选，默认 main）
+    default: main
+    
+  depth:
+    type: integer
+    required: false
+    description: 克隆深度（可选，默认 1 表示浅克隆）
+    default: 1
+    
+  target_dir:
+    type: string
+    required: false
+    description: 目标目录（可选，默认 /worktrees/research-{timestamp}）
+
+# 输出
+output:
+  repo_path:
+    type: path
+    description: 克隆后的本地路径
+
+# 工具型能力：纯脚本执行
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  REPO_URL="{{repo_url}}"
+  VERSION="{{version}}"
+  DEPTH="{{depth}}"
+  TARGET_DIR="${TARGET_DIR:-/worktrees/research-$(date +%s)}"
+  
+  mkdir -p "$(dirname "$TARGET_DIR")"
+  
+  echo "📥 克隆仓库: $REPO_URL"
+  echo "  版本: $VERSION"
+  echo "  深度: $DEPTH"
+  echo "  目标: $TARGET_DIR"
+  
+  if [ -n "$VERSION" ] && [ "$VERSION" != "main" ]; then
+    git clone --depth "$DEPTH" --branch "$VERSION" "$REPO_URL" "$TARGET_DIR"
+  else
+    git clone --depth "$DEPTH" "$REPO_URL" "$TARGET_DIR"
+  fi
+  
+  echo ""
+  echo "✅ 克隆完成: $TARGET_DIR"
+  
+  # 输出变量（供后续步骤使用）
+  export REPO_PATH="$TARGET_DIR"
+  echo "REPO_PATH=$TARGET_DIR"

package/dist/tools/definitions/definitions/core/git/commit.yml

@@ -0,0 +1,65 @@
+# commit.yml - Git 提交
+# ============================================================================
+# 能力类型: git 操作（工具型）
+# 执行方式: 纯脚本，不调用 Agent
+# ============================================================================
+
+name: git-commit
+description: Git 提交更改
+
+input:
+  repo_path:
+    type: path
+    required: true
+    description: 仓库路径
+    
+  message:
+    type: string
+    required: true
+    description: 提交消息
+    
+  add_all:
+    type: boolean
+    required: false
+    description: 是否添加所有更改（可选，默认 true）
+    default: true
+
+output:
+  commit_hash:
+    type: string
+    description: 提交哈希
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  REPO_PATH="{{repo_path}}"
+  MESSAGE="{{message}}"
+  ADD_ALL="{{add_all}}"
+  
+  cd "$REPO_PATH"
+  
+  echo "📝 提交更改..."
+  echo "  路径: $REPO_PATH"
+  echo "  消息: $MESSAGE"
+  
+  # 添加文件
+  if [ "$ADD_ALL" = "true" ]; then
+    git add -A
+  fi
+  
+  # 检查是否有更改
+  if git diff --cached --quiet; then
+    echo "⚠️ 没有更改需要提交"
+    echo "COMMIT_HASH=none"
+    exit 0
+  fi
+  
+  # 提交
+  git commit -m "$MESSAGE"
+  
+  COMMIT_HASH=$(git rev-parse --short HEAD)
+  
+  echo ""
+  echo "✅ 提交成功: $COMMIT_HASH"
+  echo "COMMIT_HASH=$COMMIT_HASH"

package/dist/tools/definitions/definitions/core/git/push.yml

@@ -0,0 +1,79 @@
+# push.yml - Git 推送
+# ============================================================================
+# 能力类型: git 操作（工具型）
+# 执行方式: 纯脚本，不调用 Agent
+# ============================================================================
+
+name: git-push
+description: 推送 Git 分支到远程
+
+input:
+  repo_path:
+    type: path
+    required: true
+    description: 仓库路径
+    
+  branch:
+    type: string
+    required: false
+    description: 分支名称（可选，默认当前分支）
+    default: ""
+    
+  remote:
+    type: string
+    required: false
+    description: 远程名称（可选，默认 origin）
+    default: "origin"
+    
+  set_upstream:
+    type: boolean
+    required: false
+    description: 是否设置上游分支（可选，默认 false）
+    default: false
+
+output:
+  push_result:
+    type: string
+    description: 推送结果
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  REPO_PATH="{{repo_path}}"
+  BRANCH="{{branch}}"
+  REMOTE="{{remote}}"
+  SET_UPSTREAM="{{set_upstream}}"
+  
+  cd "$REPO_PATH"
+  
+  # 获取当前分支
+  if [ -z "$BRANCH" ]; then
+    BRANCH=$(git rev-parse --abbrev-ref HEAD)
+  fi
+  
+  echo "🚀 推送分支..."
+  echo "  路径: $REPO_PATH"
+  echo "  远程: $REMOTE"
+  echo "  分支: $BRANCH"
+  
+  # 构建推送命令
+  PUSH_CMD="git push $REMOTE $BRANCH"
+  
+  if [ "$SET_UPSTREAM" = "true" ]; then
+    PUSH_CMD="git push -u $REMOTE $BRANCH"
+  fi
+  
+  echo ""
+  
+  # 推送
+  if $PUSH_CMD 2>&1; then
+    echo ""
+    echo "✅ 推送成功"
+    echo "PUSH_RESULT=success"
+  else
+    echo ""
+    echo "❌ 推送失败"
+    echo "PUSH_RESULT=failed"
+    exit 1
+  fi

package/dist/tools/definitions/definitions/core/git/worktree.yml

@@ -0,0 +1,96 @@
+# worktree.yml - Git Worktree
+# ============================================================================
+# 能力类型: git 操作（工具型）
+# 来源: Superpowers - using-git-worktrees
+# 版本: 2026-03-28 (需手动同步)
+# 执行方式: 纯脚本，创建隔离工作空间
+# 用途: 为新功能创建隔离的 git worktree，避免污染主分支
+# ============================================================================
+
+name: git-worktree
+description: 为新功能创建隔离的 Git Worktree，避免污染主分支
+
+iron_law:
+  hint: "使用 git worktree 创建隔离环境，避免在主分支直接开发"
+
+input:
+  repo_path:
+    type: path
+    required: true
+    description: 主仓库路径
+    
+  branch_name:
+    type: string
+    required: true
+    description: 新分支名称（如 feature/xxx）
+    
+  base_branch:
+    type: string
+    required: false
+    description: 基础分支（默认为当前分支）
+    default: ""
+    
+  worktree_path:
+    type: path
+    required: false
+    description: worktree 路径（可选，自动生成）
+    default: ""
+
+output:
+  worktree_path:
+    type: path
+    description: 创建的 worktree 路径
+    
+  branch_name:
+    type: string
+    description: 创建的分支名称
+
+script: |
+  #!/bin/bash
+  set -euo pipefail
+  
+  REPO_PATH="{{repo_path}}"
+  BRANCH_NAME="{{branch_name}}"
+  BASE_BRANCH="{{base_branch}}"
+  WORKTREE_PATH="{{worktree_path}}"
+  
+  cd "$REPO_PATH"
+  
+  echo "🌳 创建 Git Worktree"
+  echo "  仓库: $REPO_PATH"
+  echo "  分支: $BRANCH_NAME"
+  echo ""
+  
+  # 获取当前分支作为基础分支
+  if [ -z "$BASE_BRANCH" ]; then
+    BASE_BRANCH=$(git branch --show-current)
+    echo "  基础分支: $BASE_BRANCH (当前分支)"
+  fi
+  
+  # 生成 worktree 路径
+  if [ -z "$WORKTREE_PATH" ]; then
+    WORKTREE_PATH="../$(basename "$REPO_PATH")-${BRANCH_NAME#*/}"
+  fi
+  
+  echo "  Worktree 路径: $WORKTREE_PATH"
+  echo ""
+  
+  # 检查分支是否已存在
+  if git show-ref --verify --quiet "refs/heads/$BRANCH_NAME"; then
+    echo "⚠️ 分支已存在: $BRANCH_NAME"
+    echo "  使用现有分支创建 worktree"
+    git worktree add "$WORKTREE_PATH" "$BRANCH_NAME"
+  else
+    echo "✨ 创建新分支和 worktree"
+    git worktree add -b "$BRANCH_NAME" "$WORKTREE_PATH" "$BASE_BRANCH"
+  fi
+  
+  echo ""
+  echo "✅ Worktree 创建成功！"
+  echo "  路径: $WORKTREE_PATH"
+  echo "  分支: $BRANCH_NAME"
+  echo ""
+  echo "💡 提示: 开发完成后，使用 'git worktree remove $WORKTREE_PATH' 清理"
+  echo ""
+  echo "WORKTREE_PATH=$WORKTREE_PATH"
+  echo "BRANCH_NAME=$BRANCH_NAME"