@unlaxer/dge-toolkit 2.0.0 → 2.1.0

package/README.md

@@ -4,15 +4,31 @@
 
 ## すぐ始める
 
-Claude Code で:
+Claude Code で話しかけるだけ:
 
 ```
-「DGE して」           → 会話劇で Gap 発見
-「実装できるまで回して」 → 自動反復（収束まで）
-「キャラを追加して」    → カスタムキャラ作成
-「DGE を更新して」      → toolkit 更新案内
+--- 基本 ---
+「DGE して」              → ⚡ クイック。即座に会話劇が始まる
+「○○を DGE して」         → テーマ指定。クイックで開始
+「壁打ちして」「gap を探して」 → 同上
+
+--- 本格的にやる ---
+「詳しく DGE して」        → 🔍 設計レビュー。テンプレート・パターン・キャラ確認あり
+「○○を Spec 付きで DGE して」→ 同上。Gap → Spec 変換まで
+「本格的にレビューして」    → 同上
+
+--- ブレスト ---
+「ブレストして」           → 💡 ブレスト。Yes-and 話法でアイデア発散
+「アイデア出して」          → 同上
+
+--- 便利機能 ---
+「実装できるまで回して」    → 自動反復（収束まで繰り返す）
+「キャラを追加して」       → カスタムキャラ作成
+「DGE を更新して」         → toolkit 更新案内
 ```
 
+言い方は自由。ニュアンスで自動的に適切なモードが選ばれます。
+
 他の LLM は `method.md` のクイックスタート（方法 A）を参照。
 
 ## キャラクター早見表

