autosnippet 2.9.0 → 2.11.0

package/scripts/migrate-md-to-knowledge.mjs

@@ -0,0 +1,364 @@
+#!/usr/bin/env node
+/**
+ * migrate-md-to-knowledge.mjs — 将旧格式 .md 文件迁移为统一 Knowledge 格式
+ *
+ * 扫描 AutoSnippet/candidates/ 和 AutoSnippet/recipes/ 下的旧格式 .md 文件，
+ * 用旧 parser 解析 → 转换为 KnowledgeEntry → 用 KnowledgeFileWriter 重新序列化。
+ *
+ * 旧文件会备份到 AutoSnippet/_backup/{candidates|recipes}/ 目录下。
+ *
+ * 用法:
+ *   node scripts/migrate-md-to-knowledge.mjs [projectRoot]
+ *
+ *   --dry-run    只报告，不写入
+ *   --no-backup  不创建备份
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// ── 解析命令行 ──
+const args = process.argv.slice(2);
+const dryRun   = args.includes('--dry-run');
+const noBackup = args.includes('--no-backup');
+const projectRoot = args.find(a => !a.startsWith('--')) || process.cwd();
+
+// ── 动态导入（兼容 ESM） ──
+const { parseRecipeMarkdown }    = await import('../lib/service/recipe/RecipeFileWriter.js');
+const { parseCandidateMarkdown } = await import('../lib/service/candidate/CandidateFileWriter.js');
+const { KnowledgeEntry }         = await import('../lib/domain/knowledge/KnowledgeEntry.js');
+const { KnowledgeFileWriter }    = await import('../lib/service/knowledge/KnowledgeFileWriter.js');
+const { Lifecycle }              = await import('../lib/domain/knowledge/Lifecycle.js');
+const { inferKind: inferKindV3 } = await import('../lib/domain/knowledge/Lifecycle.js');
+
+const RECIPES_DIR    = 'AutoSnippet/recipes';
+const CANDIDATES_DIR = 'AutoSnippet/candidates';
+const BACKUP_DIR     = 'AutoSnippet/_backup';
+
+const recipesDir    = path.join(projectRoot, RECIPES_DIR);
+const candidatesDir = path.join(projectRoot, CANDIDATES_DIR);
+const backupDir     = path.join(projectRoot, BACKUP_DIR);
+
+const report = {
+  recipes:    { total: 0, migrated: 0, skipped: 0, errors: [] },
+  candidates: { total: 0, migrated: 0, skipped: 0, errors: [] },
+};
+
+// ── 工具函数 ──
+
+function collectMdFiles(dir) {
+  if (!fs.existsSync(dir)) return [];
+  const results = [];
+  const walk = (curDir, base) => {
+    for (const entry of fs.readdirSync(curDir, { withFileTypes: true })) {
+      const full = path.join(curDir, entry.name);
+      const rel  = base ? `${base}/${entry.name}` : entry.name;
+      if (entry.isDirectory()) {
+        walk(full, rel);
+      } else if (entry.name.endsWith('.md') && !entry.name.startsWith('_')) {
+        results.push({ absPath: full, relPath: rel });
+      }
+    }
+  };
+  walk(dir, '');
+  return results;
+}
+
+function backupFile(absPath, type) {
+  if (noBackup || dryRun) return;
+  const rel = path.relative(
+    type === 'recipe' ? recipesDir : candidatesDir,
+    absPath
+  );
+  const dest = path.join(backupDir, type === 'recipe' ? 'recipes' : 'candidates', rel);
+  const destDir = path.dirname(dest);
+  if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
+  fs.copyFileSync(absPath, dest);
+}
+
+/**
+ * 判断文件是否已经是新格式（包含 lifecycle 和 _content 字段）
+ */
+function isAlreadyNewFormat(content) {
+  const fm = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
+  if (!fm) return false;
+  return fm[1].includes('lifecycle:') && fm[1].includes('_content:');
+}
+
+// ═══ Recipe 迁移 ═══
+
+function migrateRecipe(absPath, relPath) {
+  const content = fs.readFileSync(absPath, 'utf8');
+
+  // 跳过已迁移的文件
+  if (isAlreadyNewFormat(content)) {
+    report.recipes.skipped++;
+    return;
+  }
+
+  const parsed = parseRecipeMarkdown(content, relPath);
+
+  // 映射旧 Recipe 字段 → KnowledgeEntry wire format
+  const statusMap = {
+    active:     Lifecycle.ACTIVE,
+    deprecated: Lifecycle.DEPRECATED,
+    draft:      Lifecycle.DRAFT,
+  };
+
+  // 提取旧 dimensions
+  const quality = parsed.quality || {};
+  const stats   = parsed.statistics || {};
+
+  const wireData = {
+    id:                  parsed.id,
+    title:               parsed.title,
+    trigger:             parsed.trigger || '',
+    description:         parsed.summaryCn || parsed.summaryEn || '',
+    lifecycle:           statusMap[parsed.status] || Lifecycle.ACTIVE,
+    lifecycle_history:   [],
+    probation:           false,
+    language:            parsed.language || 'swift',
+    category:            parsed.category || 'general',
+    kind:                parsed.kind || inferKindV3(parsed.knowledgeType || 'code-pattern'),
+    knowledge_type:      parsed.knowledgeType || 'code-pattern',
+    complexity:          parsed.complexity || 'intermediate',
+    scope:               parsed.scope || 'universal',
+    difficulty:          parsed.difficulty || null,
+    tags:                parsed.tags || [],
+    summary_cn:          parsed.summaryCn || '',
+    summary_en:          parsed.summaryEn || '',
+    usage_guide_cn:      parsed.usageGuideCn || '',
+    usage_guide_en:      parsed.usageGuideEn || '',
+    content:             {
+      pattern:   '',
+      markdown:  '',
+      rationale: '',
+      steps:     [],
+      code_changes: [],
+      verification: null,
+    },
+    relations:           parsed.relations || {},
+    constraints:         parsed.constraints || {},
+    reasoning:           {},
+    quality: {
+      completeness:  quality.codeCompleteness  ?? quality.completeness  ?? 0,
+      adaptation:    quality.projectAdaptation  ?? quality.adaptation    ?? 0,
+      documentation: quality.documentationClarity ?? quality.documentation ?? 0,
+      overall:       quality.overall ?? 0,
+      grade:         quality.grade   || 'F',
+    },
+    stats: {
+      views:        stats.viewCount        ?? stats.views        ?? 0,
+      adoptions:    stats.adoptionCount    ?? stats.adoptions    ?? 0,
+      applications: stats.applicationCount ?? stats.applications ?? 0,
+      guard_hits:   stats.guardHitCount    ?? stats.guard_hits   ?? 0,
+      search_hits:  stats.searchHits       ?? stats.search_hits  ?? 0,
+      authority:    parsed.authority        ?? stats.authority    ?? 0,
+    },
+    headers:             parsed.headers || [],
+    header_paths:        [],
+    module_name:         '',
+    include_headers:     false,
+    agent_notes:         null,
+    ai_insight:          null,
+    reviewed_by:         null,
+    reviewed_at:         null,
+    rejection_reason:    parsed.deprecationReason || null,
+    source:              'migration',
+    source_file:         `${RECIPES_DIR}/${relPath}`,
+    source_candidate_id: parsed.sourceCandidate || null,
+    created_by:          parsed.createdBy || 'system',
+    created_at:          parsed.createdAt || Math.floor(Date.now() / 1000),
+    updated_at:          parsed.updatedAt || Math.floor(Date.now() / 1000),
+    published_at:        parsed.publishedAt || null,
+    published_by:        parsed.publishedBy || null,
+  };
+
+  // 提取 body 内容到 content
+  const bodyMatch = content.match(/^---[\s\S]*?---\s*\r?\n([\s\S]*)$/);
+  if (bodyMatch) {
+    const body = bodyMatch[1].trim();
+    const codeMatch = body.match(/```\w*\n([\s\S]*?)```/);
+    if (codeMatch) {
+      wireData.content.pattern = codeMatch[1].trimEnd();
+    }
+    // 如果有完整 markdown 内容（项目特写）
+    if (body.includes('— 项目特写') || (body.length > 500 && body.startsWith('#'))) {
+      wireData.content.markdown = body;
+      wireData.content.pattern = '';
+    }
+  }
+
+  // 构建实体并重新序列化
+  const entry = KnowledgeEntry.fromJSON(wireData);
+  const writer = new KnowledgeFileWriter(projectRoot);
+  const newMarkdown = writer.serialize(entry);
+
+  if (!dryRun) {
+    backupFile(absPath, 'recipe');
+    fs.writeFileSync(absPath, newMarkdown, 'utf8');
+  }
+
+  report.recipes.migrated++;
+}
+
+// ═══ Candidate 迁移 ═══
+
+function migrateCandidate(absPath, relPath) {
+  const content = fs.readFileSync(absPath, 'utf8');
+
+  // 跳过已迁移的文件
+  if (isAlreadyNewFormat(content)) {
+    report.candidates.skipped++;
+    return;
+  }
+
+  const parsed = parseCandidateMarkdown(content, relPath);
+
+  // 映射旧 Candidate 状态 → lifecycle
+  const statusMap = {
+    pending:  Lifecycle.PENDING,
+    approved: Lifecycle.APPROVED,
+    rejected: Lifecycle.REJECTED,
+    applied:  Lifecycle.ACTIVE,
+    draft:    Lifecycle.DRAFT,
+  };
+
+  const meta      = parsed._metadata || {};
+  const reasoning = parsed._reasoning || {};
+  const code      = parsed._bodyCode || '';
+
+  // 判断内容类型
+  const isMarkdown = code && (
+    code.includes('— 项目特写') || /^#{1,3}\s/.test(code.trimStart())
+  );
+
+  const wireData = {
+    id:                  parsed.id,
+    title:               meta.title || meta.description || (code ? code.substring(0, 60) : ''),
+    trigger:             meta.trigger || '',
+    description:         meta.description || '',
+    lifecycle:           statusMap[parsed.status] || Lifecycle.PENDING,
+    lifecycle_history:   parsed._statusHistory || [],
+    probation:           false,
+    language:            parsed.language || 'swift',
+    category:            meta.category || parsed.category || 'general',
+    kind:                inferKindV3(meta.knowledgeType || 'code-pattern'),
+    knowledge_type:      meta.knowledgeType || 'code-pattern',
+    complexity:          meta.complexity || 'intermediate',
+    scope:               meta.scope || 'universal',
+    difficulty:          meta.difficulty || null,
+    tags:                meta.tags || [],
+    summary_cn:          meta.summary || meta.summary_cn || '',
+    summary_en:          meta.summary_en || '',
+    usage_guide_cn:      meta.usageGuide || meta.usageGuide_cn || '',
+    usage_guide_en:      meta.usageGuide_en || '',
+    content: {
+      pattern:      isMarkdown ? '' : code,
+      markdown:     isMarkdown ? code : '',
+      rationale:    meta.rationale || (typeof reasoning === 'object' ? reasoning.whyStandard : '') || '',
+      steps:        meta.steps || [],
+      code_changes: meta.codeChanges || [],
+      verification: meta.verification || null,
+    },
+    relations: Array.isArray(meta.relations)
+      ? { related: meta.relations.map(r => typeof r === 'string' ? { target: r, description: '' } : r) }
+      : (meta.relations || {}),
+    constraints:         meta.constraints || {},
+    reasoning: {
+      why_standard:    (typeof reasoning === 'object' ? reasoning.whyStandard : '') || '',
+      sources:         (typeof reasoning === 'object' ? reasoning.sources : []) || [],
+      confidence:      (typeof reasoning === 'object' ? reasoning.confidence : 0.7) ?? 0.7,
+      quality_signals: (typeof reasoning === 'object' ? reasoning.qualitySignals : {}) || {},
+      alternatives:    (typeof reasoning === 'object' ? reasoning.alternatives : []) || [],
+    },
+    quality:             meta.quality || {},
+    stats:               {},
+    headers:             meta.headers || [],
+    header_paths:        [],
+    module_name:         '',
+    include_headers:     false,
+    agent_notes:         null,
+    ai_insight:          null,
+    reviewed_by:         parsed.approvedBy || parsed.rejectedBy || null,
+    reviewed_at:         parsed.approvedAt || null,
+    rejection_reason:    parsed.rejectionReason || null,
+    source:              parsed.source || 'migration',
+    source_file:         `${CANDIDATES_DIR}/${relPath}`,
+    source_candidate_id: null,
+    created_by:          parsed.createdBy || 'system',
+    created_at:          parsed.createdAt || Math.floor(Date.now() / 1000),
+    updated_at:          parsed.updatedAt || Math.floor(Date.now() / 1000),
+    published_at:        null,
+    published_by:        null,
+  };
+
+  // 构建实体并重新序列化
+  const entry = KnowledgeEntry.fromJSON(wireData);
+  const writer = new KnowledgeFileWriter(projectRoot);
+  const newMarkdown = writer.serialize(entry);
+
+  if (!dryRun) {
+    backupFile(absPath, 'candidate');
+    fs.writeFileSync(absPath, newMarkdown, 'utf8');
+  }
+
+  report.candidates.migrated++;
+}
+
+// ═══ 主流程 ═══
+
+console.log(`\n🔄 Knowledge .md Migration`);
+console.log(`  Project: ${projectRoot}`);
+console.log(`  Mode: ${dryRun ? 'DRY RUN' : 'LIVE'}`);
+console.log(`  Backup: ${noBackup ? 'disabled' : 'enabled'}`);
+console.log('');
+
+// ── 迁移 Recipes ──
+const recipeFiles = collectMdFiles(recipesDir);
+report.recipes.total = recipeFiles.length;
+console.log(`📦 Recipes: ${recipeFiles.length} files found`);
+
+for (const { absPath, relPath } of recipeFiles) {
+  try {
+    migrateRecipe(absPath, relPath);
+  } catch (err) {
+    report.recipes.errors.push({ file: relPath, error: err.message });
+    console.error(`  ❌ ${relPath}: ${err.message}`);
+  }
+}
+
+// ── 迁移 Candidates ──
+const candidateFiles = collectMdFiles(candidatesDir);
+report.candidates.total = candidateFiles.length;
+console.log(`📦 Candidates: ${candidateFiles.length} files found`);
+
+for (const { absPath, relPath } of candidateFiles) {
+  try {
+    migrateCandidate(absPath, relPath);
+  } catch (err) {
+    report.candidates.errors.push({ file: relPath, error: err.message });
+    console.error(`  ❌ ${relPath}: ${err.message}`);
+  }
+}
+
+// ── 报告 ──
+console.log('\n═══ Migration Report ═══');
+console.log(`  Recipes:    ${report.recipes.migrated}/${report.recipes.total} migrated, ${report.recipes.skipped} already new format, ${report.recipes.errors.length} errors`);
+console.log(`  Candidates: ${report.candidates.migrated}/${report.candidates.total} migrated, ${report.candidates.skipped} already new format, ${report.candidates.errors.length} errors`);
+
+if (!noBackup && !dryRun) {
+  console.log(`\n  Backups saved to: ${backupDir}`);
+}
+
+if (report.recipes.errors.length + report.candidates.errors.length > 0) {
+  console.log('\n  Errors:');
+  for (const e of [...report.recipes.errors, ...report.candidates.errors]) {
+    console.log(`    - ${e.file}: ${e.error}`);
+  }
+}
+
+console.log('');

