HypervelocityEngineering

全 Custom Agent が作業開始時に参照する共通プリアンブル。 USE FOR: agent start, common rules, preamble. DO NOT USE FOR: implementation. WHEN: Custom Agent が作業を開始したとき、共通ルールを確認したいとき。

GitHub Actions CI/CD ワークフローの共通仕様。OIDC 認証・workflow_dispatch トリガー・ Copilot push 制約対応・シークレット管理・デプロイ保護の原則を提供する。 USE FOR: GitHub Actions, CI/CD workflow, OIDC authentication. DO NOT USE FOR: application code deployment (use appropriate azure-skills/ deployment skill). WHEN: GitHub Actions ワークフローを作成する、CI/CD パイプラインを設計する。

破壊的操作を事前に検出・阫止する安全ガードの詳細パターンリストと判定フロー。 PHASE: 実行前（コマンド・スクリプト実行前に使用）。 USE FOR: destructive operation detection, rm -rf detection, DROP TABLE detection. DO NOT USE FOR: error recovery after failure (use harness-error-recovery), post-execution verification (use harness-verification-loop). WHEN: コマンドを実行する前の安全確認、破壊的操作の検出。

コード変更後の5段階検証パイプライン（Build/Lint/Test/Security/Diff）の詳細手順。 PHASE: 実行後（コード変更・生成・デプロイを行った**後**に使用）。 USE FOR: build check, lint, test execution. DO NOT USE FOR: error recovery (use harness-error-recovery), pre-execution safety check (use harness-safety-guard). WHEN: コードを変更した後の検証、ビルド確認。

knowledge/ 配下のファイル管理ルールを提供する。業務要件・判定表・連携契約等の ドメイン知識ドキュメントの分類・命名・更新手順を定義する。 USE FOR: knowledge/ file management, D01-D21 classification, domain knowledge organization. DO NOT USE FOR: qa/ file creation (use work-artifacts-layout). WHEN: knowledge/ 配下にファイルを作成・更新する、ドメイン知識を整理する。

初見のリポジトリで最小限の読解により入口・境界・標準コマンドを確定し、 onboarding.md に固定するスキル。"全部読む"を避け、作業に必要な最小限だけ確定する。 USE FOR: repository onboarding, first assignment, entry point discovery. DO NOT USE FOR: full code analysis. WHEN: リポジトリに初めてアサインされた、入口が不明。

work/ 配下の作業ディレクトリ構造を、後続タスクが確実に参照できるよう整備するスキル。 USE FOR: work/ structure, artifacts path, qa/ structure. DO NOT USE FOR: docs/ format (use docs-output-format). WHEN: work/ 配下にファイルを作成したい、作業ディレクトリを整備したい。

APP-ID に基づくスコープ解決ルール。Issue body または <!-- app-id: XXX --> HTML コメントから APP-ID を取得し、docs/catalog/app-catalog.md との紐付けで 対象サービス・画面・エンティティを特定する。 USE FOR: APP-ID scope resolution, service identification, app-catalog lookup. DO NOT USE FOR: service implementation. WHEN: APP-ID のスコープ解決、Issue body 解析。

アーキテクチャ候補選定時の質問票テンプレートと適合度表・判定ロジックを提供する。 USE FOR: architecture selection, non-functional requirements, Q1-Q26 questionnaire. DO NOT USE FOR: implementation. WHEN: アーキテクチャ候補を分析する、非機能要件を収集する。

データフロー処理の設計ガイドを統合的に提供する。要件定義・ジョブ定義・データフロー・ 非機能要件・ワークフロー仕様・テスト仕様・テスト戦略を references/ に集約し、 SKILL.md 本文から索引を提供する。 USE FOR: batch design, job definition, data flow design. DO NOT USE FOR: batch implementation. WHEN: データフロー処理を設計する、データフローアプリを定義する。

成果物の敵対的レビューを実行するスキル。5つの検証軸で問題を発見し、 Critical/Major/Minor の重大度分類と PASS/FAIL 判定を行う。 PHASE: 成果物作成後（PR/マージ前または検証ループ完了後のユーザー指定時に使用）。 USE FOR: quality review, 5-axis review, adversarial check. DO NOT USE FOR: implementation (agents do that), pre-execution safety check (use harness-safety-guard), build/test verification (use harness-verification-loop), error recovery (use harness-error-recovery). WHEN: 成果物のレビューが必要、PR/マージ前の品質チェック。

