Claude Code Reference

{
  "permissions": {
    "allow": [
      "Bash(git add:*)",
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Bash(git commit:*)",
      "Bash(git push:*)",
      "Bash(git switch:*)",
      "Bash(gh pr create:*)",
      "Bash(gh issue create:*)",
      "Bash(gh issue view:*)",
      "Bash(gh api:*)",
      "Bash(gh project:*)",
      "Bash(ls:*)",
      "Bash(find:*)",
      "Bash(mkdir -p:*)",
      "Bash(mv:*)",
      "Bash(ln -s:*)",
      "Bash(rmdir:*)",
      "Bash(readlink:*)",
      "Bash(python3 -c:*)",
      "Bash(python3 -m json.tool)",
      "WebFetch(domain:docs.github.com)"
    ],
    "deny": [
      "Bash(git commit --no-verify:*)",
      "Bash(git push --force:*)",
      "Bash(rm -rf .claude:*)"
    ]
  },
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo '=== Claude Code セッション開始 ==='; echo '重要な規約:'; echo '  - Conventional Commits 形式でコミット (type(scope): subject)'; echo '  - --no-verify は使用禁止'; echo '  - .claude/ 配下は _/dotclaude/ 経由で編集'; echo '  - シークレット (.env 等) を含むファイルはコミット禁止'; echo '================================'"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "FILE_PATH=$(echo \"$CLAUDE_TOOL_RESULT\" | python3 -c \"import sys,json; d=json.load(sys.stdin); print(d.get('file_path',''))\" 2>/dev/null || true); if [[ \"$FILE_PATH\" == *.md ]]; then echo \"[hook] Markdown ファイルが更新されました: $FILE_PATH\"; fi"
          }
        ]
      }
    ]
  }
}

#!/usr/bin/env bash
# frontmatter-check.sh — 全 SKILL.md / agent / rule の frontmatter 検査と symlink リンク切れ確認
#
# 使い方: ./script/frontmatter-check.sh [--skills | --agents | --rules | --symlinks | --all]
# 元スキル: .claude/agents/quality/frontmatter-linter.md（検証項目 A〜F）
#
# このスクリプトは「読み取り専用」— ファイルの作成・変更・削除は一切行わない。

set -euo pipefail

# このスクリプトは skills/claude-code-reference/script/ 配下にあるため、リポジトリルートは3階層上
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"

# ANSI カラー（ターミナル判定付き）
if [[ -t 1 ]]; then
  RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RESET='\033[0m'
else
  RED=''; GREEN=''; YELLOW=''; RESET=''
fi

OK="${GREEN}OK${RESET}"
NG="${RED}NG${RESET}"
WARN="${YELLOW}WARN${RESET}"

TOTAL_NG=0
TOTAL_WARN=0

# ----------------------------------------------------------------
# ヘルパー: YAML frontmatter から指定キーの値を抽出する
# ----------------------------------------------------------------
extract_frontmatter_value() {
  local file="$1"
  local key="$2"
  # --- ... --- の間の行から key: value を取り出す
  python3 - "$file" "$key" <<'PYEOF'
import sys, re

filepath, key = sys.argv[1], sys.argv[2]
try:
    with open(filepath, encoding='utf-8') as f:
        content = f.read()
except Exception:
    print('')
    sys.exit(0)

# frontmatter ブロックを抽出
m = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
if not m:
    print('')
    sys.exit(0)

fm = m.group(1)
for line in fm.splitlines():
    if line.startswith(key + ':'):
        val = line[len(key)+1:].strip().strip('"\'')
        print(val)
        sys.exit(0)
print('')
PYEOF
}

# frontmatter ブロックが正しく閉じられているか確認
has_valid_frontmatter() {
  local file="$1"
  python3 - "$file" <<'PYEOF'
import sys, re
with open(sys.argv[1], encoding='utf-8', errors='replace') as f:
    content = f.read()
if re.match(r'^---\n.*?\n---', content, re.DOTALL):
    sys.exit(0)
else:
    sys.exit(1)
PYEOF
}

