引数で指定した記事のレビューを行います。記事スラッグを引数に渡すと、textlint による自動校正と誤字脱字・文法的な誤りの指摘を行います。/article-review [スラッグ] の形式で呼び出してください。記事を書いた後のチェック、公開前の校正、文章の品質確認にも使用してください。
translate
記事を英語に翻訳する。記事スラッグを引数に渡すと、日本語の記事を英語に翻訳して contents/blogPost/en/ に出力する。/translate [スラッグ] の形式で呼び出す。
含まれるファイル(1)
- SKILL.md2.4 KB
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
blogPost/$ARGUMENTS.md の日本語記事を英語に翻訳し、blogPost/en/$ARGUMENTS.md に出力する。
手順
blogPost/$ARGUMENTS.mdを読むblogPost/en/ディレクトリがなければ作成する- 下記の翻訳ルールに従い、記事全体を英語に翻訳する
blogPost/en/$ARGUMENTS.mdに翻訳結果を書き出す- 翻訳結果のサマリーを出力する
翻訳ルール
frontmatter
title: 英語に翻訳するslug: 変更しない(日本語版と全く同じ値を維持。Contentful で同じエントリを参照するために必須)id: 変更しない(日本語版と全く同じ値を維持。Contentful でエントリを特定するために必須)about: 英語に翻訳する。250 文字以内に収める(超える場合は内容を損なわないよう要約する)tags: 英語の一般的なタグに翻訳する(例: "型安全" → "type-safety")selfAssessment: クイズのquestion,text,explanationを英語に翻訳するpublished: 変更しない(日本語版と同じ値を維持)- その他のフィールド(
createdAt,updatedAt,thumbnail,audio): そのまま維持
本文
- 技術用語(API名、ライブラリ名、コマンド名、コード内の識別子)はそのまま維持する
- コードブロックの中身は翻訳しない。ただしコメントが日本語の場合は英語に翻訳する
- マークダウンの構造(見出しレベル、リスト、リンク、画像)はそのまま維持する
- 日本語特有の表現は自然な英語に意訳する。逐語訳は避ける
- 技術ブログとしてのトーンを維持する。カジュアルすぎず、堅すぎない文体にする
- 原文の段落構成・セクション構成は維持する
品質基準
- ネイティブの英語話者が違和感なく読める自然な英語にする
- 技術的な正確性を最優先する。不明な技術用語は原文のまま残す
- 原文の意図・ニュアンスを正確に伝える
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
ローカルで検証済みのブラウザ向け HTML、CSS、JavaScript を CodePen Prefill launcher に変換し、承認後に未保存の Pen を開く。フロントエンドのデモを CodePen で共有して、記事へ埋め込む準備をして、と依頼されたときに使用する。Node.js、サーバー、CLI、ビルド、複数プロセスが必要な例には使用しない。
技術記事の内容から読者の理解度をチェックする4択クイズを指定のYAML形式で生成するスキル。ユーザーが「この記事のクイズを作って」「理解度チェックを作成して」「記事を読んだ人向けの問題を作って」「selfAssessment形式でクイズを作って」と依頼したときに必ず使う。ブログ記事、技術ドキュメント、チュートリアル、解説記事、技術書の章など、読者の学習内容を確認する問題を作る必要があるあらゆる場面で使う。記事のURL・マークダウン・テキスト・ファイルパスのいずれを渡されても動作する。
技術ブログ記事、チュートリアル、技術原稿を、技術的正確性、一次情報、現在の API 挙動、コード、再現性、セキュリティ、アクセシビリティ、互換性の観点からレビューする。技術的な主張、コードサンプル、対応バージョン、仕様、公開前の正確性を確認してほしいと依頼されたときに使用する。一般的な文章校正は article-review に任せ、明示的な依頼なしに原稿を変更しない。
ユーザーが新しい技術を学ぶことを第一目的として、このリポジトリの文体と構成に従い、調査、構成合意、サンプル実装・検証、執筆、レビュー、理解度クイズまでを行って技術ブログ記事の下書きを作成する。ユーザーがブログ記事を書いて、新しい API や機能を紹介して、ハンズオンを作って、技術調査を記事化して、経験や意見を記事にして、と依頼したときに使用する。新しい API・Web 標準の記事では、一次情報と仕様策定の議論を調べ、実行可能なサンプルを作成して実環境で検証する。