@knowledgine/cli 0.4.1 → 0.6.0

package/dist/templates/skills/knowledgine-capture/skill-md.d.ts

@@ -1,2 +1,2 @@
-export declare const SKILL_MD = "---\nname: knowledgine-capture\ndescription: >\n  Record knowledge to the local knowledge base after solving problems, making design\n  decisions, or discovering reusable patterns. Invoke whenever you have just fixed a bug,\n  made an architectural choice, found a reusable pattern, learned something from external\n  sources, or completed a refactoring. Capturing while context is fresh prevents knowledge\n  loss across sessions.\n---\n# knowledgine-capture\n\n## Purpose\n\nPersist valuable learnings from the current session into the local knowledge base so they\nare available for future sessions and team members. The knowledge base is only as useful\nas what is recorded into it.\n\n## When to Use\n\nCapture knowledge when **any** of the following events occur in the session:\n\n1. **Bug fix** \u2014 You identified a root cause and applied a solution\n2. **Design decision** \u2014 You chose one approach over alternatives with reasoning\n3. **Pattern discovery** \u2014 You found a reusable pattern worth applying elsewhere\n4. **Troubleshooting** \u2014 You worked through a non-obvious diagnosis process\n5. **External knowledge** \u2014 You applied insights from documentation, articles, or Stack Overflow\n6. **Refactoring** \u2014 You improved existing code with a clear before/after\n\n## When NOT to Use\n\n- Trivial edits (typo fixes, formatting changes) that contain no transferable insight\n- Highly project-specific one-off changes with no reuse value\n- Duplicate entries: first search with `search_knowledge` to check if the knowledge already exists\n\n## How to Capture (MCP Tool)\n\nUse the `capture_knowledge` MCP tool:\n\n```\ncapture_knowledge(\n  content: string,   // Full explanation: problem + solution + context\n  title: string,     // Short descriptive title (max ~80 chars)\n  tags: string[],    // 2\u20135 tags from the standard taxonomy\n  source?: string    // Optional: URL, filename, or reference source\n)\n```\n\n## How to Capture (CLI Alternative)\n\n```bash\nknowledgine capture add \"<content>\" --title \"<title>\" --tags \"<tag1>,<tag2>\"\n```\n\n## Content Format\n\nStructure each capture as three parts:\n\n1. **Problem / Context** \u2014 What situation triggered this learning?\n2. **Solution / Decision** \u2014 What was done and how?\n3. **Rationale / Notes** \u2014 Why this approach? What alternatives were considered?\n\nExample:\n```\n**Problem**: TypeScript threw \"Type 'unknown' is not assignable to type 'User'\" when\nparsing API response.\n\n**Solution**: Added a type guard function isUser(val: unknown): val is User that checks\nfor required fields before narrowing the type.\n\n**Rationale**: Using 'as User' cast was unsafe because the API response structure could\nchange. The type guard provides runtime validation and compile-time safety.\n```\n\n## Step-by-Step Instructions\n\n1. **Identify the trigger** \u2014 Which of the 6 capture events occurred?\n2. **Draft the content** \u2014 Write problem + solution + rationale in plain prose\n3. **Choose a title** \u2014 Concise, searchable (start with verb or noun phrase)\n4. **Select 2\u20135 tags** \u2014 Use the standard taxonomy (see capture-guide.md)\n5. **Call capture_knowledge** \u2014 Pass content, title, tags, and optional source\n6. **Verify** \u2014 Confirm the tool returned a success response\n\n## Best Practices\n\n- Capture immediately after the event while details are fresh\n- Write for a future reader who has no context from this session\n- Prefer one focused capture per insight over large omnibus entries\n- Include error messages verbatim \u2014 they are the most effective search terms\n- Tag precisely: broad tags like \"misc\" reduce discoverability\n\n## Reference Files\n\n- See `capture-guide.md` for detailed guidance on each trigger type with examples\n- See `tag-taxonomy.md` for the standard tag categories\n- See `format-examples.md` for 3\u20135 concrete capture examples\n";
+export declare const SKILL_MD = "---\nname: knowledgine-capture\nversion: \"1.0.0\"\nlang: en\ndescription: >\n  Record knowledge to the local knowledge base after solving problems, making design\n  decisions, or discovering reusable patterns. Invoke whenever you have just fixed a bug,\n  made an architectural choice, found a reusable pattern, learned something from external\n  sources, or completed a refactoring. Capturing while context is fresh prevents knowledge\n  loss across sessions.\n---\n# knowledgine-capture\n\n## Purpose\n\nPersist valuable learnings from the current session into the local knowledge base so they\nare available for future sessions and team members. The knowledge base is only as useful\nas what is recorded into it.\n\n## When to Use\n\nCapture knowledge when **any** of the following events occur in the session:\n\n1. **Bug fix** \u2014 You identified a root cause and applied a solution\n2. **Design decision** \u2014 You chose one approach over alternatives with reasoning\n3. **Pattern discovery** \u2014 You found a reusable pattern worth applying elsewhere\n4. **Troubleshooting** \u2014 You worked through a non-obvious diagnosis process\n5. **External knowledge** \u2014 You applied insights from documentation, articles, or Stack Overflow\n6. **Refactoring** \u2014 You improved existing code with a clear before/after\n\n## When NOT to Use\n\n- Trivial edits (typo fixes, formatting changes) that contain no transferable insight\n- Highly project-specific one-off changes with no reuse value\n- Duplicate entries: first search with `search_knowledge` to check if the knowledge already exists\n\n## How to Capture (MCP Tool)\n\nUse the `capture_knowledge` MCP tool:\n\n```\ncapture_knowledge(\n  content: string,   // Full explanation: problem + solution + context\n  title?: string,    // Short descriptive title (max ~80 chars)\n  tags?: string[],   // 2\u20135 tags from the standard taxonomy\n  source?: string    // Optional: URL, filename, or reference source\n)\n```\n\n## How to Capture (CLI Alternative)\n\n```bash\nknowledgine capture add \"<content>\" --title \"<title>\" --tags \"<tag1>,<tag2>\"\n```\n\n## Content Format\n\nStructure each capture as three parts:\n\n1. **Problem / Context** \u2014 What situation triggered this learning?\n2. **Solution / Decision** \u2014 What was done and how?\n3. **Rationale / Notes** \u2014 Why this approach? What alternatives were considered?\n\nExample:\n```\n**Problem**: TypeScript threw \"Type 'unknown' is not assignable to type 'User'\" when\nparsing API response.\n\n**Solution**: Added a type guard function isUser(val: unknown): val is User that checks\nfor required fields before narrowing the type.\n\n**Rationale**: Using 'as User' cast was unsafe because the API response structure could\nchange. The type guard provides runtime validation and compile-time safety.\n```\n\n## Step-by-Step Instructions\n\n1. **Identify the trigger** \u2014 Which of the 6 capture events occurred?\n2. **Draft the content** \u2014 Write problem + solution + rationale in plain prose\n3. **Choose a title** \u2014 Concise, searchable (start with verb or noun phrase)\n4. **Select 2\u20135 tags** \u2014 Use the standard taxonomy (see capture-guide.md)\n5. **Call capture_knowledge** \u2014 Pass content, title, tags, and optional source\n6. **Verify** \u2014 Confirm the tool returned a success response\n\n## Best Practices\n\n- Capture immediately after the event while details are fresh\n- Write for a future reader who has no context from this session\n- Prefer one focused capture per insight over large omnibus entries\n- Include error messages verbatim \u2014 they are the most effective search terms\n- Tag precisely: broad tags like \"misc\" reduce discoverability\n\n## Reference Files\n\n- See `capture-guide.md` for detailed guidance on each trigger type with examples\n- See `tag-taxonomy.md` for the standard tag categories\n- See `format-examples.md` for 3\u20135 concrete capture examples\n";
 //# sourceMappingURL=skill-md.d.ts.map