# ----------------------------------------------------------------
# A/C: SKILL.md の frontmatter 検査
# ----------------------------------------------------------------
check_skills() {
  echo "=== A. SKILL.md frontmatter 検査 ==="
  echo ""

  local skill_dir="${REPO_ROOT}/skills"
  local any_ng=0

  for skill_md in "${skill_dir}"/*/SKILL.md; do
    local skill_path="${skill_md#${REPO_ROOT}/}"
    local dir_name
    dir_name=$(basename "$(dirname "$skill_md")")

    local fm_ok name_val name_ok kebab_ok desc_ok

    # frontmatter ブロックの存在確認
    if has_valid_frontmatter "$skill_md" 2>/dev/null; then
      fm_ok=true
    else
      fm_ok=false
    fi

    name_val=$(extract_frontmatter_value "$skill_md" "name")
    desc_val=$(extract_frontmatter_value "$skill_md" "description")

    # kebab-case チェック: ^[a-z][a-z0-9-]+$
    if [[ -n "$name_val" ]] && echo "$name_val" | grep -qE '^[a-z][a-z0-9-]+$'; then
      kebab_ok=true
    else
      kebab_ok=false
    fi

    # name とディレクトリ名の一致確認（C）
    if [[ "$name_val" == "$dir_name" ]]; then
      name_ok=true
    else
      name_ok=false
    fi

    # description の存在確認
    if [[ -n "$desc_val" ]]; then
      desc_ok=true
    else
      desc_ok=false
    fi

    local status
    if $fm_ok && $name_ok && $kebab_ok && $desc_ok; then
      status="$OK"
    else
      status="$NG"
      any_ng=$((any_ng + 1))
      TOTAL_NG=$((TOTAL_NG + 1))
    fi

    printf "  [%b] %-40s fm=%s name=%s kebab=%s desc=%s dir-match=%s\n" \
      "$status" "$skill_path" \
      "$(bool_str $fm_ok)" "$(val_str "$name_val")" "$(bool_str $kebab_ok)" \
      "$(bool_str $desc_ok)" "$(bool_str $name_ok)"
  done

  echo ""
  if [[ "$any_ng" -gt 0 ]]; then
    echo -e "  ${NG}: ${any_ng} 件の問題があります"
  else
    echo -e "  ${OK}: 全 SKILL.md が正常"
  fi
  echo ""
}

# ----------------------------------------------------------------
# B: Agent frontmatter 検査
# ----------------------------------------------------------------
check_agents() {
  echo "=== B. Agent frontmatter 検査 ==="
  echo ""

  local agents_dir="${REPO_ROOT}/.claude/agents"
  local any_ng=0

  while read -r agent_md; do
    local agent_path="${agent_md#${REPO_ROOT}/}"

    local name_val model_val desc_val fm_ok
    if has_valid_frontmatter "$agent_md" 2>/dev/null; then
      fm_ok=true
    else
      fm_ok=false
    fi

    name_val=$(extract_frontmatter_value "$agent_md" "name")
    model_val=$(extract_frontmatter_value "$agent_md" "model")
    desc_val=$(extract_frontmatter_value "$agent_md" "description")

    local model_ok=false
    if echo "$model_val" | grep -qE '^(haiku|sonnet|opus|claude-.+)$'; then
      model_ok=true
    fi

    local status
    if $fm_ok && [[ -n "$name_val" ]] && [[ -n "$desc_val" ]] && $model_ok; then
      status="$OK"
    else
      status="$NG"
      TOTAL_NG=$((TOTAL_NG + 1))
    fi

    printf "  [%b] %-50s model=%s\n" "$status" "$agent_path" "$(val_str "$model_val")"
  done < <(find "${agents_dir}" -name "*.md" | sort)

  echo ""
}

# ----------------------------------------------------------------
# D: symlink リンク切れ確認
# ----------------------------------------------------------------
check_symlinks() {
  echo "=== D. symlink リンク切れ確認 (.claude/skills/*) ==="
  echo ""

  local dotclaude_skills="${REPO_ROOT}/.claude/skills"
  local any_broken=0

  if [[ ! -d "$dotclaude_skills" ]]; then
    echo "  [${WARN}] .claude/skills/ ディレクトリが存在しません"
    echo ""
    return
  fi

  for link in "${dotclaude_skills}"/*; do
    local link_name
    link_name=$(basename "${link}")
    local target
    target=$(readlink "${link}" 2>/dev/null || echo "(readlink 失敗)")

    if [[ -e "${link}" ]]; then
      printf "  [%b] %-30s -> %s\n" "$OK" "$link_name" "$target"
    else
      printf "  [%b] %-30s -> %s (リンク切れ)\n" "$NG" "$link_name" "$target"
      any_broken=$((any_broken + 1))
      TOTAL_NG=$((TOTAL_NG + 1))
    fi
  done

  echo ""
  if [[ "$any_broken" -gt 0 ]]; then
    echo -e "  ${NG}: ${any_broken} 件のリンク切れ"
    echo "  修正方法: (cd .claude/skills && ln -s ../../skills/<name> <name>)"
  else
    echo -e "  ${OK}: リンク切れなし"
  fi
  echo ""
}

# ----------------------------------------------------------------
# E: skills-lock.json 整合確認
# ----------------------------------------------------------------
check_skills_lock() {
  echo "=== E. skills-lock.json 整合確認 ==="
  echo ""

  local lock_file="${REPO_ROOT}/skills-lock.json"
  if [[ ! -f "$lock_file" ]]; then
    echo "  [${WARN}] skills-lock.json が見つかりません"
    TOTAL_WARN=$((TOTAL_WARN + 1))
    echo ""
    return
  fi

  local any_ng=0

  while IFS=$'\t' read -r name loc; do
    case "$loc" in
      skills/)
        printf "  [%b] %-30s 実在場所: skills/\n" "$OK" "$name"
        ;;
      .agents/skills/)
        printf "  [%b] %-30s 実在場所: .agents/skills/\n" "$OK" "$name"
        ;;
      MISSING)
        printf "  [%b] %-30s 実在場所: ❌ MISSING\n" "$NG" "$name"
        any_ng=$((any_ng + 1))
        TOTAL_NG=$((TOTAL_NG + 1))
        ;;
    esac
  done < <(python3 - "${lock_file}" "${REPO_ROOT}" <<'PYEOF'
import json, os, sys
lock_file, repo_root = sys.argv[1], sys.argv[2]
with open(lock_file) as f:
    d = json.load(f)
for name in d.get('skills', {}).keys():
    in_skills = os.path.isdir(os.path.join(repo_root, f'skills/{name}'))
    in_agents = os.path.isdir(os.path.join(repo_root, f'.agents/skills/{name}'))
    if in_skills:
        loc = 'skills/'
    elif in_agents:
        loc = '.agents/skills/'
    else:
        loc = 'MISSING'
    print(f'{name}\t{loc}')
PYEOF
  )

  echo ""
  if [[ "$any_ng" -gt 0 ]]; then
    echo -e "  ${NG}: ${any_ng} 件のエントリが実在しません"
  else
    echo -e "  ${OK}: 全エントリが実在"
  fi
  echo ""
}

# ----------------------------------------------------------------
# ヘルパー関数
# ----------------------------------------------------------------
bool_str() {
  if $1; then echo "✅"; else echo "❌"; fi
}
val_str() {
  if [[ -n "$1" ]]; then echo "✅($1)"; else echo "❌(空)"; fi
}

# ----------------------------------------------------------------
# サマリー
# ----------------------------------------------------------------
print_summary() {
  echo "=== 総合判定 ==="
  echo ""
  if [[ "$TOTAL_NG" -gt 0 ]]; then
    echo -e "  ${NG}: NG ${TOTAL_NG} 件 / WARN ${TOTAL_WARN} 件"
    echo "  → 詳細を確認して対応してください"
  elif [[ "$TOTAL_WARN" -gt 0 ]]; then
    echo -e "  ${WARN}: NG 0 件 / WARN ${TOTAL_WARN} 件"
    echo "  → 軽微な警告があります"
  else
    echo -e "  ${OK}: 全チェック通過"
  fi
  echo ""
}

# ----------------------------------------------------------------
# メイン
# ----------------------------------------------------------------
main() {
  local mode="${1:---all}"

  echo "Frontmatter & Symlink Checker"
  echo "リポジトリ: ${REPO_ROOT}"
  echo ""

  case "$mode" in
    --skills)   check_skills ;;
    --agents)   check_agents ;;
    --symlinks) check_symlinks ;;
    --lock)     check_skills_lock ;;
    --all | *)
      check_skills
      check_agents
      check_symlinks
      check_skills_lock
      ;;
  esac

  print_summary
}

main "$@"

#!/usr/bin/env bash
# gh-issue.sh — gh issue create + sub-issues 紐付けの実例
#
# 使い方: ./script/gh-issue.sh <owner> <repo>
# 元スキル: skills/create-issue/SKILL.md（Step 2〜4）
#           skills/project-create-issues/SKILL.md（Step 3: 親 Issue を作成、Step 6: sub-issue 紐付け）
#
# 前提条件:
#   - gh CLI がインストールされ認証済みであること
#   - 対象リポジトリへの Issues 書き込み権限があること

set -euo pipefail

OWNER="${1:?第1引数 owner が必要です (例: Fandhe-AI)}"
REPO="${2:?第2引数 repo が必要です (例: agent-cli-skills)}"

# ----------------------------------------------------------------
# 親 Issue を作成する
# ----------------------------------------------------------------
# 返り値: 作成された Issue 番号（stdout）
create_parent_issue() {
  local title="$1"

  local issue_url
  issue_url=$(gh issue create \
    --repo "${OWNER}/${REPO}" \
    --title "${title}" \
    --body "$(cat <<'EOF'
## 概要

このトラッキング Issue の目的を記述する。

## 背景

なぜこの作業が必要か。

## 受け入れ条件

- [ ] 条件1
- [ ] 条件2

## 関連

- Figma: （あれば記載）
- 関連 Issue: #（あれば記載）
EOF
)" \
    --json url -q '.url')

  echo "${issue_url}"
}

# ----------------------------------------------------------------
# 子 Issue を作成する
# ----------------------------------------------------------------
# 返り値: 作成された Issue 番号（stdout）
# 警告: title・body は呼び出し元でサニタイズ済みのリテラルを渡すこと。外部入力を直接渡してはならない。
create_child_issue() {
  local title="$1"
  local body="$2"

  local issue_url
  issue_url=$(gh issue create \
    --repo "${OWNER}/${REPO}" \
    --title "${title}" \
    --body "${body}" \
    --json url -q '.url')

  echo "${issue_url}"
}

# ----------------------------------------------------------------
# Issue のノード ID を取得する（sub_issue_id に必要）
# ----------------------------------------------------------------
get_issue_node_id() {
  local issue_number="$1"
  gh issue view "${issue_number}" \
    --repo "${OWNER}/${REPO}" \
    --json id -q '.id'
}

# ----------------------------------------------------------------
# Sub-issue として親 Issue に紐付ける
# ----------------------------------------------------------------
# 元スキル: create-issue/SKILL.md Step 4、project-create-issues/SKILL.md Step 6
add_sub_issue() {
  local parent_number="$1"
  local child_node_id="$2"

  gh api \
    --method POST \
    "repos/${OWNER}/${REPO}/issues/${parent_number}/sub_issues" \
    -f "sub_issue_id=${child_node_id}"
}

# ----------------------------------------------------------------
# Issue 番号を URL から抽出するヘルパー
# ----------------------------------------------------------------
extract_issue_number() {
  local issue_url="$1"
  # URL 末尾の数字を取り出す（例: .../issues/42 → 42）
  echo "${issue_url##*/}"
}

