@unlaxer/dde-toolkit 0.1.4 → 0.1.6

package/flows/quick.yaml

@@ -5,7 +5,8 @@ trigger_keywords: ["DDE して", "DDE", "ドキュメントレビュー", "用
 
 defaults:
   exclude_dirs: ["dde", "dge", "node_modules", ".git", ".claude"]
-  article_intent: educational   # educational / reference / deep-dive
+  article_intent: match_existing   # match_existing / educational / reference / deep-dive
+  # match_existing: 既存 glossary 記事が 1 件以上あればそのスタイルを踏襲。なければ educational にフォールバック
 
 workflow:
   steps:
@@ -15,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
@@ -29,7 +34,7 @@ workflow:
     - id: article_intent
       display_name: "記事のインテント設定"
       mode: confirm
-      note: "educational / reference / deep-dive、または自由記述"
+      note: "match_existing（推奨）/ educational / reference / deep-dive、または自由記述"
     - id: extract
       display_name: "用語抽出（LLM）— 全レベル対象"
       actor: llm
@@ -74,6 +79,7 @@ articleize:
     ja:   "<slug>.ja.md"
     both: "両ファイル生成。dictionary.yaml に en/ja キーで用語マッピングを追加"
   intents:
+    match_existing: "既存 glossary 記事を 1〜3 件サンプリングしてスタイル（構成・文体・分量・例え話の有無）を推定し、新規記事に踏襲。既存記事がなければ educational にフォールバック"
     educational: "読んだ人が背景・動機・仕組みごと理解できる記事。例え話・図・なぜ？を含む。分量は目的に従って自然に決める"
     reference:   "定義・使い方・例を簡潔に。調べたい人向けのクイックリファレンス"
     deep-dive:   "実装詳細・コード例・エッジケース・トレードオフまで網羅"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlaxer/dde-toolkit",
-  "version": "0.1.4",
+  "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,6 +209,24 @@ DDE toolkit v0.1.3 — Document Deficit Extraction
 
 **文字数ではなく「読んだ人にどうなってほしいか」で指定する。**
 
+Step 0-D で確定したテンプレートを使用する。既存 glossary 記事が見つかった場合は「既存に合わせる」が推奨。
+
+**既存記事がある場合の表示例:**
+```
+テンプレート: docs/glossary/.dde-template.md（5 件から抽出済み）
+
+記事のインテントを選んでください:
+1. 既存に合わせる（推奨）— Step 0-D で確定したテンプレート構成を使用
+2. educational — 背景・動機・仕組みごと理解できる記事
+                 例え話・図・なぜ？を含む。分量は目的に従って自然に決まる
+3. reference   — 定義と使い方を簡潔に。調べたい人向け
+4. deep-dive   — 実装詳細・コード例・エッジケースまで網羅
+5. 自由記述    — 例: 「新入社員が読んで業務背景ごと理解できるように」
+
+デフォルト: 1（既存に合わせる）
+```
+
+**既存記事がない場合の表示例:**
 ```
 記事のインテントを選んでください:
 1. educational — 背景・動機・仕組みごと理解できる記事
@@ -153,6 +238,13 @@ DDE toolkit v0.1.3 — Document Deficit Extraction
 デフォルト: educational
 ```
 
+**「既存に合わせる」を選んだ場合:**
+既存記事を 1〜3 件サンプリングして以下を推定し、新規記事に適用する:
+- セクション構成（見出しの種類・順序）
+- 文体（ですます / だ・である、日本語 / 英語混在度）
+- 分量感（短め / 中程度 / 詳細）
+- 例え話・図の有無
+
 ### Step 6: 用語抽出（LLM）
 
 **レベルで絞らず、誰かが分からない可能性がある用語を全て抽出する。**

package/version.txt

@@ -1 +1 @@
-0.1.4
+0.1.6