autosnippet 2.6.0 → 2.7.0

package/lib/service/recipe/RecipeFileWriter.js

@@ -300,7 +300,18 @@ export class RecipeFileWriter {
     }
     if (recipe.content?.steps?.length > 0) {
       parts.push('### 使用步骤\n');
-      recipe.content.steps.forEach((step, i) => { parts.push(`${i + 1}. ${step}`); });
+      recipe.content.steps.forEach((step, i) => {
+        if (typeof step === 'string') {
+          parts.push(`${i + 1}. ${step}`);
+        } else {
+          const title = step.title || '';
+          const desc = step.description || '';
+          const code = step.code || '';
+          const text = [title, desc].filter(Boolean).join(': ');
+          parts.push(`${i + 1}. ${text || '(步骤)'}`);
+          if (code) { parts.push(''); parts.push(`\`\`\`\n${code}\n\`\`\``); }
+        }
+      });
       parts.push('');
     }
     if (recipe.constraints?.boundaries?.length > 0) {

package/lib/service/skills/SignalCollector.js

@@ -76,14 +76,14 @@ export class SignalCollector {
     projectRoot,
     database = null,
     chatAgent = null,
-    mode = 'suggest',
+    mode = 'auto',
     intervalMs = DEFAULT_INTERVAL_MS,
     onSuggestions = null,
   }) {
     this.#projectRoot = projectRoot;
     this.#db = database;
     this.#chatAgent = chatAgent;
-    this.#mode = ['off', 'suggest', 'auto'].includes(mode) ? mode : 'suggest';
+    this.#mode = ['off', 'suggest', 'auto'].includes(mode) ? mode : 'auto';
     this.#intervalMs = Math.max(Math.min(intervalMs, MAX_INTERVAL_MS), MIN_INTERVAL_MS);
     this.#logger = Logger.getInstance();
     this.#onSuggestions = onSuggestions;
@@ -160,6 +160,16 @@ export class SignalCollector {
   getSnapshot() { return { ...this.#snapshot }; }
   getMode() { return this.#mode; }
 
+  /** 从 pendingSuggestions 中移除已创建的 Skill */
+  removePendingSuggestion(name) {
+    if (!this.#snapshot.pendingSuggestions?.length) return;
+    this.#snapshot.pendingSuggestions = this.#snapshot.pendingSuggestions.filter(s => s.name !== name);
+    if (this.#snapshot.lastResult) {
+      this.#snapshot.lastResult.newSuggestions = this.#snapshot.pendingSuggestions.length;
+    }
+    this.#saveSnapshot();
+  }
+
   setMode(mode) {
     if (!['off', 'suggest', 'auto'].includes(mode)) return;
     this.#mode = mode;
@@ -211,6 +221,17 @@ export class SignalCollector {
         newSuggestions: newSuggestions.length,
         aiToolCalls: toolCalls?.length || 0,
       };
+      // 持久化 AI 生成的建议，供前端直接读取
+      if (newSuggestions.length > 0) {
+        this.#snapshot.pendingSuggestions = newSuggestions.map(s => ({
+          name: s.name,
+          description: s.description || s.reason || '',
+          rationale: s.rationale || s.reason || '',
+          body: s.body || '',
+          source: s.source || 'signal-collector',
+          priority: s.priority || 'medium',
+        }));
+      }
 
       if (newSuggestions.length > 0) {
         for (const s of newSuggestions) {
@@ -403,14 +424,16 @@ ${JSON.stringify(signals.codeChanges, null, 2)}
 
 1. 综合分析以上 6 个维度的信号
 2. 识别重复模式、高频错误、未覆盖的操作
-3. 给出 Skill 推荐建议（名称、原因、优先级、推荐 body）
-4. 根据信号密度判断下次分析应间隔多久（5-1440 分钟）
-5. 给出简要分析摘要
+3. **只推荐项目特有的知识模式**，不要推荐通用编程知识（如 Git 基础、语言语法等）
+4. 推荐的 Skill 应该能固化团队/项目的独有约定、架构决策或反复出现的问题解决方案
+5. 根据信号密度判断下次分析应间隔多久（5-1440 分钟）
+6. 给出简要分析摘要
+7. 如果没有发现值得推荐的项目特有模式，返回空的 suggestions 数组
 
 ## 输出格式
 
 在你的回复最后一行，输出一个 JSON 对象（不要包在 markdown code block 中）：
-{"suggestions":[{"name":"skill-name","reason":"推荐原因","priority":"high|medium|low","body":"推荐的 Skill 内容"}],"nextIntervalMinutes":60,"summary":"一句话分析摘要"}`;
+{"suggestions":[{"name":"skill-name","description":"一句话中文描述","reason":"推荐原因","priority":"high|medium|low","body":"推荐的 Skill 内容"}],"nextIntervalMinutes":60,"summary":"一句话分析摘要"}`;
   }
 
   // ═══════════════════════════════════════════════════════
@@ -473,6 +496,7 @@ ${JSON.stringify(signals.codeChanges, null, 2)}
           lastResult: data.lastResult || null,
           lastAiSummary: data.lastAiSummary || '',
           autoCreated: Array.isArray(data.autoCreated) ? data.autoCreated : [],
+          pendingSuggestions: Array.isArray(data.pendingSuggestions) ? data.pendingSuggestions : [],
         };
       }
     } catch { /* corrupt — reset */ }
@@ -484,6 +508,7 @@ ${JSON.stringify(signals.codeChanges, null, 2)}
       lastResult: null,
       lastAiSummary: '',
       autoCreated: [],
+      pendingSuggestions: [],
     };
   }
 

