@unlaxer/dde-toolkit 0.1.5 → 0.1.6

package/flows/quick.yaml

@@ -16,6 +16,10 @@ workflow:
     - id: scan_glossary
       display_name: "既存 glossary をスキャン"
       note: "docs/glossary/ の既存記事一覧を収集。相互リンク候補 + 抽出除外リストに使う"
+    - id: detect_template
+      display_name: "記事テンプレートを確定"
+      mode: confirm
+      note: ".dde-template.md があれば再利用。なければ既存記事の H2 を多数決で抽出 → ユーザー確認 → 保存"
     - id: select_docs
       display_name: "対象ドキュメント群を選択"
       mode: confirm

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlaxer/dde-toolkit",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Document Deficit Extraction — find what's not understood in your docs",
   "license": "MIT",
   "type": "module",

package/skills/dde-session.md

@@ -67,10 +67,11 @@ DDE toolkit v0.1.3 — Document Deficit Extraction
 新規セッションの場合は skip。
 
 **0-C: 既存 glossary スキャン（MUST）**
-`docs/glossary/` の `.md` ファイル一覧を収集する。これを 2 つの目的に使う:
+`docs/glossary/` の `.md` ファイル一覧を収集する。これを 3 つの目的に使う:
 
 1. **抽出除外リスト** — 既存記事がある用語は抽出対象から除外（Step 6）
 2. **相互リンク候補リスト** — 「さらに学ぶために」で使えるリンク一覧（Step 7）
+3. **テンプレート抽出** — 既存記事の H2 構造を分析してフォーマットを確定（後述）
 
 ```
 既存 glossary: 12 記事
@@ -81,6 +82,72 @@ DDE toolkit v0.1.3 — Document Deficit Extraction
 
 ファイルが存在しない場合は空リストで OK（新規プロジェクト）。
 
+**0-D: 記事テンプレートの確定**
+
+まず `docs/glossary/.dde-template.md` が存在するか確認する。
+
+- **存在する場合**: そのテンプレートを使用（再分析不要。ユーザーに「既存テンプレートを使用します」と通知）
+- **存在しない場合**: 以下の手順でテンプレートを抽出する
+
+**テンプレート自動抽出手順:**
+1. 既存 `.md` ファイルから **EN 用と JA 用それぞれ** 3〜5 件をサンプリング（辞書順）
+2. 各ファイルの H2 見出し（`## ...`）を列挙
+3. **多数決**で共通パターンを確定（過半数のファイルに存在する見出しを採用）
+4. ユーザーに確認・修正を求める:
+
+```
+既存 glossary のセクション構造を検出しました:
+
+EN 記事テンプレート:
+  ## What is it?
+  ## Why does it matter?
+  ## How does it work?
+  ## How does [project] use it?
+  ## Common mistakes / attacks
+  ## Further reading
+
+JA 記事テンプレート:
+  ## これは何？
+  ## なぜ重要なのか？
+  ## どう動くのか？
+  ## [project] ではどう使われている？
+  ## よくある間違いと攻撃
+  ## さらに学ぶ
+
+このテンプレートで記事を生成します。修正しますか？
+1. このまま使う（推奨）
+2. 修正する
+3. デフォルト（DDE educational format）を使う
+```
+
+5. 確定後、`docs/glossary/.dde-template.md` に保存する（次回セッションで再利用）
+
+**`.dde-template.md` のフォーマット:**
+```markdown
+<!-- DDE auto-detected template — edit freely -->
+<!-- generated: 2024-01-15 from 5 sample articles -->
+
+## en
+
+## What is it?
+## Why does it matter?
+## How does it work?
+## How does [project] use it?
+## Common mistakes / attacks
+## Further reading
+
+---
+
+## ja
+
+## これは何？
+## なぜ重要なのか？
+## どう動くのか？
+## [project] ではどう使われている？
+## よくある間違いと攻撃
+## さらに学ぶ
+```
+
 **CRITICAL RULE — 相互リンク**:
 「さらに学ぶために」に書くリンクは、**記事生成時点で `docs/glossary/` に実在するファイルのみ**。
 存在しないファイルへのリンクは絶対に書かない。同一バッチで新規生成する記事同士は相互リンク可。
@@ -142,15 +209,14 @@ DDE toolkit v0.1.3 — Document Deficit Extraction
 
 **文字数ではなく「読んだ人にどうなってほしいか」で指定する。**
 
-Step 0-C で既存 glossary 記事が見つかった場合は、まずそのスタイルを分析して選択肢に追加する。
+Step 0-D で確定したテンプレートを使用する。既存 glossary 記事が見つかった場合は「既存に合わせる」が推奨。
 
 **既存記事がある場合の表示例:**
 ```
-既存 glossary のスタイルを分析しました:
-  → educational narrative（例え話・ASCIIダイアグラム・相互リンクあり）
+テンプレート: docs/glossary/.dde-template.md（5 件から抽出済み）
 
 記事のインテントを選んでください:
-1. 既存に合わせる（推奨）— 既存記事のスタイル・分量・構成を踏襲
+1. 既存に合わせる（推奨）— Step 0-D で確定したテンプレート構成を使用
 2. educational — 背景・動機・仕組みごと理解できる記事
                  例え話・図・なぜ？を含む。分量は目的に従って自然に決まる
 3. reference   — 定義と使い方を簡潔に。調べたい人向け

package/version.txt

@@ -1 +1 @@
-0.1.5
+0.1.6