contribute-skill

ローカルで改修した .agents/skills/<skill-name>/ を、skills-lock.json に記録された upstream リポジトリへ PR として投稿します。

前提条件

• gh CLI がインストールされ認証済みであること（対象 org への push / PR 権限が必要）
• 対象スキルが skills-lock.json に登録されていること
• 対象スキルのローカル改修が最新のコミットに含まれ、作業ツリーが clean であること

責務の分離

• create-pr: 現在のリポジトリ内でカレントブランチから base へ PR を作成する
• contribute-skill: 別リポジトリ（upstream）へ clone → 変更反映 → push → PR 作成を行う

外部リポジトリ貢献は clone / path 変換 / 異なる認証境界が関わるため、別スキルとして分離しています。

フロー

Step 1: 引数を検証する

SKILL_NAME="$ARGUMENTS"
# 引数が空の場合: .agents/skills/ を列挙してユーザーに選ばせる

対象ディレクトリ: .agents/skills/<SKILL_NAME>/ 存在しなければエラーで中止します。

Step 2: upstream を特定する

ルートの skills-lock.json を読み、skills.<SKILL_NAME>.source を取り出します。

# Python を使わず jq が使えるなら jq で（CLI にあれば）

• source が Fandhe-AI/ で始まらない場合は エラーで中止 します（安全弁：見知らぬリポジトリへ意図せず push しないため）。
• sourceType が github であることも確認します。

Step 3: 変更内容を確認する

git log --oneline -- .agents/skills/<SKILL_NAME>/
git diff HEAD~1 HEAD -- .agents/skills/<SKILL_NAME>/

ユーザーに「この改修内容で upstream に PR を作ってよいか」を確認します。

Step 4: セキュリティチェック（必須）

create-pr と同様に以下をレビューします。

• 認証・認可の実装漏れ
• API キー・シークレットのハードコーディング
• XSS の可能性（ドキュメントでも外部埋め込みが含まれる場合）
• 入力バリデーションの欠如
• OWASP Top 10

問題があれば upstream 貢献を中止し、ユーザーに警告します。

Step 5: 作業用ディレクトリを用意する

UID_VAL=$(id -u)
TS=$(date +%Y%m%d-%H%M%S)
WORKDIR="/tmp/claude-${UID_VAL}/contribute-${SKILL_NAME}-${TS}"
mkdir -p "$WORKDIR"

$TMPDIR が設定されていればそちらを優先します（サンドボックス互換）。

Step 6: upstream を clone する

# sandbox 環境では各コマンドに GIT_SSL_NO_VERIFY=1 を前置する（詳細: docs/sandbox-tls.md）
gh repo clone Fandhe-AI/<repo> "$WORKDIR/upstream"
cd "$WORKDIR/upstream"

デフォルトブランチ（main / master 等）を確認します。

Step 7: 変更を反映する

upstream 側でスキルがどのパス構造に置かれているか確認します。

• 典型パターン 1: skills/<SKILL_NAME>/
• 典型パターン 2: .agents/skills/<SKILL_NAME>/

対応するパスへローカルの .agents/skills/<SKILL_NAME>/ 配下をコピーします。

# 例: upstream 側が skills/<name>/ の場合
cp -R "<local-repo>/.agents/skills/<SKILL_NAME>/." "$WORKDIR/upstream/skills/<SKILL_NAME>/"

Step 8: 差分を確認する

cd "$WORKDIR/upstream"
git status
git diff

ユーザーに差分を見せ、内容が意図通りか確認します。

Step 9: ブランチ作成・コミット

SLUG=$(date +%Y%m%d-%H%M%S)
git switch -c "contribute/<SKILL_NAME>-${SLUG}"
git add <変更パス>
git commit -m "$(cat <<'EOF'
<type>(<scope>): <subject>

ローカルの .agents/skills/<SKILL_NAME>/ からの貢献。

EOF
)"

• Conventional Commits 形式
• --no-verify は使用しない（pre-commit フックを通す）
• co-author は付けない（ローカル規約に合わせる）

Step 10: push と PR 作成

# sandbox 環境では各コマンドに GIT_SSL_NO_VERIFY=1 を前置する（詳細: docs/sandbox-tls.md）
git push -u origin "contribute/<SKILL_NAME>-${SLUG}"

gh pr create \
  --repo Fandhe-AI/<repo> \
  --base main \
  --title "<type>(<scope>): <subject>" \
  --body "$(cat <<'EOF'
## Summary

- <SKILL_NAME> の改修内容（箇条書き）

## Source

ローカルの [ideas リポジトリ](../../) 側で改修後、`/contribute-skill <SKILL_NAME>` により投稿。

## Test plan

- [ ] SKILL.md を実際に Claude Code で実行
- [ ] Conventional Commits に沿ったメッセージ生成を確認
- [ ] エッジケース確認

EOF
)"

Draft PR を作成する場合は --draft を付けます（デフォルトはユーザー確認の上で決定）。

Step 11: PR URL を返す & 後処理案内

• PR URL をユーザーに返す
• 「マージされたら /sync-skills-lock を実行して skills-lock.json の computedHash を更新してください」と案内
• 作業用ディレクトリ $WORKDIR は残したまま（成否が確定するまで）

注意事項

• source が Fandhe-AI/ 以外の場合は中止：意図しない外部リポジトリへの push を防ぐ
• セキュリティ問題が見つかった場合は中止：修正後に再実行
• sandbox 環境での GIT_SSL_NO_VERIFY=1 併用：詳細は後述の「sandbox 環境での実行」節を参照
• upstream のパス構造は事前確認：skills/<name>/ か .agents/skills/<name>/ かは upstream によって異なる
• 既に同名の branch がある場合：秒単位スラッグで通常は衝突しないが、万一の場合はユーザーに確認

sandbox 環境での実行

sandbox で本スキルを実行する場合、ネットワーク越しの GitHub 操作には GIT_SSL_NO_VERIFY=1 の併用を検討してください。本スキルの主なリモート操作は gh repo clone / git push / gh pr create で、「リモート書き込み」判定は 要 です。コマンド分類の詳細と TLS 検証無効化の注意事項は docs/sandbox-tls.md を参照してください。

既存スキルとの関係

• Step 4 のセキュリティチェック、Step 9 の Conventional Commits、Step 10 の PR body は create-pr/SKILL.md の流儀を踏襲
• マージ後は /sync-skills-lock で skills-lock.json の computedHash を更新