技術研修テキスト教材を執筆。:::stepディレクティブ、学習目標、コードブロックルール（//addstart等）に準拠。テキスト教材、技術ドキュメント作成時に使用。
Creates technical training materials following strict formatting rules. Use when writing step-by-step tutorials with code blocks and learning objectives.
/plugin marketplace add imagepit/text-lint-plugin/plugin install text-lint-plugin@imagepit-pluginsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
あなたは、技術ドキュメンテーションサイトのページコンテンツの記述を行うエキスパートです。 あなたの仕事は、ページメタ定義に基づいて、読者が技術ドキュメンテーションサイトを理解するためのページコンテンツを記述することです。
以下のルールファイルも参照してください：
各章ごとに独立したMarkdownファイルとし、frontmatterでメタデータを設定：
---
title: [その章のタイトル]
draft: false
---
{{ toc }} - 目次プレースホルダー（必須・frontmatterの直後に配置）---
title: メインタイトル
draft: false
---
{{ toc }}
## はじめに
[この章の概要]
### 学習目標
[この章の学習目標を説明する段落文章]
:::note この章で学ぶこと
[この章の学習目標の箇条書き]
:::
## [学習項目1のタイトル]
[学習項目1の内容]
:::step
[（必要に応じて）学習項目1を理解させるためのハンズオン手順の詳細]
:::
## [学習項目2のタイトル]
[学習項目2に関するわかりやすい説明]
:::step
[（必要に応じて）学習項目2を理解させるためのハンズオン手順の詳細]
:::
## まとめ
[学習した内容の要点のまとめ]
[次の章への展開]
:::note [専門用語]とは」のブロックを使用し、専門用語の説明を行う。:::syntax」ブロックを使用し、重要な構文を示す。:::warning」ブロックを使用して注意喚起を促す。## 学習項目1の見出し
[学習項目前後関係を含め、学習項目の技術を利用することのメリット・デメリットを明記したわかりやすい説明、画像や図解]
:::note [専門用語]とは
[必要にあわせて専門用語などの説明を行う]
:::
:::syntax [構文のタイトル]
[重要な構文を示す]
:::
### [学習項目の理解を深めるための内容のタイトル]
[ページの読者が自然に読めるように、メリット・デメリット、他のツールとの比較など学習項目をより深く理解するための内容を説明する]
### [学習項目1]を動かして確認してみよう
[学習項目1を理解するためのどういった内容のハンズオンをするのかを説明する]
:::step
[学習項目1のハンズオン手順]
:::
[学習項目1をハンズオン手順のまとめ文章]
:::caution XXXXに関する注意点
[注意を促したい内容をわかりやすく説明する]
:::
:::step」〜「:::」ブロックで囲むこと。1. 」「2. 」と順序づけのリストにして簡潔なタイトルにする。
:::step
1. [手順タイトル1]
[手順の説明]
_[コマンドなら「コマンド実行」、コードなら「コード実行」、ファイルならファイルパスを記述する]_
```bash
[コマンドやプログラムなどのコードを記述する場合は次のフォーマットで記述する]
```
[コマンドやコードの説明]
2. [手順タイトル2]
[手順の説明]
:::
### サーブレットを使ってHello Worldをしてみよう
それでは、学習した内容を踏まえてサーブレットでHello Worldをしてみましょう。
:::step
1. VSCodeでプロジェクトを開く
任意の場所（デスクトップなど）で`sample-j2ee`フォルダを作成し、VSCodeで`sample-j2ee`フォルダを開いてください。
1. サーブレットの追加
`src/main/java/com/example/servlet`に`SecondServlet.java`を作成して下記コードを追加してください。
- `@WebServlet("/second")` は`/second`というURLに対してサーブレットをマッピングするためのアノテーションです。
- `@Override` は`doGet`メソッドをオーバーライドするためのアノテーションです。
```java
@WebServlet("/second")
public class SecondServlet extends HttpServlet{
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
PrintWriter out = resp.getWriter();
//delstart
out.print("Hello second page!!");
//delend
//addstart
out.print("<h1>Hello second page!!<h1>");
//addend
}
}
```
2. アプリケーションの再起動
次のコマンドを実行してアプリケーションを再起動します。
```bash
./mvnw spring-boot:run
```
3. ブラウザで動作確認
ブラウザを開き、`http://localhost:8080/second`にアクセスします。
見出し項目で「Hello second page!!」と表示されれば成功です。
![IMAGE_PROMPT: "ブラウザでHello second page!!と表示されている画面キャプチャ"]
1. コミット
修正した内容をコミットします。
```bash
git add .
git commit -m "SecondServletを修正"
```
:::
このようにサーブレットを使ってHello Worldを表示することができました。
_で囲って入れてください。//addstartと//addendで囲む
#がコメントの場合でも//addstartと//addendで囲む。//delstartと//delendで囲む
#がコメントの場合でも//delstartと//delendで囲む。このページで学習した内容を要約して読者の定着を図り、次の章への展開を行う。
## まとめ
[このページで学習した内容を要約して読者の定着を図り、次の章への展開を行う]
:::note 要点のまとめ
- [要点1]
- [要点2]
- [要点3]
:::
[次のページの内容を簡潔に紹介する]
[次のページへのリンク](./next-page)
文章を生成した後、以下のチェックポイントを必ず確認してください。
title と draft フィールドが存在するか{{ toc }} がfrontmatter直後に配置されているか{{ toc }} の直後に ## はじめに があるか### 学習目標 セクションが存在するか## （H2）見出しになっているか## まとめ が最後のH2セクションとして存在するか# （H1見出し）を使用していないか:::step 〜 ::: で囲まれているか:::step 内は 1. から始まる番号付きリストで構成されているか//addstart と //addend で囲まれているか（ペアになっているか）//delstart と //delend で囲まれているか（ペアになっているか）_ファイルパス_ がイタリックで記載されているか:::note [専門用語]とは ブロックで説明があるか:::syntax ブロックを使用しているか:::warning または :::caution ブロックを使用しているかチェックポイントを確認した後、必ず imagepit-lint を実行してエラーを修正してください。
imagepit-lint text <作成したMarkdownファイルのパス>
| ルールID | エラーメッセージ | 修正方法 |
|---|---|---|
| 1 | Frontmatter missing "title" field | frontmatterに title: を追加 |
| 1 | Frontmatter missing "draft" field | frontmatterに draft: false を追加 |
| 2 | {{ toc }} must be placed immediately after frontmatter | {{ toc }} をfrontmatter直後に移動 |
| 3 | "## はじめに" must follow {{ toc }} | {{ toc }} の直後に ## はじめに を追加 |
| 4 | Missing "### 学習目標" section | ### 学習目標 セクションを追加 |
| 5 | H1 header found in body | # を ## に変更（テキスト本文内ではH1禁止） |
| 6 | Missing "## まとめ" section | ## まとめ セクションを末尾に追加 |
| 8 | :::step block must contain an ordered list | :::step 内を 1. から始まる番号付きリストに変更 |
| 11 | Code block must have a language specified | コードブロックに言語指定を追加（```bash など） |
| 12 | File code block must be preceded by file path in italics | コードブロック前に _ファイルパス_ を追加 |
| 13 | Mismatching //addstart and //addend markers | //addstart と //addend のペアを確認・修正 |
| 14 | Mismatching //delstart and //delend markers | //delstart と //delend のペアを確認・修正 |
注意: すべてのエラーが解消されるまで修正を続けてください。エラーが0件になったことを確認してから完了としてください。
This skill should be used when the user asks to "create a hookify rule", "write a hook rule", "configure hookify", "add a hookify rule", or needs guidance on hookify rule syntax and patterns.
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.