# ----------------------------------------------------------------
# メイン: 親 Issue + 子 Issue 2件 + sub-issues 紐付けのデモ
# ----------------------------------------------------------------
main() {
  echo "[INFO] 親 Issue を作成中..."
  local parent_url
  parent_url=$(create_parent_issue "feat: 認証機能の実装")
  local parent_number
  parent_number=$(extract_issue_number "${parent_url}")
  echo "[INFO] 親 Issue 作成完了: #${parent_number} (${parent_url})"

  echo "[INFO] 子 Issue 1 を作成中..."
  local child1_url
  child1_url=$(create_child_issue \
    "feat(auth): ソーシャルログイン実装" \
    "OAuth2 を使用した Google/GitHub ログインを実装する。")
  local child1_number
  child1_number=$(extract_issue_number "${child1_url}")
  echo "[INFO] 子 Issue 1 作成完了: #${child1_number}"

  echo "[INFO] 子 Issue 2 を作成中..."
  local child2_url
  child2_url=$(create_child_issue \
    "feat(auth): パスワードリセット機能を追加" \
    "メール経由のパスワードリセットフローを実装する。")
  local child2_number
  child2_number=$(extract_issue_number "${child2_url}")
  echo "[INFO] 子 Issue 2 作成完了: #${child2_number}"

  echo "[INFO] Sub-issue として紐付け中..."

  local child1_node_id
  child1_node_id=$(get_issue_node_id "${child1_number}")
  add_sub_issue "${parent_number}" "${child1_node_id}"
  echo "[INFO] #${child1_number} を #${parent_number} の sub-issue として登録"

  local child2_node_id
  child2_node_id=$(get_issue_node_id "${child2_number}")
  add_sub_issue "${parent_number}" "${child2_node_id}"
  echo "[INFO] #${child2_number} を #${parent_number} の sub-issue として登録"

  echo ""
  echo "=== 作成完了 ==="
  echo "  親 Issue: #${parent_number} ${parent_url}"
  echo "  子 Issue: #${child1_number} ${child1_url}"
  echo "  子 Issue: #${child2_number} ${child2_url}"
}

