菜单
Markdown ドキュメント（spec/tech/test/manual/proposal/plan/review/report）を出力・編集する際の構文・フロントマター・整形規約。/Shared/anytime-markdown-docs/ 配下に .md を作成/更新する時、見出し・テーブル・コードブロック・脚注・アドモニション・図表・フロントマター(type/c4Scope 等)を書く時、Markdown 出力仕様を確認する時に使用する。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
/Shared/anytime-markdown-docs 配下のドキュメントを新規作成・執筆する時に、type（spec/tech/test/manual/proposal/plan/review/report）ごとの記載内容（何を書くか）・フォルダ構成・索引 index.[lang].md の自動生成運用を定義する。設計書（spec）の書き方・component spec の 2 ファイル分離・E2E シナリオ表・技術解説記事（tech。「技術記事を書いて」「ブログ記事を作成」「解説記事を書いて」等）の構成テンプレート・執筆ガイドライン・文体・生成ワークフロー・試験設計書（「試験設計書」「テスト設計書」「テストケースを設計」「テスト観点で洗い出し」「テスト計画」「QA 設計」等。7 ペルソナ観点・技法・自動化判定）・プランファイルの「変更対象ファイル」節・索引再生成が必要な時に使用する。構文・フロントマター・整形は anytime-markdown-output、既存設計書の読み方・辿り方は anytime-spec-lookup を使う。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
コードレビュー結果を出力する際の Markdown 書式（memory-core ingest パーサ対応）。### N. タイトル＋重大度/カテゴリ/対象の3メタデータ＋行頭の問題:/提案: マーカーで指摘を構造化する。レビュードキュメント・code-reviewer subagent 出力・requesting-code-review/security-review の指摘を書く時に使用する。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
anytime-markdown の設計書（/Shared/anytime-markdown-docs/spec）を低トークンで辿るためのナビゲーション手順。索引(index.ja.md) → 対象 frontmatter → 型付き related を必要な深さだけ辿る progressive disclosure。設計書の調査・参照・関連ドキュメント探索・「どの spec を読むべきか」を判断する時に使用する。
anytime-markdown の Markdown ドキュメントを検索・調査・編集・整形する時、特にトークン（cache_read 加重）を抑えたい時に使用する。mcp-markdown の search_docs/search_sections/grep_markdown/get_outline/get_section/update_section/get_frontmatter/update_frontmatter/format_markdown/compute_diff を使う時、検索・調査をサブエージェントへ委譲する時の運用手順と委任プロンプト雛形。
| name | anytime-markdown-output |
| effort | low |
| description | Markdown ドキュメント（spec/tech/test/manual/proposal/plan/review/report）を出力・編集する際の構文・フロントマター・整形規約。/Shared/anytime-markdown-docs/ 配下に .md を作成/更新する時、見出し・テーブル・コードブロック・脚注・アドモニション・図表・フロントマター(type/c4Scope 等)を書く時、Markdown 出力仕様を確認する時に使用する。 |
更新日: 2026-07-11
type 別の記載内容（何を書くか）・索引
index.[lang].md運用はanytime-doc-authoringスキル、既存設計書の読み方はanytime-spec-lookupスキルを参照。本スキルは構文・フロントマター・整形（どう書くか）を扱う。
[topic]/ フォルダを作成し、その中に [topic].[lang].md（日英両方）を出力する。画像は [topic]/images/ に配置する。[YYYYMMDD]-[topic].[lang].md — 指示がなければ日本語のみ出力する。index.[lang].md（各フォルダ必須・OKF 段階開示）: 索引の構成・自動生成（scripts/gen-spec-index.mjs・手書き禁止）・再生成必須の運用は anytime-doc-authoring スキル §1.2 に集約した。ドキュメントを追加・更新・改名・削除したら同スキルに従い索引を再生成する。lang は ja（日本語）/ en（英語）。/Shared/anytime-markdown-docs/ 配下に出力するすべての Markdown ファイルには、フロントマターを必ず付与する。
---
title: "ドキュメントタイトル"
date: "YYYY-MM-DD"
type: "spec"
lang: "ja"
author: "Claude Code v[CLIバージョン]"
category: "カテゴリ名"
excerpt: "ドキュメントの要約。200文字以内。"
---
| フィールド | 必須 | 最大長 | 説明 |
|---|---|---|---|
title | Yes | 200 | ドキュメントタイトル |
author | No | 100 | 著者名。AI 生成の場合は Claude Code v[バージョン] を記載 |
lang | Yes | 5 | 言語コード。ja（日本語）または en（英語） |
type | Yes | - | ドキュメント種別。下記の種別一覧から選択 |
category | No | 100 | サブカテゴリ。/report ページでは一覧にチップ表示される |
excerpt | No | 500 | ドキュメントの要約。/report ページでは一覧・OG description に使用 |
thumbnail | No | 500 | サムネイル画像 URL（現在 UI 未使用） |
| skill | No | 100 | 利用スキル |
c4Scope | No | - | C4モデル要素IDの配列。type: "spec" の場合に付与する。詳細は 2.3 を参照 |
date | Yes | 30 | 作成日または公開日（YYYY-MM-DD 形式） |
updated | No | 30 | 更新日（YYYY-MM-DD 形式）。既存ファイルの内容を変更した場合に追加・更新する |
schemaVersion | No | 10 | フロントマター仕様の版。破壊的変更時に上げ、後方互換で進化させる（OKF のバージョン管理原則）。未指定時は最新仕様とみなす |
[!IMPORTANT] \\\`author\\\` が AI の場合、\\\`Claude Code v2.1.85\\\` のように CLI バージョンを含めること。\\\\ バージョンは \\\`claude --version\\\` で取得する。
フロントマターは複数の機械的消費者が依存する「契約」である。以下のフィールドは表示・機能に直結するため、消費者を壊さないよう値の整合性を保つ。それ以外のフィールド・本文セクション構成はプロデューサー（書き手）の裁量である。
| フィールド | 消費者 | 用途 |
|---|---|---|
title / type / category / excerpt / date | web-app /report ページ | 一覧表示・カテゴリチップ・OG description・並び替え |
c4Scope | C4 モデルビューア | 要素選択時の関連ドキュメント自動表示（2.3） |
related | note-graph ビューア | ドキュメント間リンクのグラフ描画 |
[!NOTE] 機械契約フィールド（上表）を変更・廃止する場合は、消費者側の改修とセットで行う。仕様を破壊的に変更する際は
schemaVersionを上げる。
type）type | 出力先フォルダ | 説明 |
|---|---|---|
spec | /spec/ | 設計書。機能仕様・アーキテクチャ設計・データモデル定義等 |
tech | /tech/ | 技術調査・技術記事。ライブラリ比較・技術検証・解説記事等 |
test | /test/ | テスト項目書。ユニットテスト・E2E テストのケース一覧 |
manual | /manual/ | マニュアル・手順書。ユーザー向け操作ガイド・セットアップ手順等 |
proposal | /proposal/ | 提案。改善提案・新機能提案・技術選定の提案等 |
plan | /Shared/anytime-markdown-docs/plan/ | 実装計画。タスク分解・スケジュール・依存関係の定義 |
review | /review/ | レビュー。コードレビュー結果・設計レビュー記録 |
report | /report/ | レポート。日次調査・週次調査・Issue 解決レポート等。Web アプリの /report ページに一覧表示される |
c4Scope（type: "spec" 専用）type が spec のドキュメントには c4Scope フィールドを付与する。
C4モデルの要素選択時に関連ドキュメントを自動表示するために使用する。
sys_・pkg_ プレフィックス付き）の YAML 配列packages/web-app/src/app/api/c4/model/route.ts が返す model.elements）から取得する---
title: "graph-core 設計書"
type: "spec"
c4Scope:
- "pkg_graph-core"
- "pkg_graph-core/engine"
---
| レベル | ID 例 | 用途 |
|---|---|---|
| システム | sys_anytime-markdown | システム全体の設計書 |
| コンテナ | pkg_web-app | パッケージ単位の設計書 |
| コンポーネント | pkg_graph-core/engine | パッケージ内モジュールの設計書 |
[!NOTE] 要素を選択すると、完全一致に加え子パス前方一致（`pkg_graph-core` 選択時に `pkg_graph-core/engine` も表示）でドキュメントが検索される。
本仕様は GFM (GitHub Flavored Markdown) Spec をベースに、Claude Code が Markdown ファイルを出力する際に使用する構文を定義したものである。GFM は CommonMark の厳密なスーパーセットであり、本仕様はその中から必要な構文のみを抽出・限定している。
# 見出し1
## 見出し2
### 見出し3
# を1～3個使用# の直後に空白、行末は改行が必須---
- で記述するコードフェンスとは、3個以上の連続するバッククォート文字（
`）の並びである。
``| ヘッダ1 | ヘッダ2 | ヘッダ3 |
| --- | --- | --- |
| データ1 | データ2 | データ3 |
ヘッダ行 + セパレータ行 + 0個以上のデータ行で構成。
セパレータ行は、ハイフン（
-）のみで構成されるセルからなり、オプションで先頭・末尾にコロン（:）を付与して左寄せ・右寄せ・中央寄せを指定できる。
| 構文 | 配置 |
|---|---|
--- | デフォルト（左） |
:--- | 左寄せ |
---: | 右寄せ |
:---: | 中央寄せ |
\| でエスケープ<br> を使用する（\ は使用不可）Example 200: セル内のパイプエスケープ
| f\|oo |
| ------ |
| b `\|` az |
| b **\|** im |
バッククォート文字列とは、1個以上の連続するバッククォート文字（
`）で、前後にバッククォートがないものである。コードスパンはバッククォート文字列で始まり、同じ長さのバッククォート文字列で終わる。
基本的なコードスパン:
`code` → code
バックスラッシュはリテラル扱い:
`foo\bar` → foo\bar（エスケープされない）
改行はスペースに変換:
`foo
bar` → foo bar
結果の文字列が先頭と末尾の両方がスペースで、かつスペースのみで構成されていない場合、先頭と末尾から各1文字のスペースを除去する。
`` `foo` `` → `foo`（前後スペース除去で ` が内容に含まれる）
`` ` `` → `（前後スペース除去）
` `` ` → ``（前後各1スペース除去、内側スペースは残る）
` ` → ` `（スペースのみなので除去しない）
内容に含まれるバッククォートの連続と衝突しない最小数を選ぶ。
| 内容 | 必要なデリミタ数 | 記法 |
|---|---|---|
| バッククォートなし | 1個 | `code` |
単独の ` あり | 2個 | `` foo`bar `` |
`` `` あり、単独 `` ` なし | 1個 | ` foo``bar ` |
`code` ← バッククォートなし → 1個で囲む
`` foo`bar `` ← 内容に1個の ` → 2個で囲む
` foo``bar ` ← 内容に2個の `` だが1個の ` なし → 1個で囲む
箇条書き: -
順序付き: 1.（最大9桁）
密なリスト（項目間に空行なし）:
- 項目1
- 項目2
- 項目3
緩いリスト（項目間に空行あり、各項目が <p> で囲まれる）:
- 項目1
- 項目2
- 項目3
順序付きリスト:
1. 項目1
2. 項目2
3. 項目3
ネストしたリスト（4スペースインデント）:
- 項目1
- サブ項目1
- サブ項目2
- 項目2
- [ ] 未完了タスク
- [x] 完了タスク
[ ]（未完了）または [x]（完了）を付与[ と ] の間はスペースまたは x のみネストしたタスクリスト:
- [ ] 親タスク
- [x] サブタスク1
- [ ] サブタスク2
> 引用テキスト
> 続きの行
> で開始> 外側の引用
> > ネストした引用
> を省略可能（遅延継続）> 引用の開始
続きの行（> を省略）
引用ブロック内で [!TYPE] を記述することで、注記・警告などのアドモニション（コールアウト）を表現する。
> [!NOTE]
> 補足情報を記載する。
>
> [!TIP]
> 効率的な操作方法を紹介する。
>
> [!IMPORTANT]
> 見落とすと問題になる重要な情報を強調する。
>
> [!WARNING]
> 注意が必要な操作や既知の制限事項を警告する。
>
> [!CAUTION]
> データ損失や不可逆な操作について注意喚起する。
対応タイプ:
| タイプ | 用途 |
|---|---|
NOTE | 補足情報・参考ヒント |
TIP | 効率的な操作方法・ショートカット |
IMPORTANT | 見落とすと問題になる重要情報 |
WARNING | 注意が必要な操作・既知の制限 |
CAUTION | データ損失・不可逆操作の注意喚起 |
[!TYPE] は引用ブロックの最初の行に記述する[!TYPE] の行の後に本文を続ける*強調*
**太字**
***太字強調***
~~取り消し~~
~~ で囲む[テキスト](URL "タイトル")
すべての ASCII 句読文字はバックスラッシュでエスケープできる。
! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~
| コンテキスト | エスケープ |
|---|---|
| 通常テキスト | 有効 |
| コードスパン内 | 無効（リテラル扱い） |
| コードブロック内 | 無効（リテラル扱い） |
エンティティ参照および数値文字参照は、コードブロックおよびコードスパン内では認識されない。
| 種類 | 構文 | 例 |
|---|---|---|
| HTML エンティティ | &name; | & → &, < → <, > → > |
| 10進数値参照 | &#decimal; | # → # |
| 16進数値参照 | &#xhex; | # → # |
| コンテキスト | 展開 |
|---|---|
| 通常テキスト | される |
| コードスパン内 | されない |
| コードブロック内 | されない |
| 種類 | 構文 | 出力 |
|---|---|---|
| ハードブレーク | \ | <br /> |
| ソフトブレーク | 通常の改行 | スペースに変換 |
ハードブレーク:
行1\
行2
→ 行1<br />行2（同上）
ソフトブレーク:
行1
行2
→ 行1 行2（スペースで連結される）
段落区切り（空行）:
段落1
段落2
→ 別々の <p> 要素になる
本文中に [^id] で脚注参照を挿入する。
本文中の参照箇所[^1]。別の参照[^2]。
ドキュメント末尾に [^id]: 内容 で脚注の定義を記載する。
[^1]: 脚注の内容を記載する。
[^2]: 別の脚注の内容。
: の後にスペースを入れるドキュメントの先頭に --- で囲んだ YAML ブロックでメタデータを記載する。
---（3個のハイフン）を使用する--- とは用途が異なる（フロントマターは先頭行のみ有効）設計書の可読性とメンテナンス性を一貫させるため、以下のルールを適用する。
可読性のための整形・記法ルールは anytime-markdown-check スキルを単一の真実とする。本仕様では重複定義しない（値の不一致を防ぐため、旧 §3.17.1〜3.17.3 の個別ルールは anytime-markdown-check へ移管した）。
format_markdown(path, mode="fix")（mcp-markdown）が自動修正する。手書きで揃えない。anytime-markdown-check スキルのチェックリストに従う。AI エージェント（Claude Code 等）は設計書をファイル全体ではなく、検索 → 該当セクションのみ部分読み（offset/limit）で参照する。
文脈サイズを抑え、関連箇所だけを正確に拾わせるため以下を適用する。
##）単位で別ファイルに分割し、相互に related ／本文リンクでつなぐ。巨大ファイルは全体読み込みを誘発し、参照コストを押し上げる。[データモデル](04-data-model.ja.md) 等）で示す。部分読みされても文脈が壊れない。[customers](/tables/customers.md) 等）で必ず接続する。frontmatter の related だけに頼らず本文リンクでも結ぶことで、ドキュメント群がリンクグラフ（note-graph）を形成し、AI エージェントが関連文書を最小コストで辿れる（OKF のグラフ構造原則）。## 見出しと該当行範囲を併記した目次を置く。AI が必要なセクションだけを offset/limit で読めるようにする。概要 ／ 背景 ／ 設計 ／ データモデル ／ 制約 ／ リスク 等、プロジェクト共通の見出し語を用いる。検索（grep）での命中率が上がり、目的セクションへの到達が確実になる。[!NOTE] ドキュメント間の関係は frontmatter
related（ルート相対パス）で表す。人間は note-graph ビューアで俯瞰し、AI はrelatedを辿って関連文書のみを最小コストで参照する。型付き関連付け（{ to, type }形式）の導入後は本節に語彙・スキーマを追記する。
参考にした記事や出典がある場合は、本文中に脚注参照 [^1] を挿入し、ドキュメント末尾に脚注定義を記載する。
本文中の参照箇所[^1]。
[^1]: 著者名「記事タイトル」URL（参照日: YYYY-MM-DD）
Mermaid 図を含む場合は anytime-mermaid スキルに従う。
画像を挿入する場合は必ず alt テキストを記載する。
空の alt テキスト  は禁止。
<!-- NG -->
<!-- OK -->
ドキュメントに図表（テーブル・グラフ／チャート・Mermaid 図・画像）を含める場合、デジタル庁「ダッシュボードデザイン実践ガイドブック」の図表設計原則に従い、**「知りたいことが伝わる」「誤解を生まない」**図表にする。
伝えたい内容に応じて手段を選ぶ。
| 伝えたいこと | 推奨手段 |
|---|---|
| 網羅的な一覧・正確な値の参照 | Markdown テーブル |
| 傾向・比較・構成比（量の変化） | グラフ／チャート（折れ線・棒・円。プロジェクトのチャート記法または画像） |
| 構造・関係・フロー・状態遷移 | Mermaid（anytime-mermaid スキル） |
| 実物・スクリーンショット | 画像（alt 必須・第6章） |
[^n] で示す（第4章）。[!IMPORTANT] 色だけで情報を伝えない。色覚多様性に配慮し、白黒印刷でも伝わるようにする。
classDef の色だけに頼らず、ノードラベルや形状でも区別する。ドキュメントに図表を含めたら以下を確認する。
ドキュメントにアカウント情報（ユーザー名、パスワード、デフォルト認証情報等）を具体的に記載しない。
環境変数の説明では、デフォルト値欄に (必須) や (省略可) と記載し、実際の値を含めない。
type 別の記載内容（component spec の外部仕様原則・spec/e2e 2 ファイル分離・E2E シナリオ表・見出し粒度・索引運用を含む）は anytime-doc-authoring スキルへ移管した（値の不一致を防ぐため本仕様では重複定義しない。§3.17.1 の anytime-markdown-check への集約と同じ方針）。本スキルは構文・フロントマター・整形（どう書くか）のみを扱う。