10-andruia-skill-smith

🔨 Andru.ia Skill-Smith (The Forge)

使用する場面

ユーザーが、具体的な目的、入力、結果、検証基準を備えたスキルの作成または改善を依頼した場合に使用します。パッケージを自動的にインストールまたは公開する場合には使用しません。

📝 説明

繰り返し実行する目的を、具体的な入力、結果、制約を備えた Andru.ia で利用可能な手順に変換します。スキルを作成しても、インストールや公開はされません。

📋 一般的な指示

• 必須言語： ユーザーから指定がない場合はスペイン語で作成し、指定された言語と対象リポジトリの規約に従います。
• 正式な構成： フォルダー → SKILL.md → 検証の構成に従います。
• シニア品質： 生成するスキルは汎用的なものにせず、明確な専門家としての役割を定義します。

🛠️ ワークフロー（鍛造プロトコル）

フェーズ 1：スキルの DNA

新しいスキルの3つの柱をユーザーに尋ねます。

1. 技術名： （例：@cyber-sec、@data-visualizer）。
2. 専門家としての役割： （この AI は何者ですか？ 例：「セキュリティ監査の専門家」）。
3. 主な出力： （どのようなファイルや具体的なアクションを実行しますか？）。

フェーズ 2：具体化

以下のファイルのコードを生成します。

• カスタム SKILL.md： 説明、機能、基本ルール、使用方法を含めます。
• PR 用の概要： 目的、変更したファイル、検証内容を説明します。生成された記録を手動で編集しないでください。

フェーズ 3：デプロイと統合

1. リポジトリのルートを特定し、小文字とハイフンを使った ID で skills/<skill-id>/ を作成します。
2. docs/contributors/skill-template.md に従い、フロントマター、使用方法、例、制約を含む SKILL.md を作成します。
3. 現在のベースの指示と package.json を読みます。AAS では、PR を提案する前に npm run chain、npm run validate:references、npm run security:docs、npm run test を実行します。それ以外の対象では、コマンドを捏造せず、現在有効なチェックを使用します。
4. チェックに失敗した場合は、原因を修正して再実行します。バリデーターを弱めたり、未実行の例を検証済みとしたり、未解決の失敗がある状態でマージに進んだりしないでください。チェックがすべて成功したら、ソースの PR を提案します。生成された記録は、正規の同期フローで扱います。

⚠️ 基本ルール

• 数値プレフィックス： 既存の ID は維持します。新しいスキルには、リポジトリに合った小文字とハイフンによる説明的な ID を選びます。他のプロジェクトに Andru.ia の数値プレフィックスを強制しないでください。
• プロンプトエンジニアリング： 観察可能な入出力例と検証基準を含めます。有用な場合は判断理由の簡潔な説明を求めますが、非公開の内部推論を求めたり、最高精度を約束したりしないでください。

例

ユーザーの依頼：

CSV を変更せずに、欠損値と重複値を報告する csv-quality-check スキルを作成してください。

設計例： 入力：許可されたパス、区切り文字、キー列。結果：行数、列ごとの欠損値、重複キーをまとめたレポート。例：id,name / 1,Ana / 1, の行では、キーの重複と名前の欠損が検出されます。CSV は変更されません。区切り文字が曖昧な場合は、問題のないレポートとして扱わず、未解決の入力として記録します。このスキルには、サイズ、プライバシー、エンコーディングの制約を記載し、現在のベースで必要なチェックを含む PR を提示します。

制限事項

• このスキルは、タスクが上記の範囲に明確に合致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代替として扱わないでください。
• テキストを作成しただけでは、例が機能することの証明にはなりません。実行可能な例と、含まれているリソースがあれば、それらを検証してください。
• スキルの作成を理由として、リポジトリのポリシーを暗黙のうちにインストール、公開、変更しないでください。