main "$@"

#!/usr/bin/env bash
# gh-pr.sh — gh pr create の実例（body を HEREDOC で安全に渡す）
#
# 使い方: ./script/gh-pr.sh
# 元スキル: skills/create-pr/SKILL.md（Step 5: PR を作成する）
#           skills/contribute-skill/SKILL.md（Step 10: push と PR 作成）
#
# 前提条件:
#   - gh CLI がインストールされ認証済みであること（gh auth status で確認）
#   - 現在のブランチがベースブランチからフォークされていること
#   - セキュリティチェック（OWASP Top 10・シークレット確認）を事前に実施済みであること

set -euo pipefail

# ----------------------------------------------------------------
# 変数（呼び出し元で設定するか引数で渡す）
# ----------------------------------------------------------------
BASE_BRANCH="${1:-main}"
PR_TITLE="${2:-feat(scope): subject を記入してください}"

# ----------------------------------------------------------------
# 事前確認
# ----------------------------------------------------------------
preflight_check() {
  # gh CLI の認証確認
  if ! gh auth status &>/dev/null; then
    echo "[ERROR] gh CLI が認証されていません。gh auth login を実行してください。" >&2
    exit 1
  fi

  # ベースブランチとの差分確認
  echo "[INFO] ベースブランチ (${BASE_BRANCH}) との差分:"
  git log "${BASE_BRANCH}..HEAD" --oneline
  echo ""
  git diff "${BASE_BRANCH}...HEAD" --stat
  echo ""
}

# ----------------------------------------------------------------
# PR 作成（body は HEREDOC で渡す）
# ----------------------------------------------------------------
create_pr() {
  local title="$1"
  local base="$2"

  gh pr create \
    --base "${base}" \
    --title "${title}" \
    --body "$(cat <<'EOF'
## Summary

- 変更内容の箇条書き1
- 変更内容の箇条書き2

## Test plan

- [ ] 動作確認手順1
- [ ] 動作確認手順2
- [ ] エッジケース確認

## Design

- Figma: （あれば記載）

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"
}

# ----------------------------------------------------------------
# Draft PR の例（ユーザー確認後に --draft を付ける）
# ----------------------------------------------------------------
create_draft_pr() {
  local title="$1"
  local base="$2"

  gh pr create \
    --draft \
    --base "${base}" \
    --title "${title}" \
    --body "$(cat <<'EOF'
## Summary

WIP: 作業中の変更。

## Test plan

- [ ] 未完了

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"
}

