<< All versions
Skill v1.0.0
Trusted Publisher100/100microsoft/aspnetcore-ja-handbook/writer
──Details
PublishedMay 24, 2026 at 08:12 PM
Content Hashsha256:c1c9e6b1f679f7c1...
Git SHA
──Files
Files (1 file, 5.7 KB)
SKILL.md5.7 KBactive
SKILL.md · 116 lines · 5.7 KB
version: "1.0.0" name: writer description: 'ASP.NET Core ハンドブックの新規章コンテンツを作成する。Use when: 新しい章を書く、ドキュメントを作成する、チャプターを追加する、コンテンツを執筆する。技術ドキュメントのライティング、ASP.NET Core ガイドの執筆。' argument-hint: '作成する章のタイトルとセクション一覧を指定'
ASP.NET Core ハンドブック ライタースキル
概要
このスキルは、docs/ フォルダ内に新しい章のマークダウンドキュメントを作成するためのワークフローです。 対象読者は C# 以外の言語経験者 であり、日本語で記述します。
前提条件
- 言語: 日本語
- 対象読者: 他言語の経験者（対象言語・フレームワーク一覧は
.github/skills/languages.mdを参照） - 対象バージョン:
.github/instructions/versioning.instructions.mdのバージョン決定ルールに従い、作成時点の最新バージョンを使用する
手順
1. 情報収集
以下の情報源を 必ず 確認し、最新かつ正確な内容のみを記載する。
- MS Learn 公式ドキュメント — ASP.NET Core や .NET 固有の概念だけでなく、一般的な IT 知識についても MS Learn を根拠とする
- URL パターン:
https://learn.microsoft.com/en-us/aspnet/core/...?view=aspnetcore-N.0（N はバージョン決定ルールで決定した番号） - マークダウン取得: URL に
&accept=text/markdownを付与してcurlで取得するとノイズが少ない - ロケール運用: 情報収集時は `en-us` の URL を使用し、章末の参考リンクとして記載する際は `ja-jp` の URL を使用する
- 他言語フレームワークの公式ドキュメント — 比較情報を記載する際は、各フレームワークの最新ドキュメントを検索して正確性を確認する
2. 既存ドキュメントの形式確認
docs/ フォルダ内の既存ファイル（例: 01-setup-dev-env.md, 02-solutions-and-projects.md）を読み、以下の形式要素を踏襲する。
ドキュメント構造
markdown
# 第N章：タイトル---## 目次1.[セクション1](#anchor)-[サブセクション](#anchor)2.[セクション2](#anchor)...---## 1. セクション1### サブセクション...## N. 参考ドキュメント-[タイトル | Microsoft Learn](URL)---*前の章: [第N-1章：タイトル](./NN-filename.md)**次の章: [第N+1章：タイトル](./NN-filename.md)*
形式ルール
| 要素 | ルール | |
|---|---|---|
| 見出し | # = 章タイトル、## = 大セクション（番号付き）、### = サブセクション、#### = 小見出し | |
| 目次 | ドキュメント冒頭に ## 目次 として内部アンカーリンク一覧を配置 | |
| コードブロック | 言語指定必須（csharp, xml, json, bash, text など） | |
| 図表 | Mermaid 記法で概念図・フローチャートを積極的に使用 | |
| 注記 | > [!TIP], > [!NOTE], > [!WARNING] を適切に使い分け | |
| テーブル | 比較情報や一覧はテーブルで整理 | |
| 他言語比較 | > [!TIP] または > [!NOTE] ブロック内に記載 | |
| 折りたたみ | IDE 別の手順は <details><summary> で折りたたむ | |
| 参考リンク | 最終セクションに MS Learn 等の公式ドキュメントリンクを一覧化 | |
| 前後リンク | ドキュメント末尾に前後の章へのリンクを配置 |
3. コンテンツ作成の原則
- 初心者にわかりやすく — 概念の説明は具体例とコードサンプルを交えて記述する
- 実装サンプルを豊富に — 可能な限り動作するコード例を記載し、コピー＆ペーストで試せるようにする
- 最新バージョン準拠 — バージョン決定ルールで決定した .NET N / ASP.NET Core N に準拠し、古い API（Startup.cs 方式など）ではなく最新の Program.cs 方式で記載する
- 最新 C# 機能の活用 — 対象バージョンに対応する最新の C# 言語機能を使用する
- MS Learn を根拠にする — 独自の解釈や推測ではなく、公式ドキュメントの記載を根拠とする
- 他言語比較を含める — ASP.NET Core 特有の機能について、
.github/skills/languages.mdに記載の言語・フレームワークに対応する機能がある場合は NOTE として比較を記載する
4. 日本語表記ルール
- カタカナ語の長音符号:
.github/instructions/katakana.instructions.mdの辞書に従う - 句読点: 「、」「。」を使用
- 専門用語: 初出時に英語を括弧で併記（例: 依存性注入 (Dependency Injection: DI)）
5. 品質チェック
コンテンツ作成後に以下を確認する。
- [ ] 目次のアンカーリンクが見出しと一致している
- [ ] コードブロックの言語指定が正しい
- [ ] Mermaid 図が正しい構文で記述されている
- [ ] MS Learn の URL が
?view=aspnetcore-N.0（N は決定したバージョン番号）を含んでいる（ASP.NET Core 関連の場合） - [ ] MS Learn の URL ロケール運用（情報収集は
en-us、参考リンク掲載はja-jp）が守られている - [ ] テーブルの列数が揃っている
- [ ] 前後の章へのリンクが正しい
- [ ]
> [!TIP]/> [!NOTE]/> [!WARNING]の使い分けが適切
出力先
- ファイルパス:
docs/NN-<slug>.md（NN は章番号の 2 桁ゼロ埋め） - ファイル名のスラッグ: 英語のケバブケース（例:
06-dependency-injection.md）