エラー発生時の統一リカバリ契約。エラー分類（Build失敗・Test失敗・書き込み失敗・ API制限・権限不足）ごとのリカバリフロー、3要素出力（root_cause_hint / safe_retry_instruction / stop_condition）テンプレートを提供する。 PHASE: エラー発生時（実行中または検証中にエラーを検知したとき）。 USE FOR: error recovery, build failure recovery, test failure recovery. DO NOT USE FOR: verification pipeline execution (use harness-verification-loop), pre-execution safety check (use harness-safety-guard). WHEN: エラーが発生した、ビルドが失敗した。

Custom Agent の入力ファイル（必読ファイル・推奨ファイル）の存在確認と欠損時の デフォルト処理ルールを提供する。Agent が作業開始時に必読ファイル表を検証し、 欠損ファイルに対して TBD 記載で続行する。 USE FOR: input file check, missing file handling, required file validation. DO NOT USE FOR: implementation. WHEN: Agent 作業開始時の入力確認、ファイル欠損時の処理判断。

Behavioral guidelines to reduce common LLM coding mistakes. USE FOR: karpathy guidelines. DO NOT USE FOR: unrelated tasks. WHEN: Behavioral guidelines to reduce common LLM coding mistakesが必要なとき。

knowledge/ 配下の確定済みドメイン知識ドキュメント（D01〜D21）を参照する。 USE FOR: checking business rules, verifying glossary definitions, reviewing data model specifications. DO NOT USE FOR: creating or updating knowledge/ files (use knowledge-management skill). WHEN: during task execution、business requirements。

MCP Server の設計指針を提供する。Skills と MCP Server の関係性、 MCP Server の責務分離、API 設計パターンを定義する。 USE FOR: MCP Server design, skills and MCP relationship, MCP API design pattern. DO NOT USE FOR: MCP Server implementation. WHEN: MCP Server を設計する、Skills と MCP Server の関係を整理する。

マイクロサービスの設計ガイドを提供する。サービス定義・API 設計・ 境界コンテキストとの対応・デプロイ単位の決定手順を定義する。 USE FOR: microservice design, service definition, API design. DO NOT USE FOR: microservice implementation. WHEN: マイクロサービスを設計する、サービス定義書を作成する。

Guidance for instrumenting webapps with Azure Application Insights. USE FOR: how to instrument app, App Insights SDK, telemetry patterns. DO NOT USE FOR: unrelated tasks. WHEN: how to instrument app、App Insights SDK。

docs/ 成果物フォーマットの共通原則。固定章立て（見出し固定順序・不足は TBD・ 各表の各行に出典必須）と Mermaid erDiagram 記法指針を提供する。 USE FOR: docs/ format, fixed heading order, citation required per row. DO NOT USE FOR: work/ format (use work-artifacts-layout). WHEN: docs/ 配下の成果物を作成する、固定章立てを確認する。

巨大出力の分割ルール。50,000文字超は分割必須、20,000文字以下が推奨上限。 USE FOR: large output splitting, 50000 char threshold, chunking. DO NOT USE FOR: split axis design decision (agents decide). WHEN: 大量の出力を生成する、50。

図やダイアグラムをSVGコードとして生成し、画面にレンダリング表示するスキル。 USE FOR: SVG render, SVG draw, SVG diagram creation. DO NOT USE FOR: Mermaid diagrams. WHEN: SVGでレンダリングして、SVGで図を描いて。

Skills 参照先のルーティング表。USE FOR: どのフェーズでどの Skill を参照するか判断するとき。 DO NOT USE FOR: 実装手順や詳細仕様の代替。 WHEN: C[...]

タスクの依存関係（DAG）で分解し、タスク粒度とコンテキストサイズで分割判断を行うスキル。 USE FOR: create plan, estimate task, split issue. DO NOT USE FOR: implementation execution (agents do that separately). WHEN: 計画を立てたい、見積をしたい。

タスクの不明点を洗い出し、重要度分類・既定値候補付きの優先順位付き質問票を作成するスキル。 USE FOR: context gathering, questions, requirements clarification. DO NOT USE FOR: implementation. WHEN: 不明点を確認したい、要件を整理したい。

テスト戦略の共通テンプレート。テストピラミッド定義・テストダブル選択基準・ テストデータ戦略・カバレッジ方針を提供する。 USE FOR: test strategy, test pyramid, test doubles selection. DO NOT USE FOR: test code generation (agents do that). WHEN: テスト戦略書を作成する、テストダブルの選択基準を参照する。