# ----------------------------------------------------------------
# PR に reviewers / labels を追加する例
# ----------------------------------------------------------------
create_pr_with_options() {
  local title="$1"
  local base="$2"
  local reviewer="${3:-}"   # GitHub username（任意）
  local label="${4:-}"      # ラベル名（任意）

  gh pr create \
    --base "${base}" \
    --title "${title}" \
    ${reviewer:+--reviewer "${reviewer}"} \
    ${label:+--label "${label}"} \
    --body "$(cat <<'EOF'
## Summary

- ...

## Test plan

- [ ] ...

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"
}

# ----------------------------------------------------------------
# メイン
# ----------------------------------------------------------------
main() {
  preflight_check

  # 通常の PR 作成例
  # create_pr "${PR_TITLE}" "${BASE_BRANCH}"

  # Draft PR 作成例
  # create_draft_pr "${PR_TITLE}" "${BASE_BRANCH}"

  # reviewer / label 付き PR 作成例
  # create_pr_with_options "${PR_TITLE}" "${BASE_BRANCH}" "<reviewer-username>" "enhancement"

  echo "[INFO] PR_TITLE と BASE_BRANCH を設定し、関数呼び出しのコメントを外して実行してください。"
  echo "  PR_TITLE 例: feat(auth): ソーシャルログイン機能を追加"
}

main "$@"

#!/usr/bin/env bash
# gh-project.sh — GitHub Projects v2 の実コマンド集
#
# 使い方: ./script/gh-project.sh <owner> <project-number>
# 元スキル: skills/project-add-items/SKILL.md（Step 3〜5）
#           skills/project-create-issues/SKILL.md（Step 5: item-add, item-edit, item-delete）
#           skills/project-update-items/SKILL.md（Step 2〜5）
#           skills/project-archive-done/SKILL.md（アーカイブ操作）
#
# 前提条件:
#   - gh CLI がインストールされ認証済みであること（project スコープ付き）
#   - gh auth status で project スコープがあることを確認

set -euo pipefail

OWNER="${1:?第1引数 owner が必要です (例: Fandhe-AI)}"
PROJECT_NUMBER="${2:?第2引数 project-number が必要です (例: 1)}"

# ----------------------------------------------------------------
# プロジェクト ID を取得する
# ----------------------------------------------------------------
get_project_id() {
  gh project view "${PROJECT_NUMBER}" \
    --owner "${OWNER}" \
    --format json \
    -q '.id'
}

# ----------------------------------------------------------------
# フィールド一覧とオプション ID を取得する（jq でパース）
# ----------------------------------------------------------------
# 元スキル: project-add-items/SKILL.md Step 3、project-update-items/SKILL.md Step 2
get_field_list() {
  gh project field-list "${PROJECT_NUMBER}" \
    --owner "${OWNER}" \
    --format json
}

# フィールド名→フィールド ID を解決する例（jq を使用）
# 例: get_field_id_by_name "Status"
get_field_id_by_name() {
  local field_name="$1"
  local field_json
  field_json="$(get_field_list)"
  FIELD_NAME="${field_name}" FIELDS_JSON="${field_json}" python3 - <<'PYEOF'
import json, os
data = json.loads(os.environ['FIELDS_JSON'])
fields = data.get('fields', [])
target = os.environ['FIELD_NAME']
for f in fields:
    if f.get('name') == target:
        print(f['id'])
        break
PYEOF
}

# フィールドのオプション名→オプション ID を解決する例
# 例: get_option_id_by_name "Status" "In Progress"
get_option_id_by_name() {
  local field_name="$1"
  local option_name="$2"
  local field_json
  field_json="$(get_field_list)"
  FIELD_NAME="${field_name}" OPTION_NAME="${option_name}" FIELDS_JSON="${field_json}" python3 - <<'PYEOF'
import json, os
data = json.loads(os.environ['FIELDS_JSON'])
fields = data.get('fields', [])
target_field = os.environ['FIELD_NAME']
target_opt   = os.environ['OPTION_NAME']
for f in fields:
    if f.get('name') == target_field:
        for opt in f.get('options', []):
            if opt.get('name') == target_opt:
                print(opt['id'])
                break
PYEOF
}

# ----------------------------------------------------------------
# アイテム一覧を取得する
# ----------------------------------------------------------------
# 元スキル: project-update-items/SKILL.md Step 3、project-create-issues/SKILL.md Step 1
list_items() {
  gh project item-list "${PROJECT_NUMBER}" \
    --owner "${OWNER}" \
    --format json \
    --limit 999
}

# DraftIssue のみを抽出する例
list_draft_items() {
  list_items | python3 -c "
import sys, json
data = json.load(sys.stdin)
items = data.get('items', [])
for item in items:
    if item.get('type') == 'DraftIssue':
        print(json.dumps(item, ensure_ascii=False))
"
}

# ----------------------------------------------------------------
# アイテムを作成する（DraftIssue）
# ----------------------------------------------------------------
# 元スキル: project-add-items/SKILL.md Step 4
create_draft_item() {
  local title="$1"
  local body="${2:-}"

  gh project item-create "${PROJECT_NUMBER}" \
    --owner "${OWNER}" \
    --title "${title}" \
    --body "${body}" \
    --format json
}