package/skills/autosnippet-analysis/SKILL.md

@@ -73,7 +73,7 @@ description: Deep project analysis — full scan + semantic field enrichment + g
 }
 ```
 
-Use `autosnippet_submit_candidates` for batch submission.
+Use `autosnippet_submit_knowledge_batch` for batch submission.
 
 #### Phase 4: Guard Deep Audit (Optional)
 对特定文件调用 `autosnippet_guard_audit_files` 做深度规范审计。
@@ -101,7 +101,7 @@ Use `autosnippet_submit_candidates` for batch submission.
 ### Workflow for Enrichment
 
 **方式 A: 你（Agent）直接补全**
-在分析代码时，直接填写所有 6 个语义字段到 `autosnippet_submit_candidate` 调用中。
+在分析代码时，直接填写所有 6 个语义字段到 `autosnippet_submit_knowledge` 调用中。
 
 **方式 B: 对已有候选调用 AI 补全**
 ```
@@ -109,6 +109,13 @@ autosnippet_enrich_candidates({ candidateIds: ["id1", "id2", ...] })
 ```
 AI 会分析每条候选的代码，自动填充缺失字段（已有字段不会被覆盖）。
 
+**方式 C: Bootstrap 候选 AI 润色**
+```
+autosnippet_bootstrap_refine({ candidateIds: ["id1", "id2", ...] })
+```
+使用 AI 对 Bootstrap 候选做内容润色（改善 summary、补充 insight、推断 relations、调整 confidence）。
+必须在 `autosnippet_enrich_candidates` 之后调用（确保字段完整后再润色）。
+
 ---
 
 ## Capability 3: 候选 → Recipe 查漏补缺
@@ -119,11 +126,12 @@ AI 会分析每条候选的代码，自动填充缺失字段（已有字段不
 
 ### Workflow
 
-1. 调用 `autosnippet_enrich_candidates` 对目标候选做 AI 补全
-2. 调用 `autosnippet_validate_candidate` 检查结构完整性
-3. 调用 `autosnippet_check_duplicate` 检查重复
-4. 报告补全情况 + 缺失字段 + 重复风险
-5. 如缺失字段 AI 无法填充，提示用户手动补充
+1. 调用 `autosnippet_enrich_candidates` 对目标候选做结构补齐（诊断缺失字段）
+2. 调用 `autosnippet_bootstrap_refine` 对候选做 AI 润色（summary/insight/relations）
+3. 调用 `autosnippet_validate_candidate` 检查结构完整性
+4. 调用 `autosnippet_check_duplicate` 检查重复
+5. 报告补全情况 + 缺失字段 + 重复风险
+6. 如缺失字段 AI 无法填充，提示用户手动补充
 
 ### Recipe 必备字段检查清单
 

package/skills/autosnippet-candidates/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: autosnippet-candidates
-description: Generate Recipe candidates with full V2 structured information. Single file scan or batch Target scan. Agent extracts rich metadata matching the complete Recipe schema. Agent submits candidates only; Recipe creation/modification is human-only.
+description: Generate Recipe candidates with full V3 structured information. Single file scan or batch Target scan. Agent extracts rich metadata matching the complete Recipe schema. Agent submits candidates only; Recipe creation/modification is human-only.
 ---
 
 # AutoSnippet - Generate Candidates with Structured Content (v3.1)
@@ -65,7 +65,7 @@ Recipe creation, review, publish, update, deprecate, delete are **human-only via
 
 ---
 
-## V2 Complete Candidate Field Model
+## V3 Complete Candidate Field Model
 
 Every candidate submitted via `submit_candidate` or `submit_candidates` supports the following fields. **The richer the information, the higher the quality of the resulting Recipe.**
 
@@ -221,18 +221,18 @@ Severity: `error` (must fix) | `warning` (should fix) | `info` (suggestion)
 3. Call `autosnippet_context_search` to mark similarity and fill `relations`
 4. (Optional) `autosnippet_validate_candidate` pre-validate
 5. (Optional) `autosnippet_check_duplicate` dedup hint
-6. `autosnippet_submit_candidate` or `autosnippet_submit_candidates` to submit
+6. `autosnippet_submit_knowledge` or `autosnippet_submit_knowledge_batch` to submit
 
 ## Batch Target Scan Flow
 1. `autosnippet_get_targets` → select targetName
 2. `autosnippet_get_target_files(targetName)`
 3. Parallel scan → per-file checklist extraction → aggregate / dedup / score
-4. `autosnippet_submit_candidates` batch submit — **all V2 fields are preserved**
+4. `autosnippet_submit_knowledge_batch` batch submit — **all V3 fields are preserved**
 
 ## Draft File Flow (alternative)
 1. Create draft folder (e.g. `.autosnippet-drafts/`) outside `AutoSnippet/`
 2. Generate one .md per pattern in draft folder
-3. Call `autosnippet_submit_draft_recipes` with filePaths and `deleteAfterSubmit: true`
+3. Call `autosnippet_submit_knowledge_batch` with filePaths and `deleteAfterSubmit: true`
 4. Delete draft folder after submit
 
 ---
@@ -247,9 +247,9 @@ Severity: `error` (must fix) | `warning` (should fix) | `info` (suggestion)
 | `autosnippet_context_search` | Find similar existing Recipes → fill `relations` |
 | `autosnippet_validate_candidate` | Pre-validate candidate fields |
 | `autosnippet_check_duplicate` | Cosine similarity dedup check |
-| `autosnippet_submit_candidate` | Submit single candidate (**all V2 fields**) |
-| `autosnippet_submit_candidates` | Batch submit candidates (**all V2 fields preserved**) |
-| `autosnippet_submit_draft_recipes` | Submit .md draft files as candidates |
+| `autosnippet_submit_knowledge` | Submit single candidate (**all V3 fields**) |
+| `autosnippet_submit_knowledge_batch` | Batch submit candidates (**all V3 fields preserved**) |
+| `autosnippet_submit_knowledge_batch` | Submit .md draft files as candidates |
 
 ---
 

package/skills/autosnippet-coldstart/SKILL.md

@@ -226,7 +226,7 @@ description: Cold-start knowledge base initialization. Full 9-dimension analysis
 
 ## Phase 5: 批量提交
 
-将所有分析结果通过 `autosnippet_submit_candidates` 批量提交：
+将所有分析结果通过 `autosnippet_submit_knowledge_batch` 批量提交：
 
 ```json
 {
@@ -448,17 +448,21 @@ description: Cold-start knowledge base initialization. Full 9-dimension analysis
 | Tool | 用途 |
 |------|------|
 | `autosnippet_bootstrap_knowledge` | 启动冷启动扫描（本 Skill 核心工具） |
-| `autosnippet_submit_candidates` | 批量提交候选 |
-| `autosnippet_submit_candidate` | 提交单条候选 |
+| `autosnippet_enrich_candidates` | ① 结构补齐：诊断候选字段缺失 |
+| `autosnippet_bootstrap_refine` | ② 内容润色：AI 精炼候选质量（summary/insight/relations） |
+| `autosnippet_submit_knowledge_batch` | 批量提交候选 |
+| `autosnippet_submit_knowledge` | 提交单条候选 |
 | `autosnippet_validate_candidate` | 校验候选字段 |
 | `autosnippet_check_duplicate` | 去重检查 |
 | `autosnippet_context_search` | 查找已有知识（避免重复） |
 | `autosnippet_scan_project` | 轻量探查（不写库） |
+| `autosnippet_list_skills` | 列出可用 Skill 列表 |
+| `autosnippet_load_skill` | 加载指定 Skill 文档获取指引 |
 
 ## Related Skills
 
 - **autosnippet-analysis**: 语义字段补全 + 深度分析（用于增量分析）
-- **autosnippet-candidates**: 完整候选字段模型 + V2 Schema
+- **autosnippet-candidates**: 完整候选字段模型 + V3 Schema
 - **autosnippet-structure**: 项目结构发现 (targets / files / dependencies)
 - **autosnippet-guard**: Guard 规则详情
 - **autosnippet-reference-swift**: Swift 业界最佳实践参考（命名/并发/错误处理/内存/设计模式）

package/skills/autosnippet-concepts/SKILL.md

@@ -87,13 +87,14 @@ This is a conceptual map. Skills stay semantic; MCP provides capability.
 | 知识图谱 | `autosnippet_graph_query`, `autosnippet_graph_impact`, `autosnippet_graph_path`, `autosnippet_graph_stats` |
 | 候选预检 | `autosnippet_validate_candidate` |
 | 去重建议 | `autosnippet_check_duplicate` |
-| 候选提交 | `autosnippet_submit_candidate`, `autosnippet_submit_candidates`, `autosnippet_submit_draft_recipes` |
+| 候选提交 | `autosnippet_submit_knowledge`, `autosnippet_submit_knowledge_batch`, `autosnippet_submit_knowledge_batch` |
 | AI 补全 | `autosnippet_enrich_candidates` |
 | Guard 检查 | `autosnippet_guard_check`, `autosnippet_guard_audit_files` |
 | 合规报告 | `autosnippet_compliance_report`, `autosnippet_recipe_insights` |
 | 使用确认 | `autosnippet_confirm_usage` |
 | 项目扫描 | `autosnippet_scan_project` |
-| 冷启动 | `autosnippet_bootstrap_knowledge` |
+| 冷启动 | `autosnippet_bootstrap_knowledge`, `autosnippet_bootstrap_refine` |
+| Skills 管理 | `autosnippet_list_skills`, `autosnippet_load_skill`, `autosnippet_create_skill`, `autosnippet_update_skill`, `autosnippet_delete_skill`, `autosnippet_suggest_skills` |
 | 自检/能力 | `autosnippet_health`, `autosnippet_capabilities` |
 
 ### Failure Handling (Examples)
@@ -336,7 +337,7 @@ When creating or extracting Recipes:
 
 ### Candidate-only Rule (重要)
 
-- **If the user asks for candidates**: Extract structured items and submit via MCP **`autosnippet_submit_candidates`**.
+- **If the user asks for candidates**: Extract structured items and submit via MCP **`autosnippet_submit_knowledge_batch`**.
 
 ---
 
@@ -376,7 +377,7 @@ When `asd ui` is running in the project root, use the HTTP API for on-demand sem
 | Capability | Description | Skill |
 |------------|-------------|-------|
 | **Recipe lookup** | Read `references/project-recipes-context.md` 轻量索引，需全文调 MCP `autosnippet_get_recipe(id)` / `autosnippet_context_search`. Recipe over source | autosnippet-recipes |
-| **Create Recipe** | Dashboard New Recipe; or write to `_draft_recipe.md` and watch auto-adds; or MCP `autosnippet_submit_draft_recipes` | autosnippet-create |
+| **Create Recipe** | Dashboard New Recipe; or write to `_draft_recipe.md` and watch auto-adds; or MCP `autosnippet_submit_knowledge_batch` | autosnippet-create |
 | **Search & insert** | `ass` shortcut or `// as:search`, `asd search`, Dashboard search | autosnippet-search |
 | **Audit review** | `// as:audit`; watch runs AI review against knowledge base | autosnippet-guard |
 | **Dependency graph** | `AutoSnippet/AutoSnippet.spmmap.json`; `asd spm-map` to update; MCP graph tools for querying | autosnippet-structure |
@@ -593,8 +594,8 @@ authority: 3
 
 ### How to add new knowledge
 
-1. **Single code / single Recipe**: Copy to clipboard → open Dashboard (run `asd ui` if not running) → Use Copied Code, paste, review, save; or write `_draft_recipe.md` and let watch auto-add to Candidates. Or use `autosnippet_submit_draft_recipes` via MCP.
-2. **Multiple drafts (recommended)**: Create a **draft folder** (e.g. `.autosnippet-drafts`), **one .md file per Recipe**—do not put everything in one big file. Call MCP **`autosnippet_submit_draft_recipes`** with those file paths to submit to Candidates, then review in Dashboard **Candidates**. **After submit, delete the draft folder** (use `deleteAfterSubmit: true` or `rm -rf .autosnippet-drafts`).
+1. **Single code / single Recipe**: Copy to clipboard → open Dashboard (run `asd ui` if not running) → Use Copied Code, paste, review, save; or write `_draft_recipe.md` and let watch auto-add to Candidates. Or use `autosnippet_submit_knowledge_batch` via MCP.
+2. **Multiple drafts (recommended)**: Create a **draft folder** (e.g. `.autosnippet-drafts`), **one .md file per Recipe**—do not put everything in one big file. Call MCP **`autosnippet_submit_knowledge_batch`** with those file paths to submit to Candidates, then review in Dashboard **Candidates**. **After submit, delete the draft folder** (use `deleteAfterSubmit: true` or `rm -rf .autosnippet-drafts`).
 3. **Intro-only docs**: Recipe candidates can be intro-only (frontmatter + usage guide, no code); after approval they become Recipes and **do not generate a Snippet**—used only for search and Guard context.
 
 ### How to use knowledge once it’s in the base

package/skills/autosnippet-create/SKILL.md

@@ -12,8 +12,8 @@ This skill tells the agent how to **submit module usage code** (that Cursor has
 ## Instructions for the agent (read this first)
 
 1. **Goal**: When you (Cursor) have **finished writing or refining** module usage code, or the user says "把这段提交到 web / 加入知识库", guide them to **submit that code to the Dashboard** so it becomes a **Recipe** in `AutoSnippet/recipes/`.
-2. **Draft workflow**: Prefer **creating a draft folder** (e.g. `.autosnippet-drafts`), **one .md file per Recipe**, multiple draft files—**do not use one big file**. Call MCP **`autosnippet_submit_draft_recipes`** with filePaths (the .md files in the draft folder) to submit to Candidates. **After submit, delete the draft folder** (use `deleteAfterSubmit: true` or run `rm -rf .autosnippet-drafts`). Single-item flow can use `_draft_recipe.md` and watch will auto-add to Candidates.
-3. **When user asks for "candidates"**: Use MCP **`autosnippet_submit_candidates`** for structured items (title/summary/trigger/code/usageGuide); use **`autosnippet_submit_draft_recipes`** for Markdown draft files (prefer draft folder + multiple files; delete draft folder after submit).
+2. **Draft workflow**: Prefer **creating a draft folder** (e.g. `.autosnippet-drafts`), **one .md file per Recipe**, multiple draft files—**do not use one big file**. Call MCP **`autosnippet_submit_knowledge_batch`** with filePaths (the .md files in the draft folder) to submit to Candidates. **After submit, delete the draft folder** (use `deleteAfterSubmit: true` or run `rm -rf .autosnippet-drafts`). Single-item flow can use `_draft_recipe.md` and watch will auto-add to Candidates.
+3. **When user asks for "candidates"**: Use MCP **`autosnippet_submit_knowledge_batch`** for structured items (title/summary/trigger/code/usageGuide); use **`autosnippet_submit_knowledge_batch`** for Markdown draft files (prefer draft folder + multiple files; delete draft folder after submit).
 4. **One Recipe = one scenario**: If you are drafting content, **split** into multiple Recipes by scenario. Never combine multiple usage patterns into one Recipe file or one candidate.
 5. **Recipe candidates can be intro-only**: Intro-only docs (no code block) can be submitted as candidates; after approval they become Recipes and **do not generate a Snippet**—used only for search and Guard context.
 6. **MUST follow standard Recipe format**: Use the complete template from **autosnippet-concepts** skill. Include all required fields: frontmatter with `title`, `trigger`, `category` (one of 8 standard values), `language` (must be `swift` or `objectivec`), `summary_cn`, `summary_en`, `headers` (complete import statements), plus `## Snippet / Code Reference` and `## AI Context / Usage Guide` section.
@@ -51,11 +51,11 @@ This skill tells the agent how to **submit module usage code** (that Cursor has
      ```
    - See [templates/recipes-setup/README.md](../../templates/recipes-setup/README.md) for detailed format guide & examples.
 7. **Auto-fill headers from project context**: Before submitting, **check `references/project-recipes-context.md`** (轻量索引) to find similar Recipes by title/trigger/category, then call MCP **`autosnippet_get_recipe(id)`** to get full content including headers. Copy the exact import format for `headers` field. If needed, call MCP **`autosnippet_context_search`** with the module name to find similar Recipes and extract their header patterns. This ensures consistency and correctness.
-8. **Primary flow (MCP preferred)**: Code is ready → Agent writes to `_draft_recipe.md` or calls `autosnippet_submit_draft_recipes` / `autosnippet_submit_candidates` → candidates appear in Dashboard Candidates → user reviews and approves → Recipe is added to the knowledge base.
+8. **Primary flow (MCP preferred)**: Code is ready → Agent writes to `_draft_recipe.md` or calls `autosnippet_submit_knowledge_batch` / `autosnippet_submit_knowledge_batch` → candidates appear in Dashboard Candidates → user reviews and approves → Recipe is added to the knowledge base.
 9. **Alternative (Dashboard browser)**: Code is ready → user opens Dashboard (`asd ui` running) → **New Recipe** → **Use Copied Code** (paste the code) → AI fills title/summary/trigger/headers → **user reviews and approves** → saved to knowledge base.
 10. **Alternative (in editor)**: User adds **`// as:create`** in the source file, copies the code, saves → **watch** (from `asd watch` or `asd ui`) auto-adds to Candidates → user opens Dashboard **Candidates** to review and save.
 9. **Draft & clipboard auto-add**: When you write to **`_draft_recipe.md`** (project root) or user uses **`// as:create`** with clipboard content, **watch** automatically reads the draft/clipboard, adds it to **Candidates** (target `_draft` or `_watch`), and shows a **friendly prompt** (e.g. "已创建候选「xxx」，请在 Candidates 页审核" in notification and console). User only needs to open Dashboard **Candidates** to review and save — no manual copy-paste required.
-10. **Multiple recipes**: Prefer **one .md file per Recipe** in a draft folder (e.g. `.autosnippet-drafts/`), call **`autosnippet_submit_draft_recipes`** with the list of file paths, then **delete the draft folder** after submit. Do not use one big file for many Recipes.
+10. **Multiple recipes**: Prefer **one .md file per Recipe** in a draft folder (e.g. `.autosnippet-drafts/`), call **`autosnippet_submit_knowledge_batch`** with the list of file paths, then **delete the draft folder** after submit. Do not use one big file for many Recipes.
 11. **Project root** = directory with `AutoSnippet/AutoSnippet.boxspec.json`. All commands run from the project root.
 
 ---
@@ -68,7 +68,7 @@ This skill tells the agent how to **submit module usage code** (that Cursor has
 
 - **Code scenario**: Usage code is in current file or clipboard. If not copied, prompt user to copy the code block you provide.
 ...rated a full Recipe (frontmatter, Snippet, Usage Guide), **prefer writing to draft file** `_draft_recipe.md` at project root. On save, **watch automatically reads the draft**, adds it to **Candidates** (target `_draft`), and shows a **friendly prompt** ("已创建候选「xxx」，请在 Candidates 页审核"). User opens Dashboard **Candidates** to review and save — no manual copy needed. Or output in copyable format in chat and guide user to copy → Dashboard → Use Copied Code → paste → review → save. **Do not write to `AutoSnippet/recipes/` or `AutoSnippet/snippets/`.**
-- **Candidate output rule**: When the user asks for candidates, **do not create files under `AutoSnippet/`**. Use **`autosnippet_submit_candidates`** for structured items; use **`autosnippet_submit_draft_recipes`** for draft .md files (prefer draft folder + multiple files; delete draft folder after submit).
+- **Candidate output rule**: When the user asks for candidates, **do not create files under `AutoSnippet/`**. Use **`autosnippet_submit_knowledge_batch`** for structured items; use **`autosnippet_submit_knowledge_batch`** for draft .md files (prefer draft folder + multiple files; delete draft folder after submit).
 
 ### Step 2: Open the web (Dashboard) in browser
 
@@ -78,7 +78,7 @@ This skill tells the agent how to **submit module usage code** (that Cursor has
 ### Step 3: Submit via Dashboard
 
 1. **Browser**: Run terminal command `open "http://localhost:3000/?action=create&source=clipboard"` (macOS) to open the browser.
-2. **Draft file (preferred for Agent)**: Write full Recipe MD to `_draft_recipe.md` at project root → watch auto-adds to Candidates. Or call MCP **`autosnippet_submit_draft_recipes`** with draft file paths.
+2. **Draft file (preferred for Agent)**: Write full Recipe MD to `_draft_recipe.md` at project root → watch auto-adds to Candidates. Or call MCP **`autosnippet_submit_knowledge_batch`** with draft file paths.
 3. **Manual fallback**: User opens **`http://localhost:3000`** in browser → **New Recipe** → **Use Copied Code** → paste.
 3. Pasted code: **Full Recipe MD** (with `---` frontmatter, `## Snippet / Code Reference`, `## AI Context / Usage Guide`) is parsed directly, **no AI rewrite**. Plain code still goes through AI analysis and fill.
 4. **User reviews and approves** — 人工审核 title/summary/category/trigger 及内容，确认无误后再保存。
@@ -92,7 +92,7 @@ This skill tells the agent how to **submit module usage code** (that Cursor has
 
 ## Alternative: Copy then jump to Web (Xcode and Cursor)
 
-**Option A — MCP Submit (Cursor 首选)**: After user confirms code, Agent calls **`autosnippet_submit_draft_recipes`** (for .md drafts) or **`autosnippet_submit_candidates`** (for structured items) to submit directly to Candidates. User reviews in Dashboard.
+**Option A — MCP Submit (Cursor 首选)**: After user confirms code, Agent calls **`autosnippet_submit_knowledge_batch`** (for .md drafts) or **`autosnippet_submit_knowledge_batch`** (for structured items) to submit directly to Candidates. User reviews in Dashboard.
 
 **Option B — Browser (Dashboard)**: Run `open "http://localhost:3000/?action=create&source=clipboard"` to open Dashboard New Recipe page; page reads clipboard and fills.
 
@@ -148,9 +148,9 @@ Watch parses all such blocks and adds each as a separate candidate; prompt may s
 
 | User / Cursor situation | Action |
 |-------------------------|--------|
-| "把这段提交到 web / 加入知识库" (code just written) | 1) 提示用户复制代码；2) 写入 `_draft_recipe.md` 或调用 **`autosnippet_submit_draft_recipes`**；3) 若需 Dashboard，运行 `open "http://localhost:3000/?action=create&source=clipboard"`；4) 用户粘贴并保存。 |
+| "把这段提交到 web / 加入知识库" (code just written) | 1) 提示用户复制代码；2) 写入 `_draft_recipe.md` 或调用 **`autosnippet_submit_knowledge_batch`**；3) 若需 Dashboard，运行 `open "http://localhost:3000/?action=create&source=clipboard"`；4) 用户粘贴并保存。 |
 | Agent 起草了 Recipe/Snippet 内容 | **Prefer**: Write to `_draft_recipe.md` (project root) → save → **watch 自动读取并加入候选池**，并给出友好提示 → 用户打开 Dashboard **Candidates** 审核并保存。无需手动复制。 |
