fandhe-ai/agent-cli-skills

project-init

GitHub Project v2 を新規作成し、Status/Priority/Size の標準フィールドを設定してリポジトリにリンクする。Auto-add/Auto-archive/Auto-close 等のビルトインワークフロー設定 URL もガイド (CLI 不可・Web UI のみ)。「プロジェクト作って」「Project v2 セットアップ」「カンバン作成」などで使用。

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/fandhe-ai/agent-cli-skills --skill project-init

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

project-init

GitHub Project v2 を新規作成し、標準フィールドを設定してリポジトリにリンクします。ビルトインワークフロー(自動ステータス変更・自動追加・自動アーカイブ)の設定もガイドします。

前提条件

  • gh CLI がインストールされ、認証済みであること
  • project スコープが付与されていること(gh auth status で確認)

フロー

Step 1: プロジェクト情報を確認する

ユーザーから以下を確認:

  • プロジェクトタイトル
  • オーナー(ユーザー or Organization)
  • 可視性(PUBLIC / PRIVATE)
  • 説明文(任意)

オーナーが未指定の場合は自動検出:

bash
gh repo view --json owner -q '.owner.login'

Step 2: プロジェクトを作成する

bash
gh project create \
  --owner <owner> \
  --title "<タイトル>" \
  --format json

出力からプロジェクト番号を取得する。

Step 3: リポジトリにリンクする

bash
gh project link <number> --owner <owner>

Step 4: 標準フィールドを作成する

以下のフィールドを順次作成する:

bash
# Status(デフォルトで存在する場合はスキップ)
gh project field-create <number> \
  --owner <owner> \
  --name "Status" \
  --data-type "SINGLE_SELECT" \
  --single-select-options "Todo,In Progress,In Review,Done"

# Priority
gh project field-create <number> \
  --owner <owner> \
  --name "Priority" \
  --data-type "SINGLE_SELECT" \
  --single-select-options "High,Medium,Low"

# Size
gh project field-create <number> \
  --owner <owner> \
  --name "Size" \
  --data-type "SINGLE_SELECT" \
  --single-select-options "XS,S,M,L,XL"
Note: Status フィールドは GitHub が自動作成する場合がある。エラーが出た場合は既存フィールドをそのまま使用する。

Step 5: プロジェクトの説明を設定する

bash
gh project edit <number> \
  --owner <owner> \
  --description "<説明文>" \
  --visibility <PUBLIC|PRIVATE>

Step 6: ビルトインワークフローを設定する

GitHub Projects v2 にはコード不要のビルトインワークフローがある。プロジェクト設定画面でユーザーに以下の有効化をガイドする。

設定 URL: https://github.com/orgs/<owner>/projects/<number>/workflows (個人プロジェクトの場合: https://github.com/users/<owner>/projects/<number>/workflows)

推奨するビルトインワークフロー

ワークフロー動作デフォルト状態推奨
Item closedIssue/PR がクローズされたら Status → Done有効そのまま維持
Pull request mergedPR がマージされたら Status → Done有効そのまま維持
Item reopenedIssue が再オープンされたら Status → Todo無効有効化を推奨
Item added to projectアイテム追加時に Status → Todo無効有効化を推奨
Auto-add to projectフィルタに一致する Issue/PR を自動追加無効有効化を推奨
Auto-archive itemsDone から N 日後に自動アーカイブ無効任意
Auto-close issueボードで Done にすると Issue を自動クローズ無効有効化を強く推奨
重要: Auto-close を有効にしないと、ボード上で Status を Done にしても Issue は自動クローズされない。双方向同期には必須。

Auto-add フィルタ例

is:issue,pr is:open repo:<owner>/<repo>

ラベルで絞り込む場合:

is:issue,pr is:open label:sprint-1 repo:<owner>/<repo>

Step 7: 継続的自動同期の案内

ビルトインワークフローではカバーできない PR ライフサイクル連動(opened→In Progress, review_requested→In Review)などの高度な同期が必要な場合は、project-sync-issues スキルで GitHub Actions ワークフローを生成できることを案内する。

Step 8: 作成結果を報告する

以下の情報を表示:

  • プロジェクト URL
  • プロジェクト番号
  • 作成されたフィールド一覧
  • リンクされたリポジトリ
  • ビルトインワークフロー設定 URL
  • 推奨設定のチェックリスト

注意事項

  • Status のオプション値はユーザーの要望に応じてカスタマイズ可能
  • フィールド作成でエラーが発生した場合(既に存在する等)はスキップして続行する
  • Organization プロジェクトの場合、適切な権限が必要
  • ビルトインワークフローは CLI/API では設定できないため、Web UI での設定が必要
  • ネットワークを要する(主に API 経由。後述の「sandbox 環境での実行」節を参照)

検証

Step 8 完了後、以下で作成結果を確認する:

bash
gh project view <number> --owner <owner> --format json
gh project field-list <number> --owner <owner> --format json

プロジェクト URL・フィールド一覧(Status / Priority / Size)が出力されれば完了。

sandbox 環境での実行

このスキルはネットワーク越しの GitHub 操作(Project v2 作成・フィールド設定)を必須とする。該当コマンドはコマンド単位で sandbox 無効にして実行する。ネットワーク遮断を解除できない環境では実行できない。

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills
fandhe-ai
커뮤니티

project-update-items

プロジェクトアイテムのフィールド値 (Status/Priority/Size 他) をクエリフィルタやアイテム指定で絞り込んで一括更新する。SINGLESELECT/TEXT/NUMBER/DATE のフィールドタイプに対応。「Status を In Progress に変更」「優先度を一括更新」「Todo を全部 In Progress に」などで使用。

1시간 설치 수
4
GitHub Stars
2
업데이트
11월 17일
fandhe-ai
커뮤니티

project-view-status

プロジェクトの進捗をステータス別・優先度別・サイズ別に集計してレポートを生成する。完了率と未完了の優先度内訳を表形式で出力する読み取り専用スキル。「進捗を見せて」「プロジェクトレポート」「完了率は?」「ステータス別の件数」などで使用。

1시간 설치 수
4
GitHub Stars
2
업데이트
11월 17일
fandhe-ai
커뮤니티

create-skill

新規スキルを skills/ /SKILL.md として scaffold する。命名・配置の重複確認、SKILL.md 作成、 symlink 設定、品質チェック、CLAUDE.md 反映までを一貫して自動化。「スキル作って」「新しいスキルを追加」 「create-skill」などで使用。Agent 定義の追加は create-agent、ドキュメント更新は update-docs を参照。

1시간 설치 수
1
GitHub Stars
2
업데이트
10월 14일
fandhe-ai
커뮤니티

comment-code

コードにコメント・ドキュメンテーションコメントを追加・補強する。「コメント追加して」「コメント書いて」 「コメントを補強して」「JSDoc 付けて」「docstring 付けて」「ドキュメンテーションコメント付けて」で使用。 パッケージ・サービス視点での役割境界、呼び出し元・呼び出し先の前提と契約、他ファイル・他サービスからの 文脈を「その場で読める」形で残す。コード自体は変更しない(実装変更は implement-issue へ)。 詳細規約は code-comment-style、コミット作成は create-commit、CLAUDE.md 同期は update-docs を参照。

1시간 설치 수
1
GitHub Stars
2
업데이트
10월 10일