package/lib/service/skills/SkillAdvisor.js

@@ -17,6 +17,7 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
+import { getProjectSkillsPath } from '../../infrastructure/config/Paths.js';
 
 export class SkillAdvisor {
   #projectRoot;
@@ -299,7 +300,7 @@ export class SkillAdvisor {
    */
   #listExistingProjectSkills() {
     const names = new Set();
-    const dir = path.join(this.#projectRoot, '.autosnippet', 'skills');
+    const dir = getProjectSkillsPath(this.#projectRoot);
     try {
       fs.readdirSync(dir, { withFileTypes: true })
         .filter(d => d.isDirectory())

package/lib/service/skills/SkillHooks.js

@@ -10,18 +10,26 @@
  *   - onGuardCheck(violation, ctx) → violation (可修改)
  *   - onBootstrapComplete(stats, ctx) → void
  *
- * 加载顺序: 内置 skills/ → 项目级 .autosnippet/skills/（同名覆盖）
+ * 加载顺序: 内置 skills/ → 项目级 AutoSnippet/skills/（同名覆盖）
  */
 
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import Logger from '../../infrastructure/logging/Logger.js';
+import { getProjectSkillsPath } from '../../infrastructure/config/Paths.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const PROJECT_ROOT = path.resolve(__dirname, '../../..');
-const SKILLS_DIR = path.resolve(PROJECT_ROOT, 'skills');
-const PROJECT_SKILLS_DIR = path.resolve(PROJECT_ROOT, '.autosnippet', 'skills');
+const SKILLS_DIR = path.resolve(__dirname, '../../../skills');
+
+/**
+ * 获取项目级 Skills 目录（运行时动态解析）
+ * 路径: {projectRoot}/AutoSnippet/skills/
+ */
+function _getProjectSkillsDir() {
+  const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
+  return getProjectSkillsPath(projectRoot);
+}
 
 const HOOK_NAMES = [
   'onCandidateSubmit',
@@ -48,7 +56,7 @@ export class SkillHooks {
     await this.#loadFromDir(SKILLS_DIR, loaded);
 
     // 2. 项目级 skills（覆盖同名）
-    await this.#loadFromDir(PROJECT_SKILLS_DIR, loaded);
+    await this.#loadFromDir(_getProjectSkillsDir(), loaded);
 
     // 3. 注册所有钩子
     for (const [skillName, mod] of loaded) {

package/lib/service/spm/SpmService.js

@@ -650,7 +650,7 @@ export class SpmService {
     const CODE_EXTS = isDirectoryTarget
       ? new Set(['.swift', '.m', '.mm', '.h', '.c', '.cpp', '.js', '.ts', '.tsx', '.jsx', '.py', '.java', '.kt', '.go', '.rs', '.rb', '.vue', '.mjs', '.cjs'])
       : new Set(['.swift', '.m', '.h', '.c', '.cpp', '.mm']);
-    const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'Pods', '.build', 'DerivedData', 'vendor', '__pycache__', '.venv', 'target']);
+    const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'Pods', 'Carthage', '.build', 'DerivedData', 'vendor', '__pycache__', '.venv', 'target']);
     const MAX_FILES = 300;
 
     const files = [];
@@ -889,7 +889,7 @@ export class SpmService {
       // 非 SPM 项目：直接扫描常见源码目录（fallback）
       this.#logger.info('[SpmService] scanProject: No SPM targets, falling back to directory scan');
       const CODE_EXTS = new Set(['.swift', '.m', '.mm', '.h', '.js', '.ts', '.tsx', '.jsx', '.py', '.java', '.kt', '.go', '.rs', '.rb', '.vue', '.mjs', '.cjs']);
-      const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'Pods', '.build', 'DerivedData', 'vendor', '__pycache__', '.venv', 'target']);
+      const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'Pods', 'Carthage', '.build', 'DerivedData', 'vendor', '__pycache__', '.venv', 'target']);
       const srcDirs = ['Sources', 'src', 'lib', 'app', 'pages', 'components', 'modules', 'packages'];
 
       const walkDir = (dir, targetName) => {

package/package.json

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

package/templates/copilot-instructions.md

@@ -9,6 +9,7 @@
 ## 知识库与结构
 - 知识库根目录：`AutoSnippet/`（用户项目可通过 boxspec `knowledgeBase.dir` 自定义）
 - Recipe：`AutoSnippet/recipes/*.md`（Markdown + Frontmatter + Snippet + Usage Guide）
+- **Project Skills**：`AutoSnippet/skills/<name>/SKILL.md`（项目级 AI 知识增强文档，跟随 Git）
 - constitution.yaml：`AutoSnippet/constitution.yaml`（权限宪法：角色 + 能力 + 治理规则）
 - 运行时 DB：`.autosnippet/autosnippet.db`（SQLite，recipes/candidates/snippets 索引缓存）
 - 向量索引：`.autosnippet/context/`（`asd embed` 生成）
@@ -51,14 +52,21 @@
 - `autosnippet_submit_draft_recipes` — 解析草稿 Markdown 文件
 - `autosnippet_enrich_candidates` — AI 补全缺失语义字段
 
-### 项目扫描
+### 项目扫描 & 冷启动
 - `autosnippet_get_targets` / `autosnippet_get_target_files` / `autosnippet_get_target_metadata`
 - `autosnippet_scan_project` — 轻量探查（文件清单 + Guard 审计）
-- `autosnippet_bootstrap_knowledge` — 冷启动知识库初始化（9 大知识维度）
+- `autosnippet_bootstrap_knowledge` — 冷启动知识库初始化（9 维度 + 自动生成 Project Skills）
+- `autosnippet_bootstrap_refine` — Bootstrap 候选 AI 润色（summary/insight/relations）
 
 ### Guard & 治理
 - `autosnippet_guard_check` / `autosnippet_guard_audit_files` / `autosnippet_compliance_report`
 
+### Skills
+- `autosnippet_list_skills` — 列出所有可用 Skills（内置 + 项目级）
+- `autosnippet_load_skill` — 加载 Skill 完整文档
+- `autosnippet_create_skill` — 创建项目级 Skill（写入 `AutoSnippet/skills/`）
+- `autosnippet_suggest_skills` — 基于使用模式推荐创建 Skill
+
 ### 其它
 - `autosnippet_health` / `autosnippet_capabilities` / `autosnippet_confirm_usage`
 
@@ -67,10 +75,19 @@
 - Frontmatter 必填字段（7）：`title`、`trigger`（@开头）、`category`（8 选 1）、`language`、`summary_cn`、`summary_en`、`headers`。
 - Usage Guide 必须用 `###` 三级标题分段，列表式书写，禁止一行文字墙。
 
+## Project Skills
+- **发现**：`autosnippet_list_skills` — 列出所有可用 Skills（内置 + 项目级）
+- **加载**：`autosnippet_load_skill(skillName)` — 获取 Skill 完整操作指南
+- **创建**：`autosnippet_create_skill(name, description, content)` — 创建项目级 Skill
+- **推荐**：`autosnippet_suggest_skills` — 基于使用模式推荐创建 Skill
+- **Bootstrap 自动生成**：冷启动 Phase 5.5 自动生成 4 个 Project Skills（code-standard, architecture, project-profile, agent-guidelines）
+- **优先级**：项目级 Skill 同名覆盖内置；宏观知识查 Skill，微观代码模式查 Recipe
+
 ## 推荐工作流
 - **查找**：`autosnippet_search`（推荐）或 `autosnippet_context_search`（上下文感知）。
 - **产出候选**：`autosnippet_validate_candidate` 预校验 → `autosnippet_submit_candidate` 提交。
-- **批量扫描**：`autosnippet_bootstrap_knowledge`（冷启动）→ 按 analysisFramework 逐维度分析 → `autosnippet_submit_candidates`。
+- **冷启动**：`autosnippet_bootstrap_knowledge` → `autosnippet_enrich_candidates` → `autosnippet_bootstrap_refine` → 逐 Target 深入 → `autosnippet_submit_candidates`。
+- **Skills 创建**：`autosnippet_suggest_skills` 分析 → `autosnippet_create_skill` 固化知识。
 - **采纳反馈**：`autosnippet_confirm_usage`（记录使用量影响排序权重）。
 
 ## 与 Cursor 规则联动

package/templates/cursor-rules/autosnippet-conventions.mdc

@@ -41,9 +41,19 @@ Recipes are classified into three kinds:
 - **Retry policy**: If an MCP call fails, do not retry within the same agent turn; fall back to static docs or already-read context.
 - **Adoption tracking**: Tool `autosnippet_confirm_usage` records that a Recipe was adopted or applied (affects usage stats and authority ranking). Show it when the user explicitly adopts a recipe, not immediately after presenting one.
 - **Batch scan**: Ask Cursor in natural language (e.g. "scan all targets in this project", "batch extract candidates") to trigger the batch-scan workflow. The workflow calls `autosnippet_get_targets` → `autosnippet_get_target_files` → extract per file → `autosnippet_submit_candidates` automatically.
-- **Cold start**: Use `autosnippet_bootstrap_knowledge` for full project knowledge initialization covering 9 dimensions (project norms, usage patterns, architecture, code patterns, best practices, bug fixes, knowledge graph, library characteristics, agent dev notes).
+- **Cold start**: Use `autosnippet_bootstrap_knowledge` for full project knowledge initialization covering 9 dimensions. Phase 5.5 auto-generates 4 Project Skills (code-standard, architecture, project-profile, agent-guidelines) to `AutoSnippet/skills/`.
 
-## MCP tools (31 total)
+## Project Skills
+
+- **Skills 目录**: `AutoSnippet/skills/<name>/SKILL.md` — 跟随项目 Git 管理
+- **发现**: `autosnippet_list_skills` — 列出所有可用 Skills（内置 + 项目级）
+- **加载**: `autosnippet_load_skill(skillName)` — 获取 Skill 完整文档
+- **创建**: `autosnippet_create_skill(name, description, content)` — 创建项目级 Skill
+- **推荐**: `autosnippet_suggest_skills` — 基于使用模式推荐创建 Skill
+- **优先级**: 项目级 Skill 同名覆盖内置 Skill；Skill > Recipe（宏观知识优先查 Skill）
+- **Bootstrap 自动生成**: 冷启动会自动生成 `project-code-standard`、`project-architecture`、`project-profile`、`project-agent-guidelines` 四个 Project Skills
+
+## MCP tools (36 total)
 
 ### Search (prefer search / context_search)
 - `autosnippet_search` — Unified search (auto: BM25 + semantic fusion)
@@ -66,14 +76,21 @@ Recipes are classified into three kinds:
 - `autosnippet_submit_draft_recipes` — Parse draft Markdown files
 - `autosnippet_enrich_candidates` — AI-fill missing semantic fields
 
-### Project scanning
+### Project scanning & bootstrap
 - `autosnippet_get_targets` / `autosnippet_get_target_files` / `autosnippet_get_target_metadata`
 - `autosnippet_scan_project` — Lightweight probe (file list + Guard audit)
-- `autosnippet_bootstrap_knowledge` — Cold-start knowledge initialization
+- `autosnippet_bootstrap_knowledge` — Cold-start knowledge initialization (9 dimensions + auto Project Skills)
+- `autosnippet_bootstrap_refine` — AI refinement for bootstrap candidates (summary/insight/relations)
 
 ### Guard & governance
 - `autosnippet_guard_check` / `autosnippet_guard_audit_files` / `autosnippet_compliance_report`
 
+### Skills
+- `autosnippet_list_skills` — List all available Skills (builtin + project)
+- `autosnippet_load_skill` — Load a Skill's full document
+- `autosnippet_create_skill` — Create a project-level Skill in `AutoSnippet/skills/`
+- `autosnippet_suggest_skills` — Recommend Skills based on usage patterns
+
 ### Other
 - `autosnippet_health` / `autosnippet_capabilities` / `autosnippet_confirm_usage`
 

package/templates/cursor-rules/autosnippet-skills.mdc

@@ -0,0 +1,45 @@
+---
+description: AutoSnippet Project Skills — 项目级知识增强文档索引与使用指引
+alwaysApply: true
+---
+
+# AutoSnippet Project Skills
+
+Project Skills 是针对当前项目自动生成或手动创建的 AI Agent 知识增强文档。
+它们存放在 `AutoSnippet/skills/` 目录下，跟随项目 Git 管理。
+
+## 如何发现与加载
+
+1. **列出所有 Skills**：调用 `autosnippet_list_skills` 查看当前可用的 Skills（含内置 + 项目级）
+2. **加载完整内容**：调用 `autosnippet_load_skill(skillName)` 获取具体 Skill 的完整文档
+3. **按需加载**：不确定该用哪个 Skill 时，先加载 `autosnippet-intent` 做意图路由
+4. **创建 Skill**：调用 `autosnippet_create_skill(name, description, content)` 创建项目级 Skill
+5. **Skill 推荐**：调用 `autosnippet_suggest_skills` 获取基于使用模式的 Skill 创建建议
+
+## Bootstrap 自动生成的 Project Skills
+
+冷启动（`autosnippet_bootstrap_knowledge`）Phase 5.5 会自动为 4 个宏观维度生成 Project Skills：
+
+| Skill | 维度 | 说明 |
+|-------|------|------|
+| `project-code-standard` | 代码规范 | 命名约定、文件组织规范 |
+| `project-architecture` | 架构模式 | 分层架构、模块边界、依赖图 |
+| `project-profile` | 项目特征 | 技术栈、模块结构、代码指标 |
+| `project-agent-guidelines` | Agent 约束 | 强制规则、TODO/FIXME、WARNING |
+
+生成后的 Skill 文件位于 `AutoSnippet/skills/<name>/SKILL.md`，自动跟随 Git。
+调用 `autosnippet_load_skill` 可加载完整内容。
+
+## 推荐工作流
+
+冷启动完整流程：
+1. `autosnippet_bootstrap_knowledge` — 9 维度分析 + 自动生成 Project Skills
+2. `autosnippet_enrich_candidates` — 补全缺失语义字段
+3. `autosnippet_bootstrap_refine` — AI 润色 summary/insight/relations
+4. 逐 Target 深入分析 → `autosnippet_submit_candidates`
+
+## 使用优先级
+
+- **Project Skills > 内置 Skills**：同名时项目级覆盖内置
+- **Skill > Recipe**：宏观架构/规范知识优先查 Skill，微观代码模式查 Recipe
+- **Skills 是只读参考**：不要直接修改 SKILL.md，应通过 `autosnippet_create_skill` 工具创建或更新