-| Code in current file, want to submit from editor | **MCP**：`autosnippet_submit_draft_recipes`（写草稿 .md 后提交）。或 Add **`// as:create`**, copy, save；确保 **`asd watch`** / **`asd ui`** 运行；有剪贴板时自动加入候选并友好提示。 |
+| Code in current file, want to submit from editor | **MCP**：`autosnippet_submit_knowledge_batch`（写草稿 .md 后提交）。或 Add **`// as:create`**, copy, save；确保 **`asd watch`** / **`asd ui`** 运行；有剪贴板时自动加入候选并友好提示。 |
 | Code already in a file (path known) | 打开 **`http://localhost:3000`** → New Recipe → enter path → **Scan File** → review → save. |
 | Agent 起草内容无法完整复制 | Write to `_draft_recipe.md` → save → **watch 自动读取草稿、加入候选并友好提示** → 用户打开 **Candidates** 审核保存。 |
 | Batch from Target | **`asd ais <Target>`** → 打开 **`http://localhost:3000`** → **Candidates** → approve. |
@@ -162,13 +162,13 @@ Watch parses all such blocks and adds each as a separate candidate; prompt may s
 | Tool | Use |
 |------|-----|
 | `autosnippet_context_search` | On-demand semantic search of knowledge base; pass `query`, `limit?` |
