アーティファクト管理（GitHub Actions）

概要

GitHub Actions ワークフロー内で成果物を管理するための設計・実装・検証の手順を提供する。 必要な詳細は references/ に外部化し、必要時にのみ参照する。

• ワークフロー例は assets/artifact-workflow.yaml を使用
• 仕様確認は references/upload-artifact.md と references/download-artifact.md を参照

ワークフロー

Phase 1: 目的と利用パターンの整理

目的: アーティファクトの用途と制約を明確化する

アクション:

1. references/Level1_basics.md で基礎概念を確認
2. ジョブ間/ワークフロー間の共有要件を整理
3. 期待される保持期間と容量制約を整理

Task: agents/analyze-artifact-context.md

Phase 2: 設計と実装

目的: アップロード/ダウンロードのフローと保持戦略を設計する

アクション:

1. assets/artifact-workflow.yaml を基にフローを構成
2. references/upload-artifact.md でアップロード仕様を確認
3. references/download-artifact.md でダウンロード仕様を確認
4. references/retention-optimization.md で保持期間を決定

Task:

• agents/design-artifact-flow.md
• agents/implement-artifact-steps.md

Phase 3: 検証と最適化

目的: 実装の信頼性とストレージ効率を確認する

アクション:

1. scripts/validate-skill.mjs でスキル構造を検証
2. scripts/cleanup-artifacts.mjs で削除戦略を検討
3. scripts/log_usage.mjs で改善フィードバックを記録

Task: agents/optimize-retention.md

Task仕様ナビ

ベストプラクティス

すべきこと

• 利用パターン（ジョブ間/ワークフロー間）を明確化する
• retention-days を目的に合わせて明示する
• アーティファクト名に識別子（SHA/Run ID）を含める
• 容量削減のために不要ファイルを除外する
• クリーンアップの方針を事前に決める

避けるべきこと

• 保持期間の無制限設定
• 古い成果物を参照するフロー設計
• 圧縮前の不要ファイル削除を省略する
• cleanup を手動運用だけに依存する

リソース参照

参照資料

• references/Level1_basics.md: 基本概念と最小チェック
• references/Level2_intermediate.md: 実装パターン
• references/Level3_advanced.md: 複数アーティファクト運用
• references/Level4_expert.md: 最適化とトラブルシュート
• references/upload-artifact.md: upload-artifact の仕様
• references/download-artifact.md: download-artifact の仕様
• references/retention-optimization.md: 保持期間と容量最適化
• references/legacy-skill.md: 旧版要約（移行時のみ参照）

スクリプト

• scripts/cleanup-artifacts.mjs: アーティファクト削除の補助
• scripts/validate-skill.mjs: スキル構造検証
• scripts/log_usage.mjs: 実行ログ記録

テンプレート

• assets/artifact-workflow.yaml: ワークフロー例

変更履歴