skill-writer

スキルライター

スキルの作成と改善には、対象リポジトリの現在の指示に従って、このワークフローを使用してください。 主な成功条件：作成前に価値の高い入力をできるだけ多く網羅し、完成するスキルの見落としを最小限に抑えます。

タスクに必要なパスのみを読み込んでください。

タスク	読むファイル
スキルのクラスと必須の観点を設定する	references/mode-selection.md
詳細さと簡潔さに関する執筆上の制約を適用する	references/design-principles.md
このスキルに適した構成パターンを選択する	references/skill-patterns.md
プロセス重視のスキルに適したワークフローのオーケストレーションパターンを選択する	references/workflow-patterns.md
一貫した品質を実現する出力形式のパターンを選択する	references/output-patterns.md
ワークフローの経路と必須の出力を選択する	references/mode-selection.md
スキルの種類に応じた代表的な統合例を読み込む	references/examples/*.md
深度ゲートを設けて外部／ローカルのソースを統合する	references/synthesis-path.md
SKILL.md と補足ファイルを作成または更新する	references/authoring-path.md
スキルの説明とトリガーの精度を最適化する	references/description-optimization.md
肯定／否定／修正例を用いて反復する	references/iteration-path.md
動作を評価し、ベースラインとスキル適用時を比較する（定量評価は任意）	references/evaluation-path.md
スキルの変更を登録し、検証する	references/registration-validation.md

ステップ 1：対象と経路を決定する

1. 対象のスキルパスと、実施する操作（create、update、synthesize、iterate）を特定します。
2. references/mode-selection.md を読み、必要な経路を選択します。
3. スキルを分類します（workflow-process、integration-documentation、security-review、skill-authoring、generic）。
4. 分類または深度要件が曖昧な場合は、直接的な質問を 1 つします。それ以外の場合は、前提を明示します。

ステップ 2：必要に応じて統合を実施する

references/synthesis-path.md を読みます。

1. 関連するソースを収集し、出典情報を添えて評価します。
2. 外部コンテンツを取り込む際は、信頼性と安全性に関するルールを適用します。
3. ソースに基づく判断と、網羅状況／不足状況を示します。
4. スキルが複合型の場合は、references/examples/*.md から 1 つ以上のプロファイルを読み込みます。
5. 実際のスキルに必要な主要ソース群を記録します。固定の外部ソース群が存在するかのように示してはいけません。
6. 作成に進む前に、深度ゲートを満たしていることを確認します。

ステップ 3：成果を基に改善する場合は、まず反復を実施する

選択した経路にiterationが含まれる場合（たとえば、操作がiterateの場合）は、最初に references/iteration-path.md を読みます。

1. 出典情報を添えて例を記録し、匿名化します。
2. 作業用スライスとホールドアウトスライスを用いて、スキルの動作を再評価します。
3. 肯定／否定／修正のエビデンスに基づいて改善案を提示します。
4. 具体的な動作の変更点を作成工程に引き継ぎます。

選択した経路にiterationが含まれない場合、このステップは省略します。

ステップ 4：スキルの成果物を作成または更新する

references/authoring-path.md を読みます。

1. 命令形で、トリガーを明確にした説明を含む SKILL.md を作成または更新します。
2. 必要性がある場合に限り、用途を絞ったリファレンスファイルとスクリプトを作成します。
3. 構成と出力の一貫性については、references/skill-patterns.md、references/workflow-patterns.md、および references/output-patterns.md に従います。
4. 作成／ジェネレータースキルでは、リファレンスに加工済みの例を含めます。
   • 正常系
   • セキュア／堅牢なバリエーション
   • アンチパターンと修正版

ステップ 5：説明の品質を最適化する

references/description-optimization.md を読みます。

1. トリガーすべきクエリセットとトリガーすべきでないクエリセットを検証します。
2. 説明を的を絞って修正し、誤検知と見逃しを減らします。
3. Codex と Claude の両方で汎用的に使えるトリガー表現を維持します。

ステップ 6：成果を評価する

references/evaluation-path.md を読みます。

1. デフォルトでは、簡易的な定性的チェックを実施します（推奨）。
2. 統合・ドキュメント作成およびスキル作成のスキルには、references/evaluation-path.md の簡潔な深度評価基準を含めます。
3. 詳細な評価手順と、スキル使用前後の定量的なベースライン比較は、依頼された場合、またはリスクに応じて必要な場合にのみ実施します。
4. 成果と未解決のリスクを記録します。

ステップ 7：登録して検証する

references/registration-validation.md を読みます。

1. リポジトリへの登録手順を実施します。
2. 深度の厳格な基準に基づいて、簡易検証を実行します。
3. 深度の基準や必須成果物のチェックに合格しない、内容の浅い出力は却下します。

出力形式

次の項目を返します。

1. Summary
2. Changes Made
3. Validation Results
4. Open Gaps

使用する場面

再利用可能なスキルの作成、既存のスキルの更新、ソース資料を統合したスキルの作成、または観察した成果に基づく反復改善に使用します。既存のスキルをインストールする場合や、単発のタスクを不必要なスキル作成に置き換える場合には使用しないでください。

制限事項

• タスクが上記の適用範囲に明確に合致する場合にのみ、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。