-| `autosnippet_submit_draft_recipes` | 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_candidates` | Submit structured items (title, summary, trigger, language, code, usageGuide) for batch scan, etc. |
-| `autosnippet_submit_candidate` | Submit single structured candidate with full V2 fields. |
+| `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_validate_candidate` | Pre-validate candidate quality before submission. |
 | `autosnippet_check_duplicate` | Check for duplicate Recipes before submission. |
 
-**Fallback when Dashboard not open**: Agent can always use `autosnippet_submit_draft_recipes` or `autosnippet_submit_candidates` directly via MCP — no browser needed.
+**Fallback when Dashboard not open**: Agent can always use `autosnippet_submit_knowledge_batch` or `autosnippet_submit_knowledge_batch` directly via MCP — no browser needed.
 
 ---
 

package/skills/autosnippet-intent/SKILL.md

@@ -42,10 +42,11 @@ Use this skill when the user's intent is unclear or overlaps multiple capabiliti
 - Insights: `autosnippet_recipe_insights`, `autosnippet_compliance_report`
 - Graph: `autosnippet_graph_query`, `autosnippet_graph_impact`, `autosnippet_graph_path`, `autosnippet_graph_stats`
 - Structure: `autosnippet_get_targets`, `autosnippet_get_target_files`, `autosnippet_get_target_metadata`
-- Candidates: `autosnippet_validate_candidate`, `autosnippet_check_duplicate`, `autosnippet_submit_candidate`, `autosnippet_submit_candidates`, `autosnippet_submit_draft_recipes`, `autosnippet_enrich_candidates`
+- Candidates: `autosnippet_validate_candidate`, `autosnippet_check_duplicate`, `autosnippet_submit_knowledge`, `autosnippet_submit_knowledge_batch`, `autosnippet_submit_knowledge_batch`, `autosnippet_enrich_candidates`
 - Guard: `autosnippet_guard_check`, `autosnippet_guard_audit_files`, `autosnippet_scan_project`
 - Telemetry: `autosnippet_confirm_usage`
-- Bootstrap: `autosnippet_bootstrap_knowledge`
+- Bootstrap: `autosnippet_bootstrap_knowledge`, `autosnippet_bootstrap_refine`
+- Skills: `autosnippet_list_skills`, `autosnippet_load_skill`, `autosnippet_create_skill`, `autosnippet_update_skill`, `autosnippet_delete_skill`, `autosnippet_suggest_skills`
 
 This skill is a router only; it does not perform actions itself.