typespec-specialist
适用于把 TypeSpec 作为单一事实源的 API 团队
协助用 TypeSpec 设计、实现与审查 API 模式，并支持从 OpenAPI/JSON Schema 迁移
以 TypeSpec 专家身份帮你设计、实现与审查 API 模式，能编写或校验 .tsp 文件，并把 OpenAPI/JSON Schema 迁移到 TypeSpec。在需要把接口定义做成单一可信源（schema-first）、搭建 TypeSpec 项目或检查 tsp 配置与可编译性时用它。它会处理转换细节、tsp 编译链和实现建议，给出可执行的实现与审查反馈。
▸ 展开 SKILL.md 英文原文
TypeSpec専門家として、APIスキーマ設計・実装、.tspファイルレビュー・検証、OpenAPI/JSON SchemaからのTypeSpec移行、TypeSpecプロジェクトセットアップを支援するスキル（TypeSpec 1.x 系準拠、最新版に追随）。 以下の状況で積極的にトリガーすること: - 「TypeSpecでAPIを設計して」「.tspを書いて」「APIスキーマを実装して」 - 「.tspファイルをレビューして」「TypeSpec実装を検証して」 - 「OpenAPIをTypeSpecに移行して」「JSON Schemaを.tspに変換して」 - 「TypeSpecプロジェクトをセットアップして」「tspconfig.yamlを整備して」 - 「typespec-specialist スキル」の明示実行 - TypeSpec関連のベストプラクティス・Visibility・Versioningの質問 - 「@typespec/openapi3」「tsp compile」「@service」「@route」などのキーワード - 「スキーマファースト」「型安全なAPIクライアント生成」の文脈 トリガーしないケース: OpenAPIの直接編集のみ / TypeScript typeやZodなど非TypeSpec型システム / Swagger UIなどドキュメントツール設定のみ
帮我安装这个 skill：https://raw.githubusercontent.com/goldeneggg/dotfiles/master/ai-linux/.claude/skills/typespec-specialist/SKILL.mdcurl -fsSL "https://raw.githubusercontent.com/goldeneggg/dotfiles/master/ai-linux/.claude/skills/typespec-specialist/SKILL.md"# TypeSpec specialist TypeSpec を「信頼できる情報源（Single Source of Truth）」として位置付け、堅牢で保守性の高い API スキーマを設計・検証する専門スキル。 ## 責務（Scope） このスキルは以下の 4 つのモードで動作する。冒頭でユーザーの依頼内容からモードを判定し、必要であれば推奨案を含む複数の選択肢を提示してユーザーに確認する。 **モード判定のヒント**: ユーザー発話に以下のキーワードが含まれていれば対応モードを優先候補とする。複数該当・あいまいな場合のみ推奨案を含む複数の選択肢を提示してユーザーに確認する。 | キーワード例 | モード | |---|---| | 新規 / 設計して / 実装して / ゼロから / 一から | Mode 1: 新規実装 | | レビュー / 検証 / チェック / 監査 / 改善点 | Mode 2: レビュー・検証 | | 移行 / 変換 / OpenAPI から / Swagger から / JSON Schema から | Mode 3: 移行 | | セットアップ / 初期化 / プロジェクト立ち上げ / tspconfig / package.json | Mode 4: セットアップ | 1. **新規実装モード**: 要件から `.tsp` ファイル群を新規設計・実装する 2. **レビュー・検証モード**: 既存 `.tsp` 実装を best-practices に照らして検証し、改善提案をレポートする 3. **移行モード**: OpenAP