package/bin/dge-tool.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const VERSION = '1.0.0';
+const command = process.argv[2];
+const arg = process.argv[3];
+
+function findFlowsDir() {
+  // Look for dge/flows/ from current directory
+  const candidates = ['dge/flows', 'flows'];
+  for (const dir of candidates) {
+    if (fs.existsSync(dir)) return dir;
+  }
+  return null;
+}
+
+function cmdSave() {
+  const file = arg;
+  if (!file) {
+    console.error('ERROR: file path required. Usage: echo "content" | dge-tool save <file>');
+    process.exit(1);
+  }
+
+  const dir = path.dirname(file);
+  fs.mkdirSync(dir, { recursive: true });
+
+  let content = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', chunk => { content += chunk; });
+  process.stdin.on('end', () => {
+    fs.writeFileSync(file, content);
+    const bytes = Buffer.byteLength(content);
+    console.log(`SAVED: ${file} (${bytes} bytes)`);
+  });
+}
+
+function cmdPrompt() {
+  const flow = arg || 'quick';
+  const flowsDir = findFlowsDir();
+  const yamlFile = flowsDir ? path.join(flowsDir, `${flow}.yaml`) : null;
+
+  if (yamlFile && fs.existsSync(yamlFile)) {
+    const content = fs.readFileSync(yamlFile, 'utf8');
+    const lines = content.split('\n');
+
+    // Extract display_name from post_actions section
+    let inPostActions = false;
+    const actions = [];
+    for (const line of lines) {
+      if (line.match(/^post_actions:/)) {
+        inPostActions = true;
+        continue;
+      }
+      if (inPostActions && line.match(/^\S/) && !line.match(/^\s/)) {
+        break; // End of post_actions section
+      }
+      if (inPostActions) {
+        const match = line.match(/display_name:\s*"(.+?)"/);
+        if (match) actions.push(match[1]);
+      }
+    }
+
+    if (actions.length > 0) {
+      actions.forEach((a, i) => {
+        console.log(`  ${i + 1}. ${a}`);
+      });
+      return;
+    }
+  }
+
+  // Default choices
+  console.log('  1. DGE を回す');
+  console.log('  2. 実装できるまで回す');
+  console.log('  3. 実装する');
+  console.log('  4. 素の LLM でも回してマージ');
+  console.log('  5. 後で');
+}
+
+function cmdVersion() {
+  console.log(`dge-tool v${VERSION}`);
+}
+
+function cmdHelp() {
+  console.log(`dge-tool v${VERSION} — DGE MUST enforcement CLI
+
+Commands:
+  save <file>       Save stdin to file (ensures MUST: always save)
+  prompt [flow]     Show numbered choices from flow YAML (ensures MUST: show choices)
+  version           Show version
+  help              Show this help
+
+Examples:
+  echo "session content" | dge-tool save dge/sessions/auth-api.md
+  dge-tool prompt quick
+  dge-tool prompt design-review`);
+}
+
+// Dispatch
+switch (command) {
+  case 'save':
+    cmdSave();
+    break;
+  case 'prompt':
+    cmdPrompt();
+    break;
+  case 'version':
+  case '-v':
+  case '--version':
+    cmdVersion();
+    break;
+  case 'help':
+  case '-h':
+  case '--help':
+  case undefined:
+    cmdHelp();
+    break;
+  default:
+    console.error(`ERROR: unknown command "${command}". Run "dge-tool help" for usage.`);
+    process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlaxer/dge-toolkit",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "DGE (Dialogue-driven Gap Extraction) — 会話劇で設計の穴を発見するメソッドkit",
   "license": "MIT",
   "repository": {
@@ -18,7 +18,8 @@
   ],
   "bin": {
     "dge-install": "./install.sh",
-    "dge-update": "./update.sh"
+    "dge-update": "./update.sh",
+    "dge-tool": "./bin/dge-tool.js"
   },
   "files": [
     "LICENSE",
@@ -34,6 +35,7 @@
     "INTERNALS.md",
     "CUSTOMIZING.md",
     "dialogue-techniques.md",
+    "bin/",
     "install.sh",
     "update.sh"
   ],

package/skills/dge-session.md

@@ -36,6 +36,9 @@
 3. `dge/custom/characters/*.md` があれば Prompt Core を読む
 4. `dge/patterns.md` を読む
 5. `dge/version.txt` があれば 1 行表示
+6. **dge-tool 検出**: Bash で `dge-tool version` を実行。
+   - 成功 → `🔧 Tool mode (dge-tool vX.X.X)` と表示。以降 Step 7, 8 で dge-tool を使用
+   - 失敗 → Skill mode（従来通り）。dge-tool なしでも全機能動作
 
 ### Step 2: テーマ確認（全 flow 共通）
 明確なら次へ。不明確なら掘り下げる。
@@ -62,6 +65,15 @@ built-in + カスタムキャラを統合表示。
 - brainstorm: アイデアに分類を付与（severity なし）
 
 ### Step 7: 保存（全 flow 共通、MUST）
+
+**Tool mode**: Bash で実行:
+```
+echo "<session 全文>" | dge-tool save <output_dir>/<theme>.md
+```
+→ "SAVED: ..." が返れば成功。失敗したら Write ツールでフォールバック。
+
+**Skill mode**: Write ツールでファイル保存。
+
 flow の output_dir に保存（デフォルト: `dge/sessions/`）。
 プロジェクトファイルがあれば更新。
 
@@ -81,7 +93,13 @@ flow の output_dir に保存（デフォルト: `dge/sessions/`）。
 **全文**: `[ファイルパス]`
 ```
 
-選択肢は flow YAML の post_actions から表示。YAML がない場合のデフォルト:
+**Tool mode**: Bash で実行:
+```
+dge-tool prompt <flow>
+```
+→ 番号付き選択肢が返る。そのまま表示。失敗したらデフォルト選択肢でフォールバック。
+
+**Skill mode**: 選択肢は flow YAML の post_actions から表示。YAML がない場合のデフォルト:
 ```
 1. DGE を回す
 2. 実装できるまで回す

package/version.txt

@@ -1 +1 @@
-2.0.0
+2.1.0