autosnippet 2.13.0 → 2.14.0

package/README.md

@@ -240,7 +240,7 @@ asd install:vscode-copilot      # 配置 MCP 和 Copilot 指令
 
 ## MCP 工具一览
 
-38 个 MCP 工具按功能分组（省略了 **autosnippet_** 前缀）：
+39 个 MCP 工具按功能分组（省略了 **autosnippet_** 前缀）：
 
 | 分类 | 工具 |
 |------|------|
@@ -248,6 +248,7 @@ asd install:vscode-copilot      # 配置 MCP 和 Copilot 指令
 | **搜索** | `search`（统合入口）、`context_search`（4 层漏斗）、`keyword_search`、`semantic_search` |
 | **Recipe 浏览** | `list_recipes`、`get_recipe`、`list_rules`、`patterns`、`list_facts`、`recipe_insights`、`confirm_usage` |
 | **候选管理** | `validate_candidate`、`check_duplicate`、`submit_knowledge`、`submit_knowledge_batch`、`enrich_candidates` |
+| **开发文档** | `save_document` |
 | **知识图谱** | `graph_query`、`graph_impact`、`graph_path`、`graph_stats` |
 | **项目结构** | `get_targets`、`get_target_files`、`get_target_metadata` |
 | **Guard** | `guard_check`、`guard_audit_files`、`scan_project` |

package/bin/cli.js

@@ -658,6 +658,7 @@ program
       console.log(`   Channel A (Always-On Rules): ${result.channelA.rulesCount} 条规则 (${result.channelA.tokensUsed} tokens)`);
       console.log(`   Channel B (Smart Rules):     ${result.channelB.topicCount} 个主题, ${result.channelB.patternsCount} 个模式 (${result.channelB.totalTokens} tokens)`);
       console.log(`   Channel C (Agent Skills):    ${result.channelC.synced} 个 Skills 已同步`);
+      console.log(`   Channel D (Dev Documents):   ${result.channelD?.documentsCount || 0} 篇文档`);
       if (result.channelC.errors > 0) {
         console.log(`   ⚠️  ${result.channelC.errors} 个错误`);
       }

package/lib/cli/UpgradeService.js