# ----------------------------------------------------------------
# アイテムにフィールド値を設定する
# ----------------------------------------------------------------
# 元スキル: project-add-items/SKILL.md Step 5、project-update-items/SKILL.md Step 5

# SINGLE_SELECT フィールドの設定例（Status / Priority / Size）
set_single_select_field() {
  local item_id="$1"
  local project_id="$2"
  local field_id="$3"
  local option_id="$4"

  gh project item-edit \
    --id "${item_id}" \
    --field-id "${field_id}" \
    --project-id "${project_id}" \
    --single-select-option-id "${option_id}"
}

# TEXT フィールドの設定例
set_text_field() {
  local item_id="$1"
  local project_id="$2"
  local field_id="$3"
  local text_value="$4"

  gh project item-edit \
    --id "${item_id}" \
    --field-id "${field_id}" \
    --project-id "${project_id}" \
    --text "${text_value}"
}

# NUMBER フィールドの設定例
set_number_field() {
  local item_id="$1"
  local project_id="$2"
  local field_id="$3"
  local number_value="$4"

  gh project item-edit \
    --id "${item_id}" \
    --field-id "${field_id}" \
    --project-id "${project_id}" \
    --number "${number_value}"
}

# DATE フィールドの設定例（YYYY-MM-DD 形式）
set_date_field() {
  local item_id="$1"
  local project_id="$2"
  local field_id="$3"
  local date_value="$4"  # 例: 2026-06-30

  gh project item-edit \
    --id "${item_id}" \
    --field-id "${field_id}" \
    --project-id "${project_id}" \
    --date "${date_value}"
}

# ----------------------------------------------------------------
# Issue をプロジェクトに追加する（DraftIssue → 実 Issue 変換後に使用）
# ----------------------------------------------------------------
# 元スキル: project-create-issues/SKILL.md Step 5
add_issue_to_project() {
  local issue_url="$1"

  gh project item-add "${PROJECT_NUMBER}" \
    --owner "${OWNER}" \
    --url "${issue_url}" \
    --format json
}

# ----------------------------------------------------------------
# DraftIssue アイテムを削除する
# ----------------------------------------------------------------
# 元スキル: project-create-issues/SKILL.md Step 5
delete_draft_item() {
  local item_id="$1"

  gh project item-delete "${PROJECT_NUMBER}" \
    --owner "${OWNER}" \
    --id "${item_id}"
}

# ----------------------------------------------------------------
# アイテムをアーカイブする（Done 状態のアイテムをアーカイブ等）
# ----------------------------------------------------------------
# 元スキル: skills/project-archive-done/SKILL.md
archive_item() {
  local item_id="$1"

  gh project item-archive "${PROJECT_NUMBER}" \
    --owner "${OWNER}" \
    --id "${item_id}"
}

# ----------------------------------------------------------------
# メイン: 動作確認用のデモ（実際には各関数を用途に合わせて呼び出す）
# ----------------------------------------------------------------
main() {
  echo "[INFO] プロジェクト情報を確認中..."
  local project_id
  project_id=$(get_project_id)
  echo "[INFO] プロジェクト ID: ${project_id}"

  echo "[INFO] フィールド一覧を取得中..."
  get_field_list | python3 -m json.tool | head -40

  echo ""
  echo "[INFO] アイテム一覧を取得中..."
  list_items | python3 -c "
import sys, json
data = json.load(sys.stdin)
items = data.get('items', [])
print(f'合計 {len(items)} 件')
for item in items[:5]:
    print(f'  - {item.get(\"title\", \"(タイトルなし)\")} [{item.get(\"type\")}]')
"

  echo ""
  echo "[INFO] 使用例（コメントアウトを外して使用）:"
  echo "  create_draft_item \"feat: 新機能タイトル\" \"本文説明\""
  echo "  set_single_select_field \"\$item_id\" \"\$project_id\" \"\$status_field_id\" \"\$in_progress_option_id\""
}

main "$@"

#!/usr/bin/env bash
# git-commit.sh — Conventional Commits 形式でのコミット実例
#
# 使い方: ./script/git-commit.sh
# 元スキル: skills/create-commit/SKILL.md（Step 5: コミットを実行する）
#           skills/contribute-skill/SKILL.md（Step 9: ブランチ作成・コミット）
#           .claude/rules/conventional-commits.md（コミット実行パターン）
#
# 重要:
#   - --no-verify は絶対に使用しない（pre-commit フック回避禁止）
#   - printf -v で変数にビルドすることで特殊文字・コマンド展開を安全に扱える
#   - .env や認証情報ファイルが staged に含まれる場合はコミットを中止する

set -euo pipefail

# ----------------------------------------------------------------
# シークレット混入チェック
# ----------------------------------------------------------------
check_no_secrets() {
  local secret_files
  secret_files=$(git diff --cached --name-only | grep -E '(\.env|credentials\.json|\.pem|\.key|id_rsa)' || true)

  if [[ -n "$secret_files" ]]; then
    echo "[ERROR] シークレットが含まれる可能性のあるファイルが staged に含まれています:" >&2
    echo "$secret_files" >&2
    echo "[ERROR] git restore --staged <ファイル名> でステージングを解除してください。" >&2
    exit 1
  fi
}