package/dist/templates/skills/knowledgine-capture/skill-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-capture/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,m2HA+FpB,CAAC"}
+{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-capture/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,i4HAiGpB,CAAC"}

package/dist/templates/skills/knowledgine-capture/skill-md.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_MD = "---\nname: knowledgine-capture\nversion: \"1.0.0\"\nlang: ja\ndescription: >\n  \u554F\u984C\u3092\u89E3\u6C7A\u3057\u305F\u308A\u3001\u8A2D\u8A08\u4E0A\u306E\u5224\u65AD\u3092\u884C\u3063\u305F\u308A\u3001\u518D\u5229\u7528\u53EF\u80FD\u306A\u30D1\u30BF\u30FC\u30F3\u3092\u767A\u898B\u3057\u305F\u5F8C\u306B\u3001\n  \u30ED\u30FC\u30AB\u30EB\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u3078\u77E5\u8B58\u3092\u8A18\u9332\u3057\u307E\u3059\u3002\u30D0\u30B0\u3092\u4FEE\u6B63\u3057\u305F\u76F4\u5F8C\u3001\u30A2\u30FC\u30AD\u30C6\u30AF\u30C1\u30E3\u306E\u9078\u629E\u3092\u3057\u305F\u5F8C\u3001\n  \u518D\u5229\u7528\u53EF\u80FD\u306A\u30D1\u30BF\u30FC\u30F3\u3092\u767A\u898B\u3057\u305F\u5F8C\u3001\u5916\u90E8\u30BD\u30FC\u30B9\u304B\u3089\u5B66\u3093\u3060\u5F8C\u3001\u307E\u305F\u306F\u30EA\u30D5\u30A1\u30AF\u30BF\u30EA\u30F3\u30B0\u3092\u5B8C\u4E86\u3057\u305F\u5F8C\u306B\n  \u547C\u3073\u51FA\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u65B0\u9BAE\u306A\u3046\u3061\u306B\u8A18\u9332\u3059\u308B\u3053\u3068\u3067\u3001\u30BB\u30C3\u30B7\u30E7\u30F3\u9593\u306E\u77E5\u8B58\u55AA\u5931\u3092\u9632\u304E\u307E\u3059\u3002\n---\n# knowledgine-capture\n\n## \u76EE\u7684\n\n\u73FE\u5728\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067\u5F97\u305F\u8CB4\u91CD\u306A\u5B66\u3073\u3092\u30ED\u30FC\u30AB\u30EB\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306B\u4FDD\u5B58\u3057\u3001\n\u5C06\u6765\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3084\u30C1\u30FC\u30E0\u30E1\u30F3\u30D0\u30FC\u304C\u53C2\u7167\u3067\u304D\u308B\u3088\u3046\u306B\u3057\u307E\u3059\u3002\n\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306F\u8A18\u9332\u3055\u308C\u305F\u5185\u5BB9\u3060\u3051\u304C\u4FA1\u5024\u3092\u6301\u3061\u307E\u3059\u3002\n\n## \u4F7F\u7528\u3059\u308B\u30BF\u30A4\u30DF\u30F3\u30B0\n\n\u30BB\u30C3\u30B7\u30E7\u30F3\u4E2D\u306B\u4EE5\u4E0B\u306E**\u3044\u305A\u308C\u304B\u306E**\u30A4\u30D9\u30F3\u30C8\u304C\u767A\u751F\u3057\u305F\u3068\u304D\u306B\u77E5\u8B58\u3092\u30AD\u30E3\u30D7\u30C1\u30E3\u3057\u307E\u3059\uFF1A\n\n1. **\u30D0\u30B0\u4FEE\u6B63** \u2014 \u6839\u672C\u539F\u56E0\u3092\u7279\u5B9A\u3057\u3001\u89E3\u6C7A\u7B56\u3092\u9069\u7528\u3057\u305F\n2. **\u8A2D\u8A08\u5224\u65AD** \u2014 \u7406\u7531\u3092\u6301\u3063\u3066\u8907\u6570\u306E\u9078\u629E\u80A2\u304B\u3089\u4E00\u3064\u306E\u30A2\u30D7\u30ED\u30FC\u30C1\u3092\u9078\u3093\u3060\n3. **\u30D1\u30BF\u30FC\u30F3\u767A\u898B** \u2014 \u4ED6\u306E\u5834\u6240\u3067\u3082\u9069\u7528\u3067\u304D\u308B\u518D\u5229\u7528\u53EF\u80FD\u306A\u30D1\u30BF\u30FC\u30F3\u3092\u898B\u3064\u3051\u305F\n4. **\u30C8\u30E9\u30D6\u30EB\u30B7\u30E5\u30FC\u30C6\u30A3\u30F3\u30B0** \u2014 \u975E\u81EA\u660E\u306A\u8A3A\u65AD\u30D7\u30ED\u30BB\u30B9\u3092\u7D4C\u3066\u554F\u984C\u3092\u89E3\u6C7A\u3057\u305F\n5. **\u5916\u90E8\u77E5\u8B58** \u2014 \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3001\u8A18\u4E8B\u3001Stack Overflow\u306A\u3069\u304B\u3089\u5F97\u305F\u77E5\u898B\u3092\u9069\u7528\u3057\u305F\n6. **\u30EA\u30D5\u30A1\u30AF\u30BF\u30EA\u30F3\u30B0** \u2014 \u660E\u78BA\u306A\u30D3\u30D5\u30A9\u30FC\u30FB\u30A2\u30D5\u30BF\u30FC\u3092\u6301\u3064\u5F62\u3067\u65E2\u5B58\u30B3\u30FC\u30C9\u3092\u6539\u5584\u3057\u305F\n\n## \u4F7F\u7528\u3057\u306A\u3044\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- \u79FB\u8EE2\u53EF\u80FD\u306A\u77E5\u898B\u3092\u542B\u307E\u306A\u3044\u4E9B\u7D30\u306A\u7DE8\u96C6\uFF08\u8AA4\u5B57\u4FEE\u6B63\u3001\u30D5\u30A9\u30FC\u30DE\u30C3\u30C8\u5909\u66F4\u306A\u3069\uFF09\n- \u518D\u5229\u7528\u4FA1\u5024\u306E\u306A\u3044\u3001\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u56FA\u6709\u306E\u4E00\u56DE\u9650\u308A\u306E\u5909\u66F4\n- \u91CD\u8907\u30A8\u30F3\u30C8\u30EA\uFF1A\u307E\u305A `search_knowledge` \u3067\u65E2\u5B58\u306E\u77E5\u8B58\u3092\u691C\u7D22\u3057\u3066\u304F\u3060\u3055\u3044\n\n## \u30AD\u30E3\u30D7\u30C1\u30E3\u65B9\u6CD5\uFF08MCP\u30C4\u30FC\u30EB\uFF09\n\n`capture_knowledge` MCP\u30C4\u30FC\u30EB\u3092\u4F7F\u7528\u3057\u307E\u3059\uFF1A\n\n```\ncapture_knowledge(\n  content: string,   // \u5B8C\u5168\u306A\u8AAC\u660E\uFF1A\u554F\u984C + \u89E3\u6C7A\u7B56 + \u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\n  title?: string,    // \u77ED\u3044\u8AAC\u660E\u7684\u306A\u30BF\u30A4\u30C8\u30EB\uFF08\u6700\u5927\u7D0480\u6587\u5B57\uFF09\n  tags?: string[],   // \u6A19\u6E96\u30BF\u30AF\u30BD\u30CE\u30DF\u30FC\u304B\u30892\u301C5\u500B\u306E\u30BF\u30B0\n  source?: string    // \u4EFB\u610F\uFF1AURL\u3001\u30D5\u30A1\u30A4\u30EB\u540D\u3001\u307E\u305F\u306F\u53C2\u7167\u5143\n)\n```\n\n## \u30AD\u30E3\u30D7\u30C1\u30E3\u65B9\u6CD5\uFF08CLI\u306E\u4EE3\u66FF\u624B\u6BB5\uFF09\n\n```bash\nknowledgine capture add \"<content>\" --title \"<title>\" --tags \"<tag1>,<tag2>\"\n```\n\n## \u30B3\u30F3\u30C6\u30F3\u30C4\u30D5\u30A9\u30FC\u30DE\u30C3\u30C8\n\n\u5404\u30AD\u30E3\u30D7\u30C1\u30E3\u306F3\u3064\u306E\u30D1\u30FC\u30C8\u3067\u69CB\u6210\u3057\u307E\u3059\uFF1A\n\n1. **\u554F\u984C / \u30B3\u30F3\u30C6\u30AD\u30B9\u30C8** \u2014 \u3053\u306E\u5B66\u3073\u306E\u304D\u3063\u304B\u3051\u3068\u306A\u3063\u305F\u72B6\u6CC1\u306F\u4F55\u304B\uFF1F\n2. **\u89E3\u6C7A\u7B56 / \u5224\u65AD** \u2014 \u4F55\u3092\u3069\u306E\u3088\u3046\u306B\u884C\u3063\u305F\u304B\uFF1F\n3. **\u7406\u7531 / \u5099\u8003** \u2014 \u306A\u305C\u3053\u306E\u30A2\u30D7\u30ED\u30FC\u30C1\u3092\u9078\u3093\u3060\u304B\uFF1F\u3069\u3093\u306A\u4EE3\u66FF\u6848\u3092\u691C\u8A0E\u3057\u305F\u304B\uFF1F\n\n\u4F8B\uFF1A\n```\n**Problem**: TypeScript threw \"Type 'unknown' is not assignable to type 'User'\" when\nparsing API response.\n\n**Solution**: Added a type guard function isUser(val: unknown): val is User that checks\nfor required fields before narrowing the type.\n\n**Rationale**: Using 'as User' cast was unsafe because the API response structure could\nchange. The type guard provides runtime validation and compile-time safety.\n```\n\n## \u30B9\u30C6\u30C3\u30D7\u30D0\u30A4\u30B9\u30C6\u30C3\u30D7\u306E\u624B\u9806\n\n1. **\u30C8\u30EA\u30AC\u30FC\u3092\u7279\u5B9A\u3059\u308B** \u2014 6\u3064\u306E\u30AD\u30E3\u30D7\u30C1\u30E3\u30A4\u30D9\u30F3\u30C8\u306E\u3069\u308C\u304C\u767A\u751F\u3057\u305F\u304B\uFF1F\n2. **\u5185\u5BB9\u3092\u4E0B\u66F8\u304D\u3059\u308B** \u2014 \u554F\u984C + \u89E3\u6C7A\u7B56 + \u7406\u7531\u3092\u5E73\u6587\u3067\u66F8\u304F\n3. **\u30BF\u30A4\u30C8\u30EB\u3092\u9078\u3076** \u2014 \u7C21\u6F54\u3067\u691C\u7D22\u3057\u3084\u3059\u3044\u3082\u306E\uFF08\u52D5\u8A5E\u304B\u540D\u8A5E\u53E5\u3067\u59CB\u3081\u308B\uFF09\n4. **2\u301C5\u500B\u306E\u30BF\u30B0\u3092\u9078\u3076** \u2014 \u6A19\u6E96\u30BF\u30AF\u30BD\u30CE\u30DF\u30FC\u3092\u4F7F\u7528\u3059\u308B\uFF08capture-guide.md\u53C2\u7167\uFF09\n5. **capture_knowledge\u3092\u547C\u3073\u51FA\u3059** \u2014 content\u3001title\u3001tags\u3001\u4EFB\u610F\u306Esource\u3092\u6E21\u3059\n6. **\u78BA\u8A8D\u3059\u308B** \u2014 \u30C4\u30FC\u30EB\u304C\u6210\u529F\u30EC\u30B9\u30DD\u30F3\u30B9\u3092\u8FD4\u3057\u305F\u3053\u3068\u3092\u78BA\u8A8D\u3059\u308B\n\n## \u30D9\u30B9\u30C8\u30D7\u30E9\u30AF\u30C6\u30A3\u30B9\n\n- \u30A4\u30D9\u30F3\u30C8\u76F4\u5F8C\u306B\u8A18\u9332\u3059\u308B\u2014\u2014\u8A73\u7D30\u304C\u65B0\u9BAE\u306A\u3046\u3061\u306B\n- \u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3092\u6301\u305F\u306A\u3044\u5C06\u6765\u306E\u8AAD\u8005\u3092\u60F3\u5B9A\u3057\u3066\u66F8\u304F\n- \u5927\u304D\u306A\u307E\u3068\u3081\u30A8\u30F3\u30C8\u30EA\u3088\u308A\u3001\u4E00\u3064\u306E\u77E5\u898B\u306B\u96C6\u4E2D\u3057\u305F\u8A18\u9332\u3092\u512A\u5148\u3059\u308B\n- \u30A8\u30E9\u30FC\u30E1\u30C3\u30BB\u30FC\u30B8\u306F\u305D\u306E\u307E\u307E\u542B\u3081\u308B\u2014\u2014\u6700\u3082\u52B9\u679C\u7684\u306A\u691C\u7D22\u30EF\u30FC\u30C9\u306B\u306A\u308B\n- \u30BF\u30B0\u306F\u6B63\u78BA\u306B\u9078\u3076\uFF1A\u300Cmisc\u300D\u306E\u3088\u3046\u306A\u5E83\u3044\u30BF\u30B0\u306F\u767A\u898B\u6027\u3092\u4E0B\u3052\u308B\n\n## \u53C2\u7167\u30D5\u30A1\u30A4\u30EB\n\n- \u5404\u30C8\u30EA\u30AC\u30FC\u30BF\u30A4\u30D7\u306E\u8A73\u7D30\u30AC\u30A4\u30C9\u3068\u4F8B\u306F `capture-guide.md` \u3092\u53C2\u7167\n- \u6A19\u6E96\u30BF\u30B0\u30AB\u30C6\u30B4\u30EA\u306F `tag-taxonomy.md` \u3092\u53C2\u7167\n- \u5177\u4F53\u7684\u306A\u30AD\u30E3\u30D7\u30C1\u30E3\u4F8B\u306F `format-examples.md` \u3092\u53C2\u7167\n";
+//# sourceMappingURL=skill-md.ja.d.ts.map

package/dist/templates/skills/knowledgine-capture/skill-md.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-capture/skill-md.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,uqQAgGpB,CAAC"}

package/dist/templates/skills/knowledgine-capture/skill-md.ja.js

@@ -0,0 +1,98 @@
+export const SKILL_MD = `---
+name: knowledgine-capture
+version: "1.0.0"
+lang: ja
+description: >
+  問題を解決したり、設計上の判断を行ったり、再利用可能なパターンを発見した後に、
+  ローカルナレッジベースへ知識を記録します。バグを修正した直後、アーキテクチャの選択をした後、
+  再利用可能なパターンを発見した後、外部ソースから学んだ後、またはリファクタリングを完了した後に
+  呼び出してください。コンテキストが新鮮なうちに記録することで、セッション間の知識喪失を防ぎます。
+---
+# knowledgine-capture
+
+## 目的
+
+現在のセッションで得た貴重な学びをローカルナレッジベースに保存し、
+将来のセッションやチームメンバーが参照できるようにします。
+ナレッジベースは記録された内容だけが価値を持ちます。
+
+## 使用するタイミング
+
+セッション中に以下の**いずれかの**イベントが発生したときに知識をキャプチャします：
+
+1. **バグ修正** — 根本原因を特定し、解決策を適用した
+2. **設計判断** — 理由を持って複数の選択肢から一つのアプローチを選んだ
+3. **パターン発見** — 他の場所でも適用できる再利用可能なパターンを見つけた
+4. **トラブルシューティング** — 非自明な診断プロセスを経て問題を解決した
+5. **外部知識** — ドキュメント、記事、Stack Overflowなどから得た知見を適用した
+6. **リファクタリング** — 明確なビフォー・アフターを持つ形で既存コードを改善した
+
+## 使用しないタイミング
+
+- 移転可能な知見を含まない些細な編集（誤字修正、フォーマット変更など）
+- 再利用価値のない、プロジェクト固有の一回限りの変更
+- 重複エントリ：まず \`search_knowledge\` で既存の知識を検索してください
+
+## キャプチャ方法（MCPツール）
+
+\`capture_knowledge\` MCPツールを使用します：
+
+\`\`\`
+capture_knowledge(
+  content: string,   // 完全な説明：問題 + 解決策 + コンテキスト
+  title?: string,    // 短い説明的なタイトル（最大約80文字）
+  tags?: string[],   // 標準タクソノミーから2〜5個のタグ
+  source?: string    // 任意：URL、ファイル名、または参照元
+)
+\`\`\`
+
+## キャプチャ方法（CLIの代替手段）
+
+\`\`\`bash
+knowledgine capture add "<content>" --title "<title>" --tags "<tag1>,<tag2>"
+\`\`\`
+
+## コンテンツフォーマット
+
+各キャプチャは3つのパートで構成します：
+
+1. **問題 / コンテキスト** — この学びのきっかけとなった状況は何か？
+2. **解決策 / 判断** — 何をどのように行ったか？
+3. **理由 / 備考** — なぜこのアプローチを選んだか？どんな代替案を検討したか？
+
+例：
+\`\`\`
+**Problem**: TypeScript threw "Type 'unknown' is not assignable to type 'User'" when
+parsing API response.
+
+**Solution**: Added a type guard function isUser(val: unknown): val is User that checks
+for required fields before narrowing the type.
+
+**Rationale**: Using 'as User' cast was unsafe because the API response structure could
+change. The type guard provides runtime validation and compile-time safety.
+\`\`\`
+
+## ステップバイステップの手順
+
+1. **トリガーを特定する** — 6つのキャプチャイベントのどれが発生したか？
+2. **内容を下書きする** — 問題 + 解決策 + 理由を平文で書く
+3. **タイトルを選ぶ** — 簡潔で検索しやすいもの（動詞か名詞句で始める）
+4. **2〜5個のタグを選ぶ** — 標準タクソノミーを使用する（capture-guide.md参照）
+5. **capture_knowledgeを呼び出す** — content、title、tags、任意のsourceを渡す
+6. **確認する** — ツールが成功レスポンスを返したことを確認する
+
+## ベストプラクティス
+
+- イベント直後に記録する——詳細が新鮮なうちに
+- このセッションのコンテキストを持たない将来の読者を想定して書く
+- 大きなまとめエントリより、一つの知見に集中した記録を優先する
+- エラーメッセージはそのまま含める——最も効果的な検索ワードになる
+- タグは正確に選ぶ：「misc」のような広いタグは発見性を下げる
+
+## 参照ファイル
+
+- 各トリガータイプの詳細ガイドと例は \`capture-guide.md\` を参照
+- 標準タグカテゴリは \`tag-taxonomy.md\` を参照
+- 具体的なキャプチャ例は \`format-examples.md\` を参照
+`;
+//# sourceMappingURL=skill-md.ja.js.map

package/dist/templates/skills/knowledgine-capture/skill-md.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-capture/skill-md.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgGvB,CAAC"}

package/dist/templates/skills/knowledgine-capture/skill-md.js

@@ -1,5 +1,7 @@
 export const SKILL_MD = `---
 name: knowledgine-capture
+version: "1.0.0"
+lang: en
 description: >
   Record knowledge to the local knowledge base after solving problems, making design
   decisions, or discovering reusable patterns. Invoke whenever you have just fixed a bug,
@@ -39,8 +41,8 @@ Use the \`capture_knowledge\` MCP tool:
 \`\`\`
 capture_knowledge(
   content: string,   // Full explanation: problem + solution + context
-  title: string,     // Short descriptive title (max ~80 chars)
-  tags: string[],    // 2–5 tags from the standard taxonomy
+  title?: string,    // Short descriptive title (max ~80 chars)
+  tags?: string[],   // 2–5 tags from the standard taxonomy
   source?: string    // Optional: URL, filename, or reference source
 )
 \`\`\`

package/dist/templates/skills/knowledgine-capture/skill-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-capture/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FvB,CAAC"}
+{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-capture/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiGvB,CAAC"}

package/dist/templates/skills/knowledgine-debrief/references.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const REFERENCES: Record<string, string>;
+//# sourceMappingURL=references.ja.d.ts.map

package/dist/templates/skills/knowledgine-debrief/references.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/references.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4I7C,CAAC"}

package/dist/templates/skills/knowledgine-debrief/references.ja.js

@@ -0,0 +1,141 @@
+export const REFERENCES = {
+    "debrief-template.md": `# デブリーフテンプレート
+
+セッションデブリーフのキャプチャを作成する際は、以下のテンプレートに記入してください。
+該当しないセクションは省略してください。
+
+---
+
+\`\`\`markdown
+## Session Debrief: <YYYY-MM-DD> — <主なトピック>
+
+### 概要
+<セッションの目標と結果を1〜2文で要約>
+
+### 解決した問題
+<!-- 重要な問題それぞれについて、根本原因と解決策を記載 -->
+- **<問題のタイトル>**
+  - Root cause: <原因>
+  - Solution: <対処内容>
+  - Files changed: <ファイルのリスト>
+
+### 行った判断
+<!-- アーキテクチャまたは実装上の判断とその理由を記載 -->
+- **<判断のタイトル>**
+  - Options considered: <A, B, C>
+  - Chosen: <選択肢>
+  - Reason: <理由>
+
+### 発見したパターン
+<!-- このセッションで発見した再利用可能な知見やパターン -->
+- **<パターン名>**: <簡単な説明といつ適用するか>
+
+### 変更したコード
+<!-- 何をなぜ変更したかの概要 -->
+| File | Change | Purpose |
+|------|--------|---------|
+| <path> | <created/modified/deleted> | <理由> |
+
+### 未解決の疑問
+<!-- 将来のセッションに向けた未解決の事項 -->
+- <疑問点または不確実な点>
+- <調査または判断が必要な事項>
+
+### 参照
+<!-- このセッションで参照した外部ソース -->
+- <URLまたはドキュメントタイトル>
+\`\`\`
+
+---
+
+## 使用上の注意
+
+**タイトルフォーマット**："Session Debrief: 2026-03-15 — Entity extraction pipeline fix"
+
+**タグ**：必ず \`debrief\` を含めること。主なトピック領域を追加する：
+- \`debrief\`, \`bug-fix\` — 主にバグ修正のセッション
+- \`debrief\`, \`design-decision\` — 設計が中心のセッション
+- \`debrief\`, \`refactoring\` — リファクタリング中心のセッション
+- \`debrief\`, \`feature\` — 新機能を追加したセッション
+
+**最小限のデブリーフ**：時間が少ない場合は、最低限以下を記録する：
+1. 何をしたか（タスクごとに1文）
+2. 重要な判断または落とし穴
+3. 未解決の疑問
+
+**個別キャプチャ**：重大なバグや判断については、先に個別のキャプチャを作成し
+（knowledgine-captureを使用）、デブリーフのサマリーでそれらを参照してください。
+これにより、個別の知見がデブリーフを通じてだけでなく、タイプ別にも検索可能になります。
+`,
+    "example-output.md": `# デブリーフ出力例
+
+適切に書かれたセッションデブリーフの具体的な例。
+
+---
+
+**タイトル**：Session Debrief: 2026-03-15 — ESM import resolution and sqlite-vec fix
+
+**タグ**：\`debrief\`, \`bug-fix\`
+
+**内容**：
+\`\`\`markdown
+## Session Debrief: 2026-03-15 — ESM import resolution and sqlite-vec fix
+
+### 概要
+Node.js 20へのアップグレードによって発生したビルド時の2つの障害を修正した。
+CLIソースファイルにESMインポートの拡張子が欠落していた問題と、
+sqlite-vecネイティブモジュールが新しいABI向けに再コンパイルが必要だった問題。
+
+### 解決した問題
+
+- **ESMインポートの.js拡張子が欠落**
+  - Root cause: TypeScriptソースが拡張子なしのインポート（例：\`import foo from "./foo"\`）を
+    使用していた。CommonJSでは動作するが、厳格なESMモード（Node 20 + type: "module"）では失敗する。
+  - Solution: packages/cli/src/ と packages/core/src/ のすべての相対インポートに
+    .js拡張子を追加した。tsconfig を moduleResolution: "NodeNext" に更新した。
+  - Files changed: cli と core パッケージにまたがる約40ファイル
+
+- **Node 20での sqlite-vec "invalid ELF header"**
+  - Root cause: ネイティブ .node バイナリが Node 18 ABI（NODE_MODULE_VERSION 108）向けに
+    コンパイルされていた。Node 20 は ABI 115 を使用する。
+  - Solution: \`npm rebuild\` を実行して sqlite-vec を Node 20 向けに再コンパイルした。
+    再発防止のために CI キャッシュキーに ABI バージョンチェックを追加した。
+  - Files changed: ソース変更なし。CIワークフローを更新した。
+
+### 行った判断
+
+- **moduleResolution: NodeNext を恒久的に維持する**
+  - Options: CommonJSに戻す、または NodeNext に更新する
+  - Chosen: NodeNext。ESMはNode.jsが向かっている方向であり、巻き戻すとさらに移行の負債が積み上がる。
+    .js拡張子の要件は一度限りのコストである。
+
+### 発見したパターン
+
+- **Node.jsメジャーアップグレード後の npm rebuild**：ネイティブモジュールを使用するプロジェクトは
+  Node.jsのメジャーバージョンアップグレード後に必ず \`npm rebuild\` を実行する必要がある。
+  アップグレードの手順書にこれを追加すること。
+  関連：個別キャプチャ "sqlite-vec fails after Node.js upgrade" も参照。
+
+### 変更したコード
+
+| File | Change | Purpose |
+|------|--------|---------|
+| packages/cli/src/**/*.ts | modified | すべての相対インポートに .js を追加 |
+| packages/core/src/**/*.ts | modified | すべての相対インポートに .js を追加 |
+| tsconfig.json | modified | moduleResolution: NodeNext |
+| .github/workflows/ci.yml | modified | キャッシュキーに NODE_ABI を追加 |
+
+### 未解決の疑問
+
+- .js拡張子を強制するコードモッドまたはlintルールはあるか？ESLint importプラグインが
+  対応している可能性がある——将来の利用に向けて調査が必要。
+- knowledgine initコマンドがABIの不一致をプロアクティブに検出すべきか？
+
+### 参照
+
+- https://www.typescriptlang.org/docs/handbook/esm-node.html
+- https://nodejs.org/api/esm.html#mandatory-file-extensions
+\`\`\`
+`,
+};
+//# sourceMappingURL=references.ja.js.map

package/dist/templates/skills/knowledgine-debrief/references.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/references.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmExB;IAEC,mBAAmB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEtB;CACA,CAAC"}

package/dist/templates/skills/knowledgine-debrief/skill-md.d.ts

@@ -1,2 +1,2 @@
-export declare const SKILL_MD = "---\nname: knowledgine-debrief\ndescription: >\n  Summarize and record all learnings from the current session at its end. Invoke when\n  the user signals the session is complete, after finishing a major task, or when asked\n  for a session review. Produces a structured knowledge capture covering problems solved,\n  decisions made, patterns found, and open questions.\n---\n# knowledgine-debrief\n\n## Purpose\n\nConsolidate all learnings from the session into the knowledge base before context is\nlost. A debrief transforms the raw events of a session \u2014 bugs fixed, decisions made,\ncode changed \u2014 into durable structured knowledge that future sessions can build on.\n\n## When to Use\n\n- **End of session** \u2014 User says \"done\", \"that's all\", \"let's wrap up\", or similar\n- **After completing a major task** \u2014 Significant feature, complex bug fix, or refactoring\n- **User requests a review** \u2014 \"What did we do today?\", \"Summarize the session\"\n- **Before switching contexts** \u2014 Moving to a completely different area of the codebase\n\n## When NOT to Use\n\n- Mid-session after every small change \u2014 save debrief for meaningful milestones\n- When nothing significant happened (trivial edits only)\n\n## How to Debrief (MCP Tool)\n\nUse `capture_knowledge` to save the session summary:\n\n```\ncapture_knowledge(\n  content: string,    // Full structured debrief using the template\n  title: string,      // \"Session Debrief: <date> \u2014 <main topic>\"\n  tags: string[],     // [\"debrief\", \"<primary-area>\", ...]\n  source?: string     // Optional: session identifier\n)\n```\n\n## Step-by-Step Instructions\n\n1. **Recall the session** \u2014 Review what was worked on (rely on your context window)\n2. **Identify key events** \u2014 Problems solved, decisions made, patterns found\n3. **Draft the debrief** \u2014 Use the structured template from debrief-template.md\n4. **Capture each major learning individually** \u2014 If a bug fix or decision is significant\n   enough to stand alone, capture it separately with the appropriate skill first\n5. **Capture the session summary** \u2014 Save the consolidated debrief note\n6. **Confirm completion** \u2014 Report to the user what was captured\n\n## Debrief Structure\n\nA good debrief contains:\n\n- **Problems Solved** \u2014 What broke and how it was fixed\n- **Decisions Made** \u2014 What was chosen and why\n- **Patterns Found** \u2014 Reusable insights discovered\n- **Code Changed** \u2014 Summary of files modified and purpose\n- **Open Questions** \u2014 Unresolved items for future sessions\n\n## Best Practices\n\n- Write for a future reader with no context from this session\n- Be specific about what changed, not just what was done\n- Open questions are as valuable as answers \u2014 document uncertainty\n- If the session was long, do individual captures for major events before the summary\n\n## Reference Files\n\n- See `debrief-template.md` for the structured template to fill in\n- See `example-output.md` for a concrete example of a well-written debrief\n";
+export declare const SKILL_MD = "---\nname: knowledgine-debrief\nversion: \"1.0.0\"\nlang: en\ndescription: >\n  Summarize and record all learnings from the current session at its end. Invoke when\n  the user signals the session is complete, after finishing a major task, or when asked\n  for a session review. Produces a structured knowledge capture covering problems solved,\n  decisions made, patterns found, and open questions.\n---\n# knowledgine-debrief\n\n## Purpose\n\nConsolidate all learnings from the session into the knowledge base before context is\nlost. A debrief transforms the raw events of a session \u2014 bugs fixed, decisions made,\ncode changed \u2014 into durable structured knowledge that future sessions can build on.\n\n## When to Use\n\n- **End of session** \u2014 User says \"done\", \"that's all\", \"let's wrap up\", or similar\n- **After completing a major task** \u2014 Significant feature, complex bug fix, or refactoring\n- **User requests a review** \u2014 \"What did we do today?\", \"Summarize the session\"\n- **Before switching contexts** \u2014 Moving to a completely different area of the codebase\n\n## When NOT to Use\n\n- Mid-session after every small change \u2014 save debrief for meaningful milestones\n- When nothing significant happened (trivial edits only)\n\n## How to Debrief (MCP Tool)\n\nUse `capture_knowledge` to save the session summary:\n\n```\ncapture_knowledge(\n  content: string,    // Full structured debrief using the template\n  title?: string,     // \"Session Debrief: <date> \u2014 <main topic>\"\n  tags?: string[],    // [\"debrief\", \"<primary-area>\", ...]\n  source?: string     // Optional: session identifier\n)\n```\n\n## How to Debrief (CLI Alternative)\n\n```bash\nknowledgine capture add \"<debrief content>\" --title \"Session Debrief: <date>\" --tags \"debrief,<area>\"\n```\n\n## Step-by-Step Instructions\n\n1. **Recall the session** \u2014 Review what was worked on (rely on your context window)\n2. **Identify key events** \u2014 Problems solved, decisions made, patterns found\n3. **Draft the debrief** \u2014 Use the structured template from debrief-template.md\n4. **Capture each major learning individually** \u2014 If a bug fix or decision is significant\n   enough to stand alone, capture it separately with the appropriate skill first\n5. **Capture the session summary** \u2014 Save the consolidated debrief note\n6. **Confirm completion** \u2014 Report to the user what was captured\n\n## Debrief Structure\n\nA good debrief contains:\n\n- **Problems Solved** \u2014 What broke and how it was fixed\n- **Decisions Made** \u2014 What was chosen and why\n- **Patterns Found** \u2014 Reusable insights discovered\n- **Code Changed** \u2014 Summary of files modified and purpose\n- **Open Questions** \u2014 Unresolved items for future sessions\n\n## Best Practices\n\n- Write for a future reader with no context from this session\n- Be specific about what changed, not just what was done\n- Open questions are as valuable as answers \u2014 document uncertainty\n- If the session was long, do individual captures for major events before the summary\n\n## Reference Files\n\n- See `debrief-template.md` for the structured template to fill in\n- See `example-output.md` for a concrete example of a well-written debrief\n";
 //# sourceMappingURL=skill-md.d.ts.map

package/dist/templates/skills/knowledgine-debrief/skill-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,8gGAwEpB,CAAC"}
+{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,gtGAgFpB,CAAC"}

package/dist/templates/skills/knowledgine-debrief/skill-md.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_MD = "---\nname: knowledgine-debrief\nversion: \"1.0.0\"\nlang: ja\ndescription: >\n  \u30BB\u30C3\u30B7\u30E7\u30F3\u7D42\u4E86\u6642\u306B\u3001\u73FE\u5728\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067\u5F97\u305F\u3059\u3079\u3066\u306E\u5B66\u3073\u3092\u8981\u7D04\u3057\u3066\u8A18\u9332\u3057\u307E\u3059\u3002\n  \u30E6\u30FC\u30B6\u30FC\u304C\u30BB\u30C3\u30B7\u30E7\u30F3\u5B8C\u4E86\u3092\u77E5\u3089\u305B\u305F\u3068\u304D\u3001\u5927\u304D\u306A\u30BF\u30B9\u30AF\u3092\u5B8C\u4E86\u3057\u305F\u5F8C\u3001\u307E\u305F\u306F\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30EC\u30D3\u30E5\u30FC\u3092\n  \u6C42\u3081\u3089\u308C\u305F\u3068\u304D\u306B\u547C\u3073\u51FA\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u89E3\u6C7A\u3057\u305F\u554F\u984C\u3001\u884C\u3063\u305F\u5224\u65AD\u3001\u767A\u898B\u3057\u305F\u30D1\u30BF\u30FC\u30F3\u3001\n  \u672A\u89E3\u6C7A\u306E\u7591\u554F\u3092\u7DB2\u7F85\u3059\u308B\u69CB\u9020\u5316\u3055\u308C\u305F\u77E5\u8B58\u30AD\u30E3\u30D7\u30C1\u30E3\u3092\u751F\u6210\u3057\u307E\u3059\u3002\n---\n# knowledgine-debrief\n\n## \u76EE\u7684\n\n\u30BB\u30C3\u30B7\u30E7\u30F3\u3067\u5F97\u305F\u3059\u3079\u3066\u306E\u5B66\u3073\u3092\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304C\u5931\u308F\u308C\u308B\u524D\u306B\u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u3078\u96C6\u7D04\u3057\u307E\u3059\u3002\n\u30C7\u30D6\u30EA\u30FC\u30D5\u306F\u3001\u30D0\u30B0\u4FEE\u6B63\u30FB\u5224\u65AD\u30FB\u30B3\u30FC\u30C9\u5909\u66F4\u3068\u3044\u3063\u305F\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u751F\u306E\u51FA\u6765\u4E8B\u3092\u3001\n\u5C06\u6765\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u304C\u7A4D\u307F\u4E0A\u3052\u3089\u308C\u308B\u8010\u4E45\u6027\u306E\u3042\u308B\u69CB\u9020\u5316\u3055\u308C\u305F\u77E5\u8B58\u3078\u3068\u5909\u63DB\u3057\u307E\u3059\u3002\n\n## \u4F7F\u7528\u3059\u308B\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- **\u30BB\u30C3\u30B7\u30E7\u30F3\u7D42\u4E86\u6642** \u2014 \u30E6\u30FC\u30B6\u30FC\u304C\u300C\u5B8C\u4E86\u300D\u300C\u4EE5\u4E0A\u3067\u3059\u300D\u300C\u307E\u3068\u3081\u307E\u3057\u3087\u3046\u300D\u306A\u3069\u3068\u8A00\u3063\u305F\u3068\u304D\n- **\u5927\u304D\u306A\u30BF\u30B9\u30AF\u5B8C\u4E86\u5F8C** \u2014 \u91CD\u8981\u306A\u6A5F\u80FD\u3001\u8907\u96D1\u306A\u30D0\u30B0\u4FEE\u6B63\u3001\u307E\u305F\u306F\u30EA\u30D5\u30A1\u30AF\u30BF\u30EA\u30F3\u30B0\u306E\u5F8C\n- **\u30E6\u30FC\u30B6\u30FC\u304C\u30EC\u30D3\u30E5\u30FC\u3092\u6C42\u3081\u305F\u3068\u304D** \u2014 \u300C\u4ECA\u65E5\u4F55\u3092\u3057\u307E\u3057\u305F\u304B\uFF1F\u300D\u300C\u30BB\u30C3\u30B7\u30E7\u30F3\u3092\u307E\u3068\u3081\u3066\u300D\n- **\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u5207\u308A\u66FF\u3048\u524D** \u2014 \u30B3\u30FC\u30C9\u30D9\u30FC\u30B9\u306E\u307E\u3063\u305F\u304F\u5225\u306E\u9818\u57DF\u306B\u79FB\u308B\u524D\n\n## \u4F7F\u7528\u3057\u306A\u3044\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- \u5C0F\u3055\u306A\u5909\u66F4\u3054\u3068\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u4E2D\u76E4\u2014\u2014\u30C7\u30D6\u30EA\u30FC\u30D5\u306F\u610F\u5473\u306E\u3042\u308B\u7BC0\u76EE\u306B\u884C\u3046\n- \u91CD\u8981\u306A\u3053\u3068\u304C\u4F55\u3082\u8D77\u304D\u306A\u304B\u3063\u305F\u3068\u304D\uFF08\u4E9B\u7D30\u306A\u7DE8\u96C6\u306E\u307F\uFF09\n\n## \u30C7\u30D6\u30EA\u30FC\u30D5\u65B9\u6CD5\uFF08MCP\u30C4\u30FC\u30EB\uFF09\n\n`capture_knowledge` \u3092\u4F7F\u3063\u3066\u30BB\u30C3\u30B7\u30E7\u30F3\u30B5\u30DE\u30EA\u30FC\u3092\u4FDD\u5B58\u3057\u307E\u3059\uFF1A\n\n```\ncapture_knowledge(\n  content: string,    // \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u3092\u4F7F\u3063\u305F\u5B8C\u5168\u306A\u69CB\u9020\u5316\u30C7\u30D6\u30EA\u30FC\u30D5\n  title?: string,     // \"Session Debrief: <date> \u2014 <main topic>\"\n  tags?: string[],    // [\"debrief\", \"<primary-area>\", ...]\n  source?: string     // \u4EFB\u610F\uFF1A\u30BB\u30C3\u30B7\u30E7\u30F3\u8B58\u5225\u5B50\n)\n```\n\n## \u30C7\u30D6\u30EA\u30FC\u30D5\u65B9\u6CD5\uFF08CLI\u306E\u4EE3\u66FF\u624B\u6BB5\uFF09\n\n```bash\nknowledgine capture add \"<debrief content>\" --title \"Session Debrief: <date>\" --tags \"debrief,<area>\"\n```\n\n## \u30B9\u30C6\u30C3\u30D7\u30D0\u30A4\u30B9\u30C6\u30C3\u30D7\u306E\u624B\u9806\n\n1. **\u30BB\u30C3\u30B7\u30E7\u30F3\u3092\u632F\u308A\u8FD4\u308B** \u2014 \u4F55\u306B\u53D6\u308A\u7D44\u3093\u3060\u304B\u3092\u78BA\u8A8D\u3059\u308B\uFF08\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u30A6\u30A3\u30F3\u30C9\u30A6\u306B\u4F9D\u62E0\uFF09\n2. **\u91CD\u8981\u306A\u30A4\u30D9\u30F3\u30C8\u3092\u7279\u5B9A\u3059\u308B** \u2014 \u89E3\u6C7A\u3057\u305F\u554F\u984C\u3001\u884C\u3063\u305F\u5224\u65AD\u3001\u767A\u898B\u3057\u305F\u30D1\u30BF\u30FC\u30F3\n3. **\u30C7\u30D6\u30EA\u30FC\u30D5\u3092\u4E0B\u66F8\u304D\u3059\u308B** \u2014 debrief-template.md \u306E\u69CB\u9020\u5316\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u3092\u4F7F\u7528\n4. **\u4E3B\u8981\u306A\u5B66\u3073\u3092\u500B\u5225\u306B\u30AD\u30E3\u30D7\u30C1\u30E3\u3059\u308B** \u2014 \u30D0\u30B0\u4FEE\u6B63\u3084\u5224\u65AD\u304C\u5358\u72EC\u3067\u6210\u7ACB\u3059\u308B\u307B\u3069\u91CD\u8981\u3067\u3042\u308C\u3070\u3001\n   \u5148\u306B\u9069\u5207\u306A\u30B9\u30AD\u30EB\u3067\u500B\u5225\u306B\u30AD\u30E3\u30D7\u30C1\u30E3\u3059\u308B\n5. **\u30BB\u30C3\u30B7\u30E7\u30F3\u30B5\u30DE\u30EA\u30FC\u3092\u30AD\u30E3\u30D7\u30C1\u30E3\u3059\u308B** \u2014 \u307E\u3068\u3081\u305F\u30C7\u30D6\u30EA\u30FC\u30D5\u30CE\u30FC\u30C8\u3092\u4FDD\u5B58\u3059\u308B\n6. **\u5B8C\u4E86\u3092\u78BA\u8A8D\u3059\u308B** \u2014 \u4F55\u3092\u30AD\u30E3\u30D7\u30C1\u30E3\u3057\u305F\u304B\u3092\u30E6\u30FC\u30B6\u30FC\u306B\u5831\u544A\u3059\u308B\n\n## \u30C7\u30D6\u30EA\u30FC\u30D5\u306E\u69CB\u6210\n\n\u512A\u308C\u305F\u30C7\u30D6\u30EA\u30FC\u30D5\u306B\u542B\u307E\u308C\u308B\u5185\u5BB9\uFF1A\n\n- **\u89E3\u6C7A\u3057\u305F\u554F\u984C** \u2014 \u4F55\u304C\u58CA\u308C\u3066\u3044\u3066\u3001\u3069\u3046\u4FEE\u6B63\u3057\u305F\u304B\n- **\u884C\u3063\u305F\u5224\u65AD** \u2014 \u4F55\u3092\u9078\u3073\u3001\u306A\u305C\u304B\n- **\u767A\u898B\u3057\u305F\u30D1\u30BF\u30FC\u30F3** \u2014 \u767A\u898B\u3057\u305F\u518D\u5229\u7528\u53EF\u80FD\u306A\u77E5\u898B\n- **\u5909\u66F4\u3057\u305F\u30B3\u30FC\u30C9** \u2014 \u5909\u66F4\u3057\u305F\u30D5\u30A1\u30A4\u30EB\u306E\u6982\u8981\u3068\u76EE\u7684\n- **\u672A\u89E3\u6C7A\u306E\u7591\u554F** \u2014 \u5C06\u6765\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306B\u5411\u3051\u305F\u672A\u89E3\u6C7A\u306E\u4E8B\u9805\n\n## \u30D9\u30B9\u30C8\u30D7\u30E9\u30AF\u30C6\u30A3\u30B9\n\n- \u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u3092\u6301\u305F\u306A\u3044\u5C06\u6765\u306E\u8AAD\u8005\u3092\u60F3\u5B9A\u3057\u3066\u66F8\u304F\n- \u4F55\u3092\u3057\u305F\u304B\u3060\u3051\u3067\u306A\u304F\u3001\u4F55\u304C\u5909\u308F\u3063\u305F\u304B\u3092\u5177\u4F53\u7684\u306B\u66F8\u304F\n- \u672A\u89E3\u6C7A\u306E\u7591\u554F\u306F\u7B54\u3048\u3068\u540C\u3058\u304F\u3089\u3044\u4FA1\u5024\u304C\u3042\u308B\u2014\u2014\u4E0D\u78BA\u5B9F\u6027\u3092\u8A18\u9332\u3059\u308B\n- \u30BB\u30C3\u30B7\u30E7\u30F3\u304C\u9577\u304B\u3063\u305F\u5834\u5408\u306F\u3001\u30B5\u30DE\u30EA\u30FC\u306E\u524D\u306B\u4E3B\u8981\u306A\u30A4\u30D9\u30F3\u30C8\u3092\u500B\u5225\u306B\u30AD\u30E3\u30D7\u30C1\u30E3\u3059\u308B\n\n## \u53C2\u7167\u30D5\u30A1\u30A4\u30EB\n\n- \u30BB\u30C3\u30B7\u30E7\u30F3\u30C7\u30D6\u30EA\u30FC\u30D5\u306E\u69CB\u9020\u5316\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u306F `debrief-template.md` \u3092\u53C2\u7167\n- \u9069\u5207\u306B\u66F8\u304B\u308C\u305F\u30C7\u30D6\u30EA\u30FC\u30D5\u306E\u5177\u4F53\u7684\u306A\u4F8B\u306F `example-output.md` \u3092\u53C2\u7167\n";
+//# sourceMappingURL=skill-md.ja.d.ts.map

package/dist/templates/skills/knowledgine-debrief/skill-md.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,48OAgFpB,CAAC"}

package/dist/templates/skills/knowledgine-debrief/skill-md.ja.js

@@ -0,0 +1,82 @@
+export const SKILL_MD = `---
+name: knowledgine-debrief
+version: "1.0.0"
+lang: ja
+description: >
+  セッション終了時に、現在のセッションで得たすべての学びを要約して記録します。
+  ユーザーがセッション完了を知らせたとき、大きなタスクを完了した後、またはセッションのレビューを
+  求められたときに呼び出してください。解決した問題、行った判断、発見したパターン、
+  未解決の疑問を網羅する構造化された知識キャプチャを生成します。
+---
+# knowledgine-debrief
+
+## 目的
+
+セッションで得たすべての学びをコンテキストが失われる前にナレッジベースへ集約します。
+デブリーフは、バグ修正・判断・コード変更といったセッションの生の出来事を、
+将来のセッションが積み上げられる耐久性のある構造化された知識へと変換します。
+
+## 使用するタイミング
+
+- **セッション終了時** — ユーザーが「完了」「以上です」「まとめましょう」などと言ったとき
+- **大きなタスク完了後** — 重要な機能、複雑なバグ修正、またはリファクタリングの後
+- **ユーザーがレビューを求めたとき** — 「今日何をしましたか？」「セッションをまとめて」
+- **コンテキスト切り替え前** — コードベースのまったく別の領域に移る前
+
+## 使用しないタイミング
+
+- 小さな変更ごとのセッション中盤——デブリーフは意味のある節目に行う
+- 重要なことが何も起きなかったとき（些細な編集のみ）
+
+## デブリーフ方法（MCPツール）
+
+\`capture_knowledge\` を使ってセッションサマリーを保存します：
+
+\`\`\`
+capture_knowledge(
+  content: string,    // テンプレートを使った完全な構造化デブリーフ
+  title?: string,     // "Session Debrief: <date> — <main topic>"
+  tags?: string[],    // ["debrief", "<primary-area>", ...]
+  source?: string     // 任意：セッション識別子
+)
+\`\`\`
+
+## デブリーフ方法（CLIの代替手段）
+
+\`\`\`bash
+knowledgine capture add "<debrief content>" --title "Session Debrief: <date>" --tags "debrief,<area>"
+\`\`\`
+
+## ステップバイステップの手順
+
+1. **セッションを振り返る** — 何に取り組んだかを確認する（コンテキストウィンドウに依拠）
+2. **重要なイベントを特定する** — 解決した問題、行った判断、発見したパターン
+3. **デブリーフを下書きする** — debrief-template.md の構造化テンプレートを使用
+4. **主要な学びを個別にキャプチャする** — バグ修正や判断が単独で成立するほど重要であれば、
+   先に適切なスキルで個別にキャプチャする
+5. **セッションサマリーをキャプチャする** — まとめたデブリーフノートを保存する
+6. **完了を確認する** — 何をキャプチャしたかをユーザーに報告する
+
+## デブリーフの構成
+
+優れたデブリーフに含まれる内容：
+
+- **解決した問題** — 何が壊れていて、どう修正したか
+- **行った判断** — 何を選び、なぜか
+- **発見したパターン** — 発見した再利用可能な知見
+- **変更したコード** — 変更したファイルの概要と目的
+- **未解決の疑問** — 将来のセッションに向けた未解決の事項
+
+## ベストプラクティス
+
+- このセッションのコンテキストを持たない将来の読者を想定して書く
+- 何をしたかだけでなく、何が変わったかを具体的に書く
+- 未解決の疑問は答えと同じくらい価値がある——不確実性を記録する
+- セッションが長かった場合は、サマリーの前に主要なイベントを個別にキャプチャする
+
+## 参照ファイル
+
+- セッションデブリーフの構造化テンプレートは \`debrief-template.md\` を参照
+- 適切に書かれたデブリーフの具体的な例は \`example-output.md\` を参照
+`;
+//# sourceMappingURL=skill-md.ja.js.map

package/dist/templates/skills/knowledgine-debrief/skill-md.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFvB,CAAC"}

package/dist/templates/skills/knowledgine-debrief/skill-md.js

@@ -1,5 +1,7 @@
 export const SKILL_MD = `---
 name: knowledgine-debrief
+version: "1.0.0"
+lang: en
 description: >
   Summarize and record all learnings from the current session at its end. Invoke when
   the user signals the session is complete, after finishing a major task, or when asked
@@ -33,12 +35,18 @@ Use \`capture_knowledge\` to save the session summary:
 \`\`\`
 capture_knowledge(
   content: string,    // Full structured debrief using the template
-  title: string,      // "Session Debrief: <date> — <main topic>"
-  tags: string[],     // ["debrief", "<primary-area>", ...]
+  title?: string,     // "Session Debrief: <date> — <main topic>"
+  tags?: string[],    // ["debrief", "<primary-area>", ...]
   source?: string     // Optional: session identifier
 )
 \`\`\`
 
+## How to Debrief (CLI Alternative)
+
+\`\`\`bash
+knowledgine capture add "<debrief content>" --title "Session Debrief: <date>" --tags "debrief,<area>"
+\`\`\`
+
 ## Step-by-Step Instructions
 
 1. **Recall the session** — Review what was worked on (rely on your context window)

package/dist/templates/skills/knowledgine-debrief/skill-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEvB,CAAC"}
+{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-debrief/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFvB,CAAC"}

package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/references.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explain/references.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsL7C,CAAC"}
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/references.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsL7C,CAAC"}

package/dist/templates/skills/knowledgine-explore/references.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const REFERENCES: Record<string, string>;
+//# sourceMappingURL=references.ja.d.ts.map

package/dist/templates/skills/knowledgine-explore/references.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/references.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqL7C,CAAC"}