fandhe-ai/agent-cli-skills

project-update-items

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

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/fandhe-ai/agent-cli-skills --skill project-update-items

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

project-update-items

プロジェクトアイテムのフィールド値を一括で更新します。ステータス変更、優先度変更、サイズ設定などに対応します。

前提条件

  • 対象の GitHub Project にアイテムが存在すること
  • gh CLI がインストールされ、認証済みであること(project スコープ付き)

フロー

Step 1: 更新対象と更新内容を確認する

ユーザーから以下を確認する。起動時の指示に指定があればそれに従い、足りなければ聞く。非対話で得られなければ書き込まずに報告して止める。

  • 対象の指定方法:
  • クエリフィルタ(例: status:Todo, label:bug, assignee:@me)
  • アイテム番号の直接指定
  • 全件
  • 更新するフィールド: Status, Priority, Size, またはカスタムフィールド
  • 新しい値: 例: Status → "In Progress", Priority → "High"

Step 2: フィールドメタデータを取得する

bash
# プロジェクト ID を取得
gh project view <number> --owner <owner> --format json -q '.id'

# フィールド ID とオプション ID を取得
gh project field-list <number> --owner <owner> --format json

jq で対象フィールドの ID と、更新先の値に対応するオプション ID を解決する。

Step 3: 対象アイテムを検索する

bash
gh project item-list <number> \
  --owner <owner> \
  --format json \
  --limit 999

ユーザー指定の条件でアイテムをフィルタする。--query パラメータが使える場合はそちらを優先:

bash
gh project item-list <number> \
  --owner <owner> \
  --query "status:Todo" \
  --format json

Step 4: ユーザーに更新内容を確認する

更新対象と変更内容を一覧表示:

以下の N 件のアイテムを更新します:
- #1: ソーシャルログイン — Status: Todo → In Progress
- #2: パスワードリセット — Status: Todo → In Progress

実行しますか?

一括更新の前に確認し、明示的な返答を待つ。「Todo を全部 In Progress に変更して」等、このスキルを起動する依頼そのものは、この確認の承認にならない。起動時の指示にこの確認を省くことの明示(例: 「確認なしで進めてよい」)が含まれている場合に限り、確認を省いて続行してよい。承認が無く対話もできない環境(非対話実行)では、実行せずに対象(件数・タイトル等)と確認事項を報告して止める。

Step 5: フィールド値を一括更新する

Step 4 で承認を得たら、更新を実行する。

各アイテムに対してフィールド値を更新:

bash
gh project item-edit \
  --id <item-id> \
  --field-id <field-id> \
  --project-id <project-id> \
  --single-select-option-id <option-id>

フィールドタイプに応じて適切なフラグを使用:

  • SINGLE_SELECT: --single-select-option-id
  • TEXT: --text
  • NUMBER: --number
  • DATE: --date(YYYY-MM-DD 形式)

Step 6: 更新結果を報告する

更新されたアイテムの一覧を表示:

#タイトルフィールド旧値新値
1ソーシャルログインStatusTodoIn Progress
2パスワードリセットStatusTodoIn Progress

注意事項

  • バッチ更新前にユーザーの確認を得る(Step 4 の確認を参照)
  • オプション値がプロジェクトのフィールド定義に存在しない場合はエラーを報告する
  • 複数フィールドを同時に更新する場合は、フィールドごとに item-edit を実行する
  • GitHub API レート制限に注意し、大量更新時はバッチサイズを調整する
  • ネットワークを要する(主に API 経由。後述の「sandbox 環境での実行」節を参照)

検証

Step 6 完了後、以下で更新内容を確認する:

bash
gh project item-list <number> --owner <owner> --format json --limit 999

対象アイテムのフィールド値が新しい値に変わっていれば完了。

sandbox 環境での実行

このスキルはネットワーク越しの GitHub 操作(gh project item-edit)を必須とする。該当コマンドはコマンド単位で sandbox 無効にして実行する。ネットワーク遮断を解除できない環境では実行できない。.git・.agents・.codex へ書く手順は無い。codex exec では昇格要求が出ないため、ネットワークを使えずコマンドを実行できなかったときは、書き込みをせず、できなかった旨を報告して止める。

du même dépôt

Autres Skills

Tous les Skills
fandhe-ai
Communauté

project-view-status

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

Installations / 1h
4
GitHub Stars
2
Mis à jour
17 nov.
fandhe-ai
Communauté

create-skill

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

Installations / 1h
1
GitHub Stars
2
Mis à jour
14 oct.
fandhe-ai
Communauté

comment-code

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

Installations / 1h
1
GitHub Stars
2
Mis à jour
10 oct.
fandhe-ai
Communauté

contribute-skill

ローカルで改修した skills/ / を upstream リポジトリ (Fandhe-AI/agent-cli-skills 等) へ PR として投稿する。skills-lock.json の source を読み、Fandhe-AI/ 以外への push は安全弁で中止。clone → 反映 → セキュリティチェック → ブランチ作成 → push → gh pr create を実行。マージ後は sync-skills-lock で hash 更新。「スキルを upstream に貢献」「外部リポジトリに PR」などで使用。

Installations / 1h
1
GitHub Stars
2
Mis à jour
10 oct.