@@ -181,7 +181,8 @@ export class UpgradeService {
           pipeline.deliver()
             .then(result => {
               console.log(`   ✅ Cursor Delivery: ${result.channelA.rulesCount} rules, ` +
-                `${result.channelB.topicCount} topics, ${result.channelC.synced} skills`);
+                `${result.channelB.topicCount} topics, ${result.channelC.synced} skills, ` +
+                `${result.channelD?.documentsCount || 0} documents`);
             })
             .catch(err => {
               console.log(`   ⚠️  Cursor Delivery 跳过: ${err.message}`);

package/lib/domain/knowledge/Lifecycle.js

@@ -85,6 +85,7 @@ const KIND_MAP = {
   'call-chain':          'fact',
   'data-flow':           'fact',
   'module-dependency':   'fact',
+  'dev-document':        'fact',
 };
 
 /**

package/lib/external/mcp/McpServer.js

@@ -163,6 +163,7 @@ export class McpServer {
       case 'autosnippet_submit_knowledge':        return knowledgeHandlers.submitKnowledge(ctx, args);
       case 'autosnippet_submit_knowledge_batch':  return knowledgeHandlers.submitKnowledgeBatch(ctx, args);
       case 'autosnippet_knowledge_lifecycle':      return knowledgeHandlers.knowledgeLifecycle(ctx, args);
+      case 'autosnippet_save_document':            return knowledgeHandlers.saveDocument(ctx, args);
       default: throw new Error(`Unknown tool: ${name}`);
     }
   }

package/lib/external/mcp/handlers/bootstrap/pipeline/orchestrator.js

@@ -1108,7 +1108,8 @@ export async function fillDimensionsV3(fillContext) {
       logger.info(`[Bootstrap-v3] 🚀 Cursor Delivery complete — ` +
         `A: ${deliveryResult.channelA.rulesCount} rules, ` +
         `B: ${deliveryResult.channelB.topicCount} topics, ` +
-        `C: ${deliveryResult.channelC.synced} skills`);
+        `C: ${deliveryResult.channelC.synced} skills, ` +
+        `D: ${deliveryResult.channelD?.documentsCount || 0} documents`);
     }
   } catch (deliveryErr) {
     logger.warn(`[Bootstrap-v3] Cursor Delivery failed (non-blocking): ${deliveryErr.message}`);

package/lib/external/mcp/handlers/knowledge.js

@@ -237,6 +237,80 @@ export async function knowledgeLifecycle(ctx, args) {
 
 // ─── 内部辅助 ──────────────────────────────────────────────
 
+/**
+ * 保存开发文档 (autosnippet_save_document)
+ *
+ * 精简入口：仅需 title + markdown。
+ * 自动设置 knowledgeType='dev-document', kind='fact', source='agent'。
+ * 不走 RecipeReadiness 检查（文档无需 doClause/trigger）。
+ * 支持 autoApprove — 文档直接进入 active 状态。
+ */
+export async function saveDocument(ctx, args) {
+  if (!args.title || !args.title.trim()) {
+    throw new Error('title 必填');
+  }
+  if (!args.markdown || !args.markdown.trim()) {
+    throw new Error('markdown 必填');
+  }
+
+  // 限流
+  const blocked = await _checkRateLimit('autosnippet_save_document', args.client_id);
+  if (blocked) return blocked;
+
+  const service = ctx.container.get('knowledgeService');
+
+  const data = {
+    title:         args.title.trim(),
+    description:   args.description || '',
+    knowledgeType: 'dev-document',
+    kind:          'fact',
+    source:        args.source || 'agent',
+    scope:         args.scope || 'project-specific',
+    tags:          args.tags || [],
+    content: {
+      markdown: args.markdown,
+      pattern:  '',
+    },
+    // 文档不需要 Cursor Delivery 字段
+    trigger:    '',
+    doClause:   '',
+    dontClause: '',
+    whenClause: '',
+    topicHint:  '',
+    coreCode:   '',
+    // 基础推理
+    reasoning: {
+      whyStandard: 'Agent development document — preserved for team knowledge',
+      sources:     ['agent'],
+      confidence:  0.8,
+    },
+  };
+
+  const entry = await service.create(data, { userId: 'mcp' });
+
+  // 自动发布（dev-document 不需要人工审核）
+  try {
+    await service.publish(entry.id, { userId: 'mcp' });
+  } catch {
+    // 发布失败保持 pending — 非阻塞
+  }
+
+  return envelope({
+    success: true,
+    data: {
+      id:        entry.id,
+      lifecycle: 'active',
+      title:     entry.title,
+      kind:      'fact',
+      knowledgeType: 'dev-document',
+    },
+    message: `文档「${entry.title}」已保存到知识库。`,
+    meta: { tool: 'autosnippet_save_document' },
+  });
+}
+
+// ─── 内部辅助 ──────────────────────────────────────────────
+
 /**
  * V3 wire format → RecipeReadinessChecker 兼容格式
  */

package/lib/external/mcp/tools.js

@@ -23,6 +23,7 @@ export const TOOL_GATEWAY_MAP = {
   autosnippet_submit_knowledge: { action: 'knowledge:create', resource: 'knowledge' },
   autosnippet_submit_knowledge_batch: { action: 'knowledge:create', resource: 'knowledge' },
   autosnippet_knowledge_lifecycle: { action: 'knowledge:update', resource: 'knowledge' },
+  autosnippet_save_document: { action: 'knowledge:create', resource: 'knowledge' },
 };
 
 export const TOOLS = [
@@ -751,4 +752,26 @@ export const TOOLS = [
       required: ['id', 'action'],
     },
   },
+  // 39. 保存开发文档
+  {
+    name: 'autosnippet_save_document',
+    description:
+      '保存开发文档到知识库（架构设计、排查报告、决策记录、调研笔记等）。\n' +
+      '仅需 title + markdown，无需填写 kind/doClause/trigger 等 Cursor Delivery 字段。\n' +
+      '文档自动以 dev-document 类型存储，不参与 Cursor Rules 压缩，保持原文完整性。\n' +
+      '交付路径: Channel D → .cursor/skills/autosnippet-devdocs/references/*.md。\n' +
+      'Agent 可通过 autosnippet_search 全文检索已保存的文档。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        title:       { type: 'string', description: '文档标题（中英文皆可）' },
+        markdown:    { type: 'string', description: '文档 Markdown 全文' },
+        description: { type: 'string', description: '一句话摘要（可选）' },
+        tags:        { type: 'array', items: { type: 'string' }, description: '标签列表，如 ["adr", "debug-report", "design-doc", "research"]' },
+        scope:       { type: 'string', enum: ['universal', 'project-specific'], default: 'project-specific', description: '适用范围' },
+        source:      { type: 'string', description: '来源标识（默认 agent）' },
+      },
+      required: ['title', 'markdown'],
+    },
+  },
 ];

