自動化スクリプティング

概要

再利用可能で保守性の高いスクリプトを設計し、反復作業を自動化する。 詳細は references/ に外部化し、必要時に参照する。

• テンプレは assets/script-template.sh
• 実装パターンは references/script-patterns.md

ワークフロー

Phase 1: 目的と前提の整理

目的: 自動化対象と制約を整理する

アクション:

1. references/Level1_basics.md で基礎概念を確認
2. 自動化対象の範囲と入出力を整理
3. 実行環境と権限の制約を確認

Task: agents/analyze-automation-context.md

Phase 2: スクリプト設計と実装

目的: 冪等性とエラーハンドリングを含む設計を行う

アクション:

1. references/Level2_intermediate.md で実装パターンを確認
2. assets/script-template.sh を基に構造を決定
3. ログとエラー処理を設計する

Task:

• agents/design-automation-script.md
• agents/implement-automation-script.md

Phase 3: 検証と記録

目的: スクリプトの検証と記録を行う

アクション:

1. 実行結果を確認して改善点を整理
2. scripts/validate-skill.mjs で構造検証
3. scripts/log_usage.mjs で改善記録

Task: agents/validate-automation-script.md

Task仕様ナビ

ベストプラクティス

すべきこと

• 冪等性を前提に設計する
• 失敗時のエラー出力を明示する
• 実行ログを必ず残す
• 実行環境の差分を考慮する

避けるべきこと

• ハードコードされたパスやシークレット
• 例外処理なしの実行
• 実行結果の検証を省略する

リソース参照

参照資料

• references/Level1_basics.md: 基礎概念
• references/Level2_intermediate.md: 実装パターン
• references/Level3_advanced.md: CI/CD統合
• references/Level4_expert.md: 分散処理と高度運用
• references/script-patterns.md: スクリプトパターン
• references/legacy-skill.md: 旧版要約（移行時のみ参照）

スクリプト

• scripts/validate-skill.mjs: スキル構造検証
• scripts/log_usage.mjs: 実行ログ記録

テンプレート

• assets/script-template.sh: スクリプトテンプレ

変更履歴