# ----------------------------------------------------------------
# staged 変更の確認
# ----------------------------------------------------------------
check_staged() {
  local staged
  staged=$(git diff --cached --name-only)

  if [[ -z "$staged" ]]; then
    echo "[INFO] staged な変更がありません。git add でファイルをステージングしてください。"
    git status
    exit 1
  fi

  echo "[INFO] staged ファイル:"
  git diff --cached --name-only
  echo ""
}

# ----------------------------------------------------------------
# コミット実行（printf -v で変数にビルドし特殊文字を安全に渡す）
# ----------------------------------------------------------------
# 引数: TYPE SCOPE SUBJECT [BODY]
#   TYPE:    Conventional Commits の type（feat, fix, docs, refactor, test, chore, ...）
#   SCOPE:   スコープ（省略可。省略する場合は "" を渡す）
#   SUBJECT: コミットメッセージの件名（72文字以内、命令形・現在形）
#   BODY:    コミットメッセージの本文（任意）
do_commit() {
  local type="${1:?TYPE が必要です}"
  local scope="${2:-}"
  local subject="${3:?SUBJECT が必要です}"
  local body="${4:-}"

  # scope がある場合は括弧付きで結合
  local scope_part=""
  if [[ -n "$scope" ]]; then
    scope_part="(${scope})"
  fi

  # 件名の長さチェック
  local full_subject="${type}${scope_part}: ${subject}"
  if [[ ${#full_subject} -gt 72 ]]; then
    echo "[WARN] 件名が 72 文字を超えています (${#full_subject} 文字): ${full_subject}" >&2
  fi

  local full_msg
  if [[ -n "$body" ]]; then
    printf -v full_msg '%s%s: %s\n\n%s\n\nCo-Authored-By: Claude <noreply@anthropic.com>' \
      "${type}" "${scope_part}" "${subject}" "${body}"
  else
    printf -v full_msg '%s%s: %s\n\nCo-Authored-By: Claude <noreply@anthropic.com>' \
      "${type}" "${scope_part}" "${subject}"
  fi
  git commit -m "$full_msg"
}

# ----------------------------------------------------------------
# 使用例（実際の引数は書き換えて使う）
# ----------------------------------------------------------------
main() {
  check_staged
  check_no_secrets

  # 例 1: feat(auth): ソーシャルログイン機能を追加
  # do_commit "feat" "auth" "ソーシャルログイン機能を追加"

  # 例 2: fix(api): レスポンスのエラーハンドリングを修正（本文付き）
  # do_commit "fix" "api" "レスポンスのエラーハンドリングを修正" "500 エラー時に詳細メッセージを返すよう修正。\nRefs #42"

  # 例 3: chore(skills): symlink を作成（scope なし）
  # do_commit "chore" "" "symlink を作成"

  # 例 4: Breaking Change
  # do_commit "feat!" "auth" "認証 API の仕様を変更" "BREAKING CHANGE: レスポンス形式が v1 と互換性なし。移行手順は docs/ 参照。"

  echo "[INFO] 使用例をコメントアウトから選択して実行してください。"
  echo "       型: feat fix docs refactor test chore style build ci perf"
}

main "$@"

#!/usr/bin/env bash
# skills-sync.sh — スキルの symlink 作成と skills-lock.json 同期の実例
#
# 使い方: ./script/skills-sync.sh [skill-name]
# 元スキル: skills/contribute-skill/SKILL.md（Step 6: upstream clone）
#           skills/sync-skills-lock/SKILL.md（Step 3〜7: ハッシュ同期）
#           .claude/agents/author/skill-author.md（Step 5: symlink 案内）
#           .claude/rules/skill-authoring.md（新スキル追加手順 Step 2）
#
# このスクリプトは以下の2つの用途をカバーする:
#   1. 新スキルの symlink を .claude/skills/ に作成する
#   2. skills-lock.json の computedHash を upstream と同期する（確認のみ）

set -euo pipefail

REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"

# ----------------------------------------------------------------
# 用途1: スキルの symlink を作成する
# ----------------------------------------------------------------
# 元スキル: skill-authoring.md Step 2
#   ln -s ../../skills/<name> .claude/skills/<name>
#
# .claude/skills/<name> → ../../skills/<name>/SKILL.md を辿れるようにする。
# 相対パスで指定することで、リポジトリをどこに clone しても壊れない。
create_symlink() {
  local skill_name="${1:?スキル名が必要です}"
  local skills_dir="${REPO_ROOT}/skills"
  local dotclaude_skills_dir="${REPO_ROOT}/.claude/skills"

  # スキルディレクトリの存在確認
  if [[ ! -d "${skills_dir}/${skill_name}" ]]; then
    echo "[ERROR] skills/${skill_name}/ が存在しません。" >&2
    echo "[INFO]  先に skills/${skill_name}/SKILL.md を作成してください。" >&2
    exit 1
  fi

  # .claude/skills/ ディレクトリが存在しなければ作成
  mkdir -p "${dotclaude_skills_dir}"

  # symlink が既に存在する場合はスキップ
  if [[ -e "${dotclaude_skills_dir}/${skill_name}" ]]; then
    echo "[INFO] symlink は既に存在します: .claude/skills/${skill_name}"
    ls -la "${dotclaude_skills_dir}/${skill_name}"
    return 0
  fi

  # 相対パスで symlink を作成（絶対パスを避けることでポータブルになる）
  # ln の -s オプションのみ使用。-f（強制上書き）は使わない（安全のため）
  (
    cd "${dotclaude_skills_dir}"
    ln -s "../../skills/${skill_name}" "${skill_name}"
  )

  echo "[OK] symlink 作成: .claude/skills/${skill_name} -> ../../skills/${skill_name}"
}

# ----------------------------------------------------------------
# 全スキルの symlink 状態を確認する
# ----------------------------------------------------------------
# 元スキル: .claude/agents/quality/frontmatter-linter.md Step 4
check_symlinks() {
  local dotclaude_skills_dir="${REPO_ROOT}/.claude/skills"

  echo "[INFO] .claude/skills/ の symlink 状態:"
  echo ""

  local broken=0
  for link in "${dotclaude_skills_dir}"/*; do
    local link_name
    link_name=$(basename "${link}")
    local target
    target=$(readlink "${link}" 2>/dev/null || echo "(readlink 失敗)")

    if [[ -e "${link}" ]]; then
      echo "  OK:     ${link_name} -> ${target}"
    else
      echo "  BROKEN: ${link_name} -> ${target}"
      broken=$((broken + 1))
    fi
  done

  echo ""
  if [[ "$broken" -gt 0 ]]; then
    echo "[WARN] リンク切れが ${broken} 件あります。"
    echo "[INFO] 修正方法: ln -s ../../skills/<name> .claude/skills/<name>"
  else
    echo "[OK] リンク切れなし"
  fi
}

# ----------------------------------------------------------------
# スキル一覧と symlink の対応を確認する
# ----------------------------------------------------------------
check_all_skills_have_symlinks() {
  local skills_dir="${REPO_ROOT}/skills"
  local dotclaude_skills_dir="${REPO_ROOT}/.claude/skills"

  echo "[INFO] skills/ ↔ .claude/skills/ の対応確認:"
  echo ""

  local missing=0
  for skill_dir in "${skills_dir}"/*/; do
    local skill_name
    skill_name=$(basename "${skill_dir}")

    if [[ -e "${dotclaude_skills_dir}/${skill_name}" ]]; then
      echo "  OK:      ${skill_name}"
    else
      echo "  MISSING: ${skill_name} (symlink がありません)"
      missing=$((missing + 1))
    fi
  done

  echo ""
  if [[ "$missing" -gt 0 ]]; then
    echo "[WARN] symlink がないスキルが ${missing} 件あります。"
    echo "[INFO] 追加コマンド:"
    for skill_dir in "${skills_dir}"/*/; do
      local skill_name
      skill_name=$(basename "${skill_dir}")
      if [[ ! -e "${dotclaude_skills_dir}/${skill_name}" ]]; then
        echo "  ln -s ../../skills/${skill_name} .claude/skills/${skill_name}"
      fi
    done
  else
    echo "[OK] 全スキルに symlink があります"
  fi
}

# ----------------------------------------------------------------
# skills-lock.json の computedHash を確認する（読み取り専用）
# ----------------------------------------------------------------
# 元スキル: sync-skills-lock/SKILL.md Step 4〜5
# 実際の更新は sync-skills-lock スキルが行う。このスクリプトは確認のみ。
check_skills_lock() {
  local lock_file="${REPO_ROOT}/skills-lock.json"

  if [[ ! -f "$lock_file" ]]; then
    echo "[INFO] skills-lock.json が見つかりません（スキップ）"
    return 0
  fi

  echo "[INFO] skills-lock.json のスキル一覧:"
  LOCK_FILE="${lock_file}" python3 - <<'PYEOF'
import json, os
with open(os.environ['LOCK_FILE']) as f:
    d = json.load(f)
skills = d.get('skills', {})
print(f'  合計 {len(skills)} スキル')
for name, info in skills.items():
    source = info.get('source', '(source なし)')
    h = info.get('computedHash', '(hash なし)')
    print(f'  - {name}: source={source}, hash={h[:10]}...')
PYEOF
}

# ----------------------------------------------------------------
# メイン
# ----------------------------------------------------------------
main() {
  local skill_name="${1:-}"

  if [[ -n "$skill_name" ]]; then
    echo "[INFO] スキル '${skill_name}' の symlink を作成します..."
    create_symlink "${skill_name}"
    echo ""
    echo "[INFO] 次のステップ:"
    echo "  1. update-docs スキルを実行して CLAUDE.md を更新する"
    echo "  2. git add .claude/skills/${skill_name} && git commit -m 'chore(skills): ${skill_name} の symlink を追加'"
  else
    echo "[INFO] 全スキルの状態を確認します..."
    echo ""
    check_symlinks
    echo ""
    check_all_skills_have_symlinks
    echo ""
    check_skills_lock
  fi
}

main "$@"