package/lib/service/chat/tools.js

@@ -1844,6 +1844,68 @@ const submitCandidate = {
   },
 };
 
+// ────────────────────────────────────────────────────────────
+// 16b. save_document — 保存开发文档到知识库
+// ────────────────────────────────────────────────────────────
+const saveDocument = {
+  name: 'save_document',
+  description: '保存开发文档到知识库（架构设计、排查报告、决策记录、调研笔记等）。仅需 title + markdown，无需 Cursor Delivery 字段。文档自动发布，可通过 autosnippet_search 检索。',
+  parameters: {
+    type: 'object',
+    properties: {
+      title:       { type: 'string', description: '文档标题' },
+      markdown:    { type: 'string', description: '文档 Markdown 全文' },
+      description: { type: 'string', description: '一句话摘要（可选）' },
+      tags:        { type: 'array', items: { type: 'string' }, description: '标签: adr, debug-report, design-doc, research, performance 等' },
+      scope:       { type: 'string', enum: ['universal', 'project-specific'], description: '适用范围（默认 project-specific）' },
+    },
+    required: ['title', 'markdown'],
+  },
+  handler: async (params, ctx) => {
+    const knowledgeService = ctx.container.get('knowledgeService');
+
+    const data = {
+      title:         params.title.trim(),
+      description:   params.description || '',
+      knowledgeType: 'dev-document',
+      kind:          'fact',
+      source:        'agent',
+      scope:         params.scope || 'project-specific',
+      tags:          params.tags || [],
+      content: {
+        markdown: params.markdown,
+        pattern:  '',
+      },
+      trigger:    '',
+      doClause:   '',
+      dontClause: '',
+      whenClause: '',
+      topicHint:  '',
+      coreCode:   '',
+      reasoning: {
+        whyStandard: 'Agent development document',
+        sources:     ['agent'],
+        confidence:  0.8,
+      },
+    };
+
+    const saved = await knowledgeService.create(data, { userId: 'agent' });
+
+    // 自动发布（文档不需要人工审核）
+    try {
+      await knowledgeService.publish(saved.id, { userId: 'agent' });
+    } catch { /* best effort */ }
+
+    return {
+      id:            saved.id,
+      title:         saved.title,
+      lifecycle:     'active',
+      knowledgeType: 'dev-document',
+      message:       `文档「${saved.title}」已保存到知识库`,
+    };
+  },
+};
+
 // ────────────────────────────────────────────────────────────
 // 17. approve_candidate
 // ────────────────────────────────────────────────────────────
