add-config-field について
add-config-fieldは、majestic-engineerプラグインの`.agents.yml`スキーマにフィールドを追加する開発スキルです。テンプレート、スキーマのバージョン管理、移行ロジック、プラグインのバージョン更新、検証手順を扱います。
主な機能
- 014種類の設定テンプレートに項目を追加
- 02スキーマバージョンの更新
- 03変更履歴と移行時の既定値を更新
- 04プラグインとマーケットプレイスの版を同期
- 05シェルコマンドで変更を検証
活用シーン
- 01`.agents.yml`への設定項目の追加
- 02設定スキーマの移行管理
- 03新しい項目を読むAgentやコマンドの文書更新
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ majesticlabs-dev/ majestic-marketplace --skill add-config-fieldインストール後、Claude Code で/add-config-fieldを入力して読み込まれたか確認します。
詳細
設定フィールドの追加
適切なバージョン管理と移行サポートを備えた新しいフィールドを、.agents.yml の設定スキーマに追加します。
変更したファイル
| ファイル | 目的 |
|---|---|
plugins/majestic-engineer/commands/workflows/init.md | .agents.yml を生成する 4 つの YAML テンプレート |
plugins/majestic-engineer/config-schema-version | スキーマのバージョン番号 |
plugins/majestic-engineer/agents/config-reader.md | 変更履歴と移行ロジック |
plugins/majestic-engineer/.claude-plugin/plugin.json | プラグインのバージョン |
.claude-plugin/marketplace.json | マーケットプレイスのバージョン |
入力
- フィールド名:例:
auto_commit - デフォルト値:例:
falseまたは複数行の YAML - セクション:テンプレート内の場所(Workflow、Quality Gate など)
- コメント:行内の説明
- 使用元:このフィールドを読み取るエージェント/コマンド
手順
1. init.md のテンプレートを更新する
ファイル: plugins/majestic-engineer/commands/workflows/init.md
4 つすべてのテンプレート(Rails、Python、Node、Generic)にフィールドを追加します。該当するセクションを見つけ、次を追加します。
new_field: value # Comment explaining purpose
複数行の場合:
new_field: # Comment
- item1
- item2
2. スキーマのバージョンを上げる
ファイル: plugins/majestic-engineer/config-schema-version
インクリメントします:1.1 → 1.2
3. config-reader.md を更新する
ファイル: plugins/majestic-engineer/agents/config-reader.md
A)バージョン変更履歴テーブルに追加:
| 1.2 | `new_field` | Description |
B)移行 YAML ブロックを更新(「Outdated config_version」セクション内):
new_field: default_value
4. プラグインのバージョンを上げる
ファイル:
plugins/majestic-engineer/.claude-plugin/plugin.json:3.15.0→3.16.0.claude-plugin/marketplace.json:majestic-engineer エントリーのバージョンを更新
5. 利用側のドキュメントを更新する(必要な場合)
特定のエージェント/コマンドがこのフィールドを読み取る場合は、設定について説明するようにドキュメントを更新します。
検証
# Count field in init.md (should be 4 - one per template)
grep -c "new_field" plugins/majestic-engineer/commands/workflows/init.md
# Check schema version
cat plugins/majestic-engineer/config-schema-version
# Check changelog entry
grep "new_field" plugins/majestic-engineer/agents/config-reader.md
コメント
Markdown 対応