agent-script-writing

name	agent-script-writing
description	.agents/scripts/ や skills/*/scripts/ 配下のシェルスクリプトを作成・整備する。エージェントが実行する前提の統一ルール（shebang、エラーハンドリング、日本語コメント、ステップ分割）に従う。「.agents/scripts」「skills/*/scripts」「#!/bin/bash」「スクリプト作成」「スクリプトを整える」などの言及時に使用。
user-invokable	false

agent-script-writing

.agents/scripts/ や skills/*/scripts/ 配下に配置するスクリプトの作成・整備ルール。
エージェント実行前提で統一された品質を保つ。

よくある致命的なミス

• ❌ shebang なし・実行権限なし → エージェントが bash xxx.sh と書く必要がある

• ✅ #!/bin/bash + 実行権限 → ./xxx.sh で直接実行可能

• ❌ コメントが英語・欠落 → 修正時に意図を損なう

• ✅ 日本語コメント → 目的とステップを明示

• ❌ エラーハンドリングなし → 途中で失敗しても続行してしまう

• ✅ set -euo pipefail → エラー時に即座に終了

統一ルール

配置原則: skills/{skill}/scripts/ に配置。汎用的なもののみ .agents/scripts/

1. shebang: #!/bin/bash を1行目に
2. エラーハンドリング: set -euo pipefail
3. 上部コメント: 目的と使い方を日本語で1-2行
4. 引数チェック: 最低限のみ（usage関数不要）
5. ステップ分割: 論理的なまとまりで改行+日本語コメント

詳細なテンプレートは references/templates.md 参照。

Quick Start

# 1. init_script.sh で雛形生成（実行権限も自動付与)
.agents/skills/agent-script-writing/scripts/init_script.sh .agents/scripts/new_script.sh

# 2. エディタで内容を実装
# - 目的コメント記述
# - 引数チェック調整
# - 各ステップ実装

# 3. 動作確認
.agents/scripts/new_script.sh test_arg

完成時は references/checklist.md で確認。
コード例は references/examples.md 参照。

---

エージェント実行前提で、統一ルールに従い保守しやすいスクリプトを作成する。