@@ -3273,6 +3335,7 @@ export const ALL_TOOLS = [
   generateGuardRule,
   // 生命周期操作类 (7)
   submitCandidate,
+  saveDocument,
   approveCandidate,
   rejectCandidate,
   publishRecipe,

package/lib/service/cursor/CursorDeliveryPipeline.js

@@ -16,6 +16,7 @@ import { RulesGenerator } from './RulesGenerator.js';
 import { SkillsSyncer } from './SkillsSyncer.js';
 import { estimateTokens, BUDGET } from './TokenBudget.js';
 import path from 'node:path';
+import fs from 'node:fs';
 
 export class CursorDeliveryPipeline {
   /**
@@ -48,6 +49,7 @@ export class CursorDeliveryPipeline {
       channelA: { rulesCount: 0, tokensUsed: 0 },
       channelB: { topicCount: 0, patternsCount: 0, totalTokens: 0 },
       channelC: { synced: 0, skipped: 0, errors: 0 },
+      channelD: { documentsCount: 0, filesWritten: 0 },
       totalTokensUsed: 0,
       duration: 0,
     };
@@ -57,9 +59,9 @@ export class CursorDeliveryPipeline {
       const entries = await this._loadEntries();
       this.logger.info?.(`[CursorDelivery] Loaded ${entries.length} knowledge entries`);
 
-      // 2. 分类：rules vs patterns vs facts
-      const { rules, patterns } = this._classify(entries);
-      this.logger.info?.(`[CursorDelivery] Classified: ${rules.length} rules, ${patterns.length} patterns`);
+      // 2. 分类：rules vs patterns vs facts vs documents
+      const { rules, patterns, documents } = this._classify(entries);
+      this.logger.info?.(`[CursorDelivery] Classified: ${rules.length} rules, ${patterns.length} patterns, ${documents.length} documents`);
 
       // 3. 清理旧的动态生成文件
       this.rulesGenerator.cleanDynamicFiles();
@@ -76,6 +78,10 @@ export class CursorDeliveryPipeline {
       const channelC = await this._generateChannelC();
       stats.channelC = channelC;
 
+      // ── Channel D: Dev Documents → references ──
+      const channelD = this._generateChannelD(documents);
+      stats.channelD = channelD;
+
       // 统计
       stats.totalTokensUsed = channelA.tokensUsed + channelB.totalTokens;
       stats.duration = Date.now() - startTime;
@@ -83,9 +89,10 @@ export class CursorDeliveryPipeline {
       this.logger.info?.(`[CursorDelivery] Done in ${stats.duration}ms — ` +
         `A: ${channelA.rulesCount} rules (${channelA.tokensUsed} tokens), ` +
         `B: ${channelB.topicCount} topics (${channelB.totalTokens} tokens), ` +
-        `C: ${channelC.synced} skills synced`);
+        `C: ${channelC.synced} skills synced, ` +
+        `D: ${channelD.documentsCount} documents`);
 
-      return { channelA, channelB, channelC, stats };
+      return { channelA, channelB, channelC, channelD, stats };
     } catch (error) {
       this.logger.error?.(`[CursorDelivery] Error: ${error.message}`);
       throw error;
@@ -146,16 +153,23 @@ export class CursorDeliveryPipeline {
 
   /**
    * 按 kind 分类知识条目
+   * dev-document 类型单独分流，不进入 Channel A/B 压缩
    * @private
    */
   _classify(entries) {
-    const rules = [], patterns = [], facts = [];
+    const rules = [], patterns = [], facts = [], documents = [];
     for (const entry of entries) {
-      if (entry.kind === 'rule') rules.push(entry);
-      else if (entry.kind === 'fact') facts.push(entry);
-      else patterns.push(entry);  // 无 kind 或 kind='pattern' → pattern
+      if (entry.knowledgeType === 'dev-document') {
+        documents.push(entry);
+      } else if (entry.kind === 'rule') {
+        rules.push(entry);
+      } else if (entry.kind === 'fact') {
+        facts.push(entry);
+      } else {
+        patterns.push(entry);  // 无 kind 或 kind='pattern' → pattern
+      }
     }
-    return { rules, patterns, facts };
+    return { rules, patterns, facts, documents };
   }
 
   /**
@@ -267,6 +281,98 @@ export class CursorDeliveryPipeline {
     }
   }
 
+  /**
+   * Channel D — Dev Documents 生成
+   * 将 knowledgeType='dev-document' 的条目以原始 MD 写入
+   * .cursor/skills/autosnippet-devdocs/references/ 目录
+   * @private
+   */
+  _generateChannelD(documents) {
+    const result = { documentsCount: 0, filesWritten: 0, filePaths: [] };
+    if (!documents || documents.length === 0) {
+      return result;
+    }
+
+    const devdocsDir = path.join(this.projectRoot, '.cursor', 'skills', 'autosnippet-devdocs');
+    const refsDir = path.join(devdocsDir, 'references');
+    fs.mkdirSync(refsDir, { recursive: true });
+
+    // 生成 SKILL.md（索引页）
+    const skillLines = [
+      '---',
+      'name: autosnippet-devdocs',
+      `description: "Development documents and knowledge artifacts for ${this.projectName}. Use when looking up architecture decisions, debug reports, design docs, or analysis notes."`,
+      '---',
+      '',
+      `# Dev Documents — ${this.projectName}`,
+      '',
+      'Use this skill when:',
+      '- Looking up architecture decisions or design rationale',
+      '- Reviewing debug reports or performance analysis',
+      '- Finding previous research or investigation notes',
+      '- Understanding project-specific decisions and trade-offs',
+      '',
+      '## Document Index',
+      '',
+      '| Title | Tags | Updated |',
+      '|-------|------|---------|',
+    ];
+
+    for (const doc of documents) {
+      const tags = (doc.tags || []).join(', ') || '-';
+      const updated = doc.updatedAt
+        ? new Date(doc.updatedAt * 1000).toISOString().split('T')[0]
+        : '-';
+      const slug = this._slugify(doc.title || doc.id);
+      skillLines.push(`| [${doc.title}](references/${slug}.md) | ${tags} | ${updated} |`);
+
+      // 写入单个文档 MD
+      const markdown = doc.content?.markdown || doc.description || '';
+      const docContent = [
+        `# ${doc.title || 'Untitled'}`,
+        '',
+        doc.description ? `> ${doc.description}` : '',
+        '',
+        `**Tags:** ${tags}  `,
+        `**Scope:** ${doc.scope || 'universal'}  `,
+        `**Created:** ${doc.createdAt ? new Date(doc.createdAt * 1000).toISOString().split('T')[0] : '-'}`,
+        '',
+        '---',
+        '',
+        markdown,
+      ].filter(Boolean).join('\n');
+
+      const docPath = path.join(refsDir, `${slug}.md`);
+      fs.writeFileSync(docPath, docContent, 'utf8');
+      result.filePaths.push(docPath);
+      result.filesWritten++;
+    }
+
+    skillLines.push('');
+    skillLines.push('## Deeper Knowledge');
+    skillLines.push('');
+    skillLines.push('For full-text search across all documents:');
+    skillLines.push('- `autosnippet_search("your query")`');
+
+    fs.writeFileSync(path.join(devdocsDir, 'SKILL.md'), skillLines.join('\n') + '\n', 'utf8');
+    result.documentsCount = documents.length;
+
+    this.logger.info?.(`[CursorDelivery] Channel D: ${result.documentsCount} documents → ${refsDir}`);
+    return result;
+  }
+
+  /**
+   * 文件名安全 slug 化
+   * @private
+   */
+  _slugify(text) {
+    return text
+      .toLowerCase()
+      .replace(/[^a-z0-9\u4e00-\u9fff]+/g, '-')
+      .replace(/^-+|-+$/g, '')
+      .substring(0, 80) || 'untitled';
+  }
+
   /**
    * 从项目路径推断项目名称
    * @private

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "description": "AutoSnippet - 连接开发者、AI 与项目知识库的工具",
   "type": "module",
   "main": "lib/bootstrap.js",

package/skills/autosnippet-candidates/SKILL.md

@@ -82,7 +82,7 @@ Every candidate submitted via `submit_candidate` or `submit_candidates` supports
 | Field | Type | Values / Example |
 |-------|------|-----------------|
 | **category** | string | View / Service / Tool / Model / Network / Storage / UI / Utility |
-| **knowledgeType** | string | `code-pattern` \| `architecture` \| `best-practice` \| `code-standard` \| `code-relation` \| `inheritance` \| `call-chain` \| `data-flow` \| `module-dependency` \| `boundary-constraint` \| `code-style` \| `solution` |
+| **knowledgeType** | string | `code-pattern` \| `architecture` \| `best-practice` \| `code-standard` \| `code-relation` \| `inheritance` \| `call-chain` \| `data-flow` \| `module-dependency` \| `boundary-constraint` \| `code-style` \| `solution` \| `dev-document` |
 | **complexity** | string | `beginner` \| `intermediate` \| `advanced` |
 | **scope** | string | `universal` (通用) \| `project-specific` (本项目) \| `target-specific` (特定 Target) |
 | **tags** | string[] | `["networking", "async-await", "error-handling"]` |

package/skills/autosnippet-create/SKILL.md

@@ -165,6 +165,7 @@ Watch parses all such blocks and adds each as a separate candidate; prompt may s
 | `autosnippet_submit_knowledge_batch` | Submit draft .md as candidates: prefer draft folder + multiple files (not one big file); supports intro-only docs (no code—no Snippet). Pass `filePaths`, optional `targetName`, `deleteAfterSubmit`. **Delete the draft folder after submit** (e.g. `deleteAfterSubmit: true` or `rm -rf .autosnippet-drafts`). |
 | `autosnippet_submit_knowledge_batch` | Submit structured items (title, summary, trigger, language, code, usageGuide) for batch scan, etc. |
 | `autosnippet_submit_knowledge` | Submit single structured candidate with full V3 fields. |
+| `autosnippet_save_document` | Save a development document (design doc, debug report, ADR) — only needs title + markdown. See **autosnippet-devdocs** skill. |
 | `autosnippet_validate_candidate` | Pre-validate candidate quality before submission. |
 | `autosnippet_check_duplicate` | Check for duplicate Recipes before submission. |
 

package/skills/autosnippet-devdocs/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: autosnippet-devdocs
+description: Teaches the agent how to save development documents (architecture decisions, debug reports, design docs, research notes) to the AutoSnippet knowledge base using autosnippet_save_document. Use when the agent finishes analysis, debugging, design, or research and wants to persist the findings.
+---
+
+# AutoSnippet — Save Development Documents
+
+This skill tells the agent how to **save development documents** (architecture decisions, debug reports, design docs, research notes) to the AutoSnippet knowledge base, so they can be retrieved by future sessions.
+
+## When to use this skill
+
+- After finishing a **debug/troubleshooting session** — save the root cause analysis
+- After making an **architecture or design decision** — save the ADR (Architecture Decision Record)
+- After completing a **research or investigation** — save findings and conclusions
+- After a **performance analysis** — save the benchmark results and optimization notes
+- When the user says "保存这个分析" / "记录一下" / "save this to KB"
+
+## MCP Tool
+
+| Tool | Description |
+|------|-------------|
+| `autosnippet_save_document` | Save a development document to KB. Only needs `title` + `markdown`. Auto-published, no review needed. |
+| `autosnippet_search` | Search saved documents by keyword or semantic query. |
+
+## How to save a document
+
+Call `autosnippet_save_document` with:
+
+```json
+{
+  "title": "BiliDemo 冷启动性能分析",
+  "markdown": "## 问题背景\n\n冷启动耗时 8s...\n\n## 根因分析\n\n...\n\n## 解决方案\n\n...",
+  "description": "冷启动耗时 8s 的根因分析和优化方案",
+  "tags": ["debug-report", "performance"],
+  "scope": "project-specific"
+}
+```
+
+### Required fields
+
+| Field | Description |
+|-------|-------------|
+| `title` | Document title (Chinese or English) |
+| `markdown` | Full Markdown content |
+
+### Optional fields
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `description` | `""` | One-line summary |
+| `tags` | `[]` | Labels for filtering: `adr`, `debug-report`, `design-doc`, `research`, `performance`, `refactoring` |
+| `scope` | `project-specific` | `universal` or `project-specific` |
+
+## Recommended tags
+
+| Tag | Use case |
+|-----|----------|
+| `adr` | Architecture Decision Record |
+| `debug-report` | Bug investigation / root cause analysis |
+| `design-doc` | Module/feature design document |
+| `research` | Technology research or investigation |
+| `performance` | Benchmark results, profiling analysis |
+| `refactoring` | Refactoring plan or post-mortem |
+| `migration` | Migration guide or plan |
+| `meeting-notes` | Technical meeting summary |
+
+## How documents are delivered to Cursor
+
+Documents are stored as `knowledgeType: 'dev-document'` in the knowledge DB. They follow a dedicated delivery path:
+
+1. **NOT compressed** into Cursor Rules (Channel A/B skip dev-documents)
+2. **Full text** written to `.cursor/skills/autosnippet-devdocs/references/*.md` (Channel D)
+3. **Searchable** via `autosnippet_search("your query")` — full-text search hits documents
+
+## Document format tips
+
+- Use **clear headings** (`##`, `###`) — helps search and scanning
+- Include a **summary section** at the top
+- Reference **file paths** and **class names** concretely — improves search relevance
+- For ADRs, use the structure: Context → Decision → Consequences
+- For debug reports: Symptom → Investigation → Root Cause → Fix
+
+## Relation to other skills
+
+| Skill | When to use |
+|-------|-------------|
+| `autosnippet-create` | Saving **code patterns/recipes** (needs trigger, doClause, etc.) |
+| `autosnippet-devdocs` (this) | Saving **prose documents** (only needs title + markdown) |
+| `autosnippet-recipes` | Looking up existing knowledge |
+| `autosnippet-concepts` | Understanding AutoSnippet concepts |

package/skills/autosnippet-recipes/SKILL.md

@@ -112,6 +112,7 @@ Recipe is the core knowledge unit. V3 uses a unified structured model:
 | autosnippet_submit_knowledge | Submit single candidate (supports structured content) |
 | autosnippet_submit_knowledge_batch | Batch submit candidates |
 | autosnippet_submit_knowledge_batch | Submit draft .md files as candidates |
+| autosnippet_save_document | Save development document (design doc, debug report, ADR) — title + markdown only |
 | autosnippet_validate_candidate | Validate candidate quality |
 | autosnippet_check_duplicate | Dedup check |
 | autosnippet_enrich_candidates | AI semantic field enrichment for candidates |