@minakoto00/skills 0.1.0

package/skills/review-pr/scripts/plan_review_validation_dispatch.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+# shellcheck source=./common.sh
+source "$SCRIPT_DIR/common.sh"
+
+input_path=
+
+usage() {
+  cat <<'USAGE'
+Usage: plan_review_validation_dispatch.sh [--input <path>]
+
+Read clustered review issues and emit a bounded subagent dispatch plan.
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --input)
+      input_path=$2
+      shift 2
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown argument: $1"
+      ;;
+  esac
+done
+
+require_cmd jq
+
+if [[ -n "$input_path" ]]; then
+  input_json=$(cat "$input_path")
+else
+  input_json=$(cat)
+fi
+
+jq -cn --argjson payload "$input_json" '
+  def cluster_items:
+    $payload.issue_clusters.items // [];
+
+  def planned_subagents($cluster_count):
+    if $cluster_count <= 0 then 0
+    elif $cluster_count <= 2 then 1
+    elif $cluster_count <= 4 then 2
+    elif $cluster_count <= 6 then 3
+    else 4
+    end;
+
+  cluster_items as $clusters
+  | ($clusters | length) as $cluster_count
+  | planned_subagents($cluster_count) as $subagent_count
+  | {
+      issue_cluster_count: $cluster_count,
+      subagent_count: $subagent_count,
+      assignments: [
+        range(0; $subagent_count)
+        | . as $index
+        | {
+            subagent_id: ("validation-" + (($index + 1) | tostring)),
+            cluster_ids: [
+              range(0; $cluster_count)
+              | select(. % $subagent_count == $index)
+              | $clusters[.].cluster_id
+            ]
+          }
+        | .cluster_count = (.cluster_ids | length)
+      ]
+    }
+'

package/skills/review-pr/scripts/post_review_comment.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+# shellcheck source=./common.sh
+source "$SCRIPT_DIR/common.sh"
+
+repo=.
+platform=
+number=
+body_file=
+dry_run=false
+
+usage() {
+  cat <<'USAGE'
+Usage: post_review_comment.sh --repo <path> --number <id> --body-file <file> [--platform <github|gitlab>] [--dry-run]
+
+Post a change plan and patch guidance comment to a GitHub PR or GitLab MR.
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)
+      repo=$2
+      shift 2
+      ;;
+    --platform)
+      platform=$2
+      shift 2
+      ;;
+    --number)
+      number=$2
+      shift 2
+      ;;
+    --body-file)
+      body_file=$2
+      shift 2
+      ;;
+    --dry-run)
+      dry_run=true
+      shift
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown argument: $1"
+      ;;
+  esac
+done
+
+repo=$(resolve_repo_root "$repo")
+[[ -n "$number" ]] || die "--number is required"
+[[ -n "$body_file" ]] || die "--body-file is required"
+[[ -f "$body_file" ]] || die "body file not found: $body_file"
+
+if [[ -z "$platform" ]]; then
+  platform=$("$SCRIPT_DIR/detect_platform.sh" --repo "$repo")
+fi
+
+if [[ "$dry_run" == true ]]; then
+  print_kv platform "$platform"
+  print_kv repo_root "$repo"
+  print_kv number "$number"
+  print_kv body_file "$body_file"
+  exit 0
+fi
+
+cd "$repo"
+
+case "$platform" in
+  github)
+    require_cmd gh
+    gh pr comment "$number" --body-file "$body_file"
+    ;;
+  gitlab)
+    require_cmd glab
+    glab mr note "$number" --message "$(cat "$body_file")"
+    ;;
+  *)
+    die "unsupported platform: $platform"
+    ;;
+esac
+
+print_kv platform "$platform"
+print_kv number "$number"
+print_kv body_file "$body_file"

package/skills/review-pr/scripts/repo_policy.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+# shellcheck source=./common.sh
+source "$SCRIPT_DIR/common.sh"
+
+repo=.
+
+usage() {
+  cat <<'USAGE'
+Usage: repo_policy.sh [--repo <path>]
+
+Inspect AGENTS.md and CLAUDE.md, if present, and print the resolved worktree root policy.
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)
+      repo=$2
+      shift 2
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown argument: $1"
+      ;;
+  esac
+done
+
+repo=$(resolve_repo_root "$repo")
+
+extract_from_line() {
+  local line=$1
+  local token=
+  local root_token=
+
+  while IFS= read -r token; do
+    [[ -n "$token" ]] || continue
+    root_token=$token
+    if [[ "$token" == ../*/* ]]; then
+      root_token="../${token#../}"
+      root_token="${root_token%%/*}"
+    fi
+    if [[ "$root_token" == *worktree* || "$root_token" == *worktrees* ]]; then
+      printf '%s\n' "$(expand_path "$root_token" "$repo")"
+      return 0
+    fi
+  done < <(printf '%s\n' "$line" | grep -oE '\.\./[^[:space:]`]+|\./[^[:space:]`]+|/[^[:space:]`]+' || true)
+
+  while IFS= read -r token; do
+    token=${token#\`}
+    token=${token%\`}
+    if [[ "$token" == *worktree* || "$token" == *worktrees* ]]; then
+      printf '%s\n' "$(expand_path "$token" "$repo")"
+      return 0
+    fi
+  done < <(printf '%s\n' "$line" | grep -oE '\`[^\`]+\`' || true)
+
+  if [[ "$line" =~ ([A-Za-z0-9._-]+worktree[A-Za-z0-9._-]*)[[:space:]]+folder ]]; then
+    printf '%s\n' "$(expand_path "../${BASH_REMATCH[1]}" "$repo")"
+    return 0
+  fi
+
+  if [[ "$line" =~ \.[/]?worktrees ]]; then
+    printf '%s\n' "$(expand_path .worktrees "$repo")"
+    return 0
+  fi
+
+  if [[ "$line" =~ (^|[^.[:alnum:]_])worktrees([^[:alnum:]_]|$) ]]; then
+    printf '%s\n' "$(expand_path worktrees "$repo")"
+    return 0
+  fi
+
+  return 1
+}
+
+extract_policy() {
+  local file=$1
+  local match
+  while IFS= read -r line; do
+    match=$(extract_from_line "$line") || continue
+    printf '%s\n' "$match"
+    return 0
+  done < <(grep -i 'worktree' "$file" || true)
+  return 1
+}
+
+agents_file="$repo/AGENTS.md"
+claude_file="$repo/CLAUDE.md"
+agents_root=
+claude_root=
+
+if [[ -f "$agents_file" ]]; then
+  agents_root=$(extract_policy "$agents_file" || true)
+fi
+
+if [[ -f "$claude_file" ]]; then
+  claude_root=$(extract_policy "$claude_file" || true)
+fi
+
+if [[ -n "$agents_root" && -n "$claude_root" && "$agents_root" != "$claude_root" ]]; then
+  die "conflicting worktree roots: AGENTS.md=$agents_root CLAUDE.md=$claude_root"
+fi
+
+policy_root=${agents_root:-$claude_root}
+policy_source=default
+
+if [[ -n "$agents_root" ]]; then
+  policy_source=AGENTS.md
+fi
+
+if [[ -n "$claude_root" && -z "$agents_root" ]]; then
+  policy_source=CLAUDE.md
+fi
+
+if [[ -n "$claude_root" && -n "$agents_root" ]]; then
+  policy_source=AGENTS.md+CLAUDE.md
+fi
+
+if [[ -z "$policy_root" ]]; then
+  policy_root=$(expand_path .worktrees "$repo")
+fi
+
+print_kv repo_root "$repo"
+print_kv policy_worktree_root "$policy_root"
+print_kv policy_source "$policy_source"
+print_kv agents_file "$agents_file"
+print_kv claude_file "$claude_file"

package/skills/review-pr/scripts/resolve_review_target.sh

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+# shellcheck source=./common.sh
+source "$SCRIPT_DIR/common.sh"
+
+repo=.
+platform=
+number=
+mode=
+json_output=false
+
+usage() {
+  cat <<'USAGE'
+Usage: resolve_review_target.sh --repo <path> (--latest | --number <id>) [--platform <github|gitlab>] [--json]
+
+Resolve the latest open MR/PR or a specific MR/PR number and print normalized metadata.
+Default output is shell-safe key=value lines.
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)
+      repo=$2
+      shift 2
+      ;;
+    --platform)
+      platform=$2
+      shift 2
+      ;;
+    --number)
+      number=$2
+      mode=number
+      shift 2
+      ;;
+    --latest)
+      mode=latest
+      shift
+      ;;
+    --json)
+      json_output=true
+      shift
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown argument: $1"
+      ;;
+  esac
+done
+
+repo=$(resolve_repo_root "$repo")
+require_cmd jq
+
+if [[ -z "$mode" ]]; then
+  die "choose exactly one of --latest or --number"
+fi
+
+if [[ -z "$platform" ]]; then
+  platform=$("$SCRIPT_DIR/detect_platform.sh" --repo "$repo")
+fi
+
+remote_url=$(origin_url "$repo")
+repository=$(repository_slug_from_remote "$remote_url")
+
+select_latest_number() {
+  local field=$1
+  jq -r --arg field "$field" 'sort_by(.updatedAt // .updated_at) | last | .[$field] // empty'
+}
+
+emit_kv() {
+  local number_value=$1
+  local title=$2
+  local source_branch=$3
+  local target_branch=$4
+  local author=$5
+  local head_sha=$6
+  local updated_at=$7
+  local web_url=$8
+
+  print_kv platform "$platform"
+  print_kv repository "$repository"
+  print_kv number "$number_value"
+  print_kv title "$title"
+  print_kv source_branch "$source_branch"
+  print_kv target_branch "$target_branch"
+  print_kv author "$author"
+  print_kv head_sha "$head_sha"
+  print_kv updated_at "$updated_at"
+  print_kv web_url "$web_url"
+}
+
+cd "$repo"
+
+case "$platform" in
+  github)
+    require_cmd gh
+
+    if [[ "$mode" == latest ]]; then
+      prs=$(gh pr list --state open --limit 100 --json number,updatedAt)
+      number=$(printf '%s' "$prs" | select_latest_number number)
+    fi
+
+    [[ -n "$number" ]] || die "no open GitHub pull requests found"
+
+    view=$(gh pr view "$number" --json number,title,headRefName,baseRefName,author,headRefOid,updatedAt,url)
+    number_value=$(printf '%s' "$view" | jq -r '.number')
+    title=$(printf '%s' "$view" | jq -r '.title')
+    source_branch=$(printf '%s' "$view" | jq -r '.headRefName')
+    target_branch=$(printf '%s' "$view" | jq -r '.baseRefName')
+    author=$(printf '%s' "$view" | jq -r '.author.login // .author.name // "unknown"')
+    head_sha=$(printf '%s' "$view" | jq -r '.headRefOid')
+    updated_at=$(printf '%s' "$view" | jq -r '.updatedAt')
+    web_url=$(printf '%s' "$view" | jq -r '.url')
+    ;;
+  gitlab)
+    require_cmd glab
+
+    if [[ "$mode" == latest ]]; then
+      mrs=$(glab mr list --state opened --per-page 100 --output json)
+      number=$(printf '%s' "$mrs" | select_latest_number iid)
+    fi
+
+    [[ -n "$number" ]] || die "no open GitLab merge requests found"
+
+    view=$(glab mr view "$number" --output json)
+    number_value=$(printf '%s' "$view" | jq -r '.iid')
+    title=$(printf '%s' "$view" | jq -r '.title')
+    source_branch=$(printf '%s' "$view" | jq -r '.source_branch')
+    target_branch=$(printf '%s' "$view" | jq -r '.target_branch')
+    author=$(printf '%s' "$view" | jq -r '.author.username // .author.name // "unknown"')
+    head_sha=$(printf '%s' "$view" | jq -r '.sha')
+    updated_at=$(printf '%s' "$view" | jq -r '.updated_at')
+    web_url=$(printf '%s' "$view" | jq -r '.web_url')
+    ;;
+  *)
+    die "unsupported platform: $platform"
+    ;;
+esac
+
+if [[ "$json_output" == true ]]; then
+  jq -cn \
+    --arg platform "$platform" \
+    --arg repository "$repository" \
+    --arg number "$number_value" \
+    --arg title "$title" \
+    --arg source_branch "$source_branch" \
+    --arg target_branch "$target_branch" \
+    --arg author "$author" \
+    --arg head_sha "$head_sha" \
+    --arg updated_at "$updated_at" \
+    --arg web_url "$web_url" \
+    '{platform:$platform,repository:$repository,number:$number,title:$title,source_branch:$source_branch,target_branch:$target_branch,author:$author,head_sha:$head_sha,updated_at:$updated_at,web_url:$web_url}'
+else
+  emit_kv "$number_value" "$title" "$source_branch" "$target_branch" "$author" "$head_sha" "$updated_at" "$web_url"
+fi

package/skills/review-pr/scripts/worktree_sync.sh

@@ -0,0 +1,118 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+# shellcheck source=./common.sh
+source "$SCRIPT_DIR/common.sh"
+
+repo=.
+remote=origin
+source_branch=
+head_sha=
+dry_run=false
+
+usage() {
+  cat <<'USAGE'
+Usage: worktree_sync.sh --repo <path> --source-branch <branch> [--head-sha <sha>] [--remote <name>] [--dry-run]
+
+Reuse or create a worktree for the source branch, using AGENTS.md / CLAUDE.md policy when present.
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)
+      repo=$2
+      shift 2
+      ;;
+    --source-branch)
+      source_branch=$2
+      shift 2
+      ;;
+    --head-sha)
+      head_sha=$2
+      shift 2
+      ;;
+    --remote)
+      remote=$2
+      shift 2
+      ;;
+    --dry-run)
+      dry_run=true
+      shift
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown argument: $1"
+      ;;
+  esac
+done
+
+[[ -n "$source_branch" ]] || die "--source-branch is required"
+repo=$(resolve_repo_root "$repo")
+
+policy_output=$("$SCRIPT_DIR/repo_policy.sh" --repo "$repo")
+load_kv_output "$policy_output"
+
+worktree_name=$(sanitize_branch_name "$source_branch")
+worktree_path="$policy_worktree_root/$worktree_name"
+action=reused
+
+worktree_exists=false
+if git -C "$repo" worktree list --porcelain | grep -F "worktree $worktree_path" >/dev/null 2>&1; then
+  worktree_exists=true
+elif [[ -d "$worktree_path" && -e "$worktree_path/.git" ]]; then
+  worktree_exists=true
+fi
+
+if [[ "$worktree_exists" == true ]]; then
+  if [[ -n "$(git -C "$worktree_path" status --porcelain)" ]]; then
+    die "existing worktree has uncommitted changes: $worktree_path"
+  fi
+else
+  action=created
+fi
+
+if [[ "$dry_run" == true ]]; then
+  print_kv repo_root "$repo"
+  print_kv worktree_path "$worktree_path"
+  print_kv worktree_action "$action"
+  print_kv source_branch "$source_branch"
+  print_kv remote "$remote"
+  print_kv head_sha "$head_sha"
+  exit 0
+fi
+
+mkdir -p "$policy_worktree_root"
+
+git -C "$repo" fetch "$remote" "$source_branch"
+
+git -C "$repo" rev-parse --verify "$remote/$source_branch" >/dev/null 2>&1 || die "remote branch not found: $remote/$source_branch"
+
+if [[ "$worktree_exists" == true ]]; then
+  git -C "$worktree_path" checkout "$source_branch"
+  git -C "$worktree_path" pull --ff-only "$remote" "$source_branch"
+else
+  if git -C "$repo" show-ref --verify --quiet "refs/heads/$source_branch"; then
+    git -C "$repo" worktree add "$worktree_path" "$source_branch"
+  else
+    git -C "$repo" worktree add -b "$source_branch" "$worktree_path" "$remote/$source_branch"
+  fi
+fi
+
+if [[ -n "$head_sha" ]]; then
+  git -C "$worktree_path" fetch "$remote" "$source_branch"
+  git -C "$worktree_path" cat-file -e "$head_sha^{commit}" >/dev/null 2>&1 || die "head sha not available after fetch: $head_sha"
+  git -C "$worktree_path" reset --hard "$head_sha"
+else
+  git -C "$worktree_path" reset --hard "$remote/$source_branch"
+fi
+
+print_kv repo_root "$repo"
+print_kv worktree_path "$worktree_path"
+print_kv worktree_action "$action"
+print_kv source_branch "$source_branch"
+print_kv current_head "$(git -C "$worktree_path" rev-parse HEAD)"