autosnippet 3.2.17 → 3.2.20

package/dist/lib/service/delivery/AgentInstructionsGenerator.js

@@ -8,17 +8,17 @@
  *
  * 设计原则：
  *   1. 内容来源统一 — 从 _loadEntries() 已加载的知识条目中提取
- *   2. 格式差异化 — 同一数据按目标工具特性适配输出
+ *   2. 互补不重复 — .mdc 处理行为规则，Channel F 处理项目知识
  *   3. 轻量索引 — 只输出摘要和规则，详细内容引导至 MCP 工具
  *   4. 幂等生成 — 每次 deliver 重写全部文件，不做增量 diff
  */
 import fs from 'node:fs';
 import path from 'node:path';
+import { TEMPLATES_DIR } from '../../shared/package-root.js';
 import { checkWriteSafety, safeWriteFile } from './FileProtection.js';
 import { estimateTokens } from './TokenBudget.js';
 /**
  * Agent 指令文件 token 预算
- * AGENTS.md / CLAUDE.md 不受 Cursor 200K 限制，但需控制体积以便 Agent 快速消化
  */
 const AGENT_BUDGET = Object.freeze({
     MAX_RULES: 15,
@@ -28,6 +28,10 @@ const AGENT_BUDGET = Object.freeze({
 });
 /** MCP 工具清单 — 精简版（跟随实际 MCP handler 注册名称） */
 const MCP_TOOLS_SUMMARY = [
+    {
+        name: 'autosnippet_task',
+        desc: 'Task & decision management: prime (CALL FIRST every message) / create/claim/close/fail/defer/progress/decompose / record_decision/revise_decision',
+    },
     {
         name: 'autosnippet_search',
         desc: 'Search knowledge base (mode: auto/context/keyword/semantic)',
@@ -47,13 +51,9 @@ const MCP_TOOLS_SUMMARY = [
     { name: 'autosnippet_guard', desc: 'Code compliance check (single file or batch audit)' },
     { name: 'autosnippet_structure', desc: 'Project structure discovery (targets/files/metadata)' },
     { name: 'autosnippet_graph', desc: 'Knowledge graph query (query/impact/path/stats)' },
-    { name: 'autosnippet_skill', desc: 'Skill management (list/load/create/update/delete/suggest)' },
+    { name: 'autosnippet_skill', desc: 'Skill management (list/load/create/update/delete)' },
     { name: 'autosnippet_save_document', desc: 'Save development document (auto-publish)' },
-    { name: 'autosnippet_bootstrap', desc: 'Project cold-start & scan (knowledge/refine/scan)' },
-    {
-        name: 'autosnippet_task',
-        desc: 'Unified task & decision management: prime (session entry, CALL FIRST) / create/claim/close/fail/defer/progress/decompose (task CRUD) / record_decision/revise_decision/unpin_decision/list_decisions (decisions)',
-    },
+    { name: 'autosnippet_bootstrap', desc: 'Project cold-start & scan' },
     { name: 'autosnippet_health', desc: 'Service health & KB statistics' },
     { name: 'autosnippet_capabilities', desc: 'List all available MCP tools (self-discovery)' },
 ];
@@ -78,15 +78,18 @@ export class AgentInstructionsGenerator {
         const startTime = Date.now();
         // 构建共享内容块
         const sections = this._buildSections({ rules, patterns, skills });
-        // 避免 IDE 上下文重复：
-        //   - 不自动生成 CLAUDE.md（用户自己维护）
-        //   - 如果项目已有 CLAUDE.md，跳过 AGENTS.md（避免两份文件同时注入 IDE 上下文）
+        // AGENTS.md 与 CLAUDE.md 互斥（双向）：
+        //   有 CLAUDE.md → 走 CLAUDE.md 路线（跳过 AGENTS.md）
+        //   否则 → 走 AGENTS.md 路线（跳过 CLAUDE.md）
         const claudePath = path.join(this.projectRoot, 'CLAUDE.md');
-        const hasClaudeMd = fs.existsSync(claudePath);
-        const agents = hasClaudeMd
-            ? { filePath: path.join(this.projectRoot, 'AGENTS.md'), tokensUsed: 0, skipped: true }
+        const agentsPath = path.join(this.projectRoot, 'AGENTS.md');
+        const useClaudeMode = fs.existsSync(claudePath);
+        const agents = useClaudeMode
+            ? { filePath: agentsPath, tokensUsed: 0, skipped: true }
             : this._writeAgentsMd(sections);
-        const claude = { filePath: claudePath, tokensUsed: 0, skipped: true }; // 不自动生成
+        const claude = useClaudeMode
+            ? this._writeClaudeMd(sections)
+            : { filePath: claudePath, tokensUsed: 0, skipped: true };
         const copilot = this._writeCopilotInstructions(sections);
         const duration = Date.now() - startTime;
         const allResults = [agents, claude, copilot];
@@ -114,7 +117,6 @@ export class AgentInstructionsGenerator {
     // ─── 内容构建 ──────────────────────────────────────
     /**
      * 从知识条目构建共享内容段
-     * @private
      */
     _buildSections({ rules, patterns, skills, }) {
         // 编码规则（Channel A 格式，一行一条）
@@ -157,103 +159,64 @@ export class AgentInstructionsGenerator {
         return { ruleLines, patternRows, skillLines, toolLines };
     }
     // ─── AGENTS.md ─────────────────────────────────────
-    /** @private */
     _writeAgentsMd(sections) {
         const lines = [
             `# ${this.projectName} — Agent Instructions`,
             '',
-            '> Auto-generated by [AutoSnippet](https://github.com/anthropic/autosnippet). Do not edit manually.',
-            '> This file is regenerated when the knowledge base changes.',
-            '',
-            '## Project Knowledge Base',
-            '',
-            `This project uses **AutoSnippet** as its knowledge management system.`,
-            `The knowledge base contains coding standards, architecture patterns, and best practices`,
-            `accessible through MCP tools.`,
+            '> Auto-generated by [AutoSnippet](https://github.com/GxFn/AutoSnippet). Do not edit manually.',
             '',
-            ...this._renderConstraints(),
+            'This project uses **AutoSnippet** for knowledge management.',
+            'Access the knowledge base through MCP tools.',
             '',
         ];
         // Coding Standards
         if (sections.ruleLines.length > 0) {
-            lines.push('## Coding Standards', '');
-            lines.push(...sections.ruleLines);
-            lines.push('');
+            lines.push('## Coding Standards', '', ...sections.ruleLines, '');
         }
         // Architecture Patterns
         if (sections.patternRows.length > 0) {
-            lines.push('## Architecture Patterns', '');
-            lines.push('| Trigger | When | Do |');
-            lines.push('|---------|------|----|');
-            lines.push(...sections.patternRows);
-            lines.push('');
+            lines.push('## Architecture Patterns', '', '| Trigger | When | Do |', '|---------|------|----|', ...sections.patternRows, '');
         }
         // MCP Tools
-        lines.push('## MCP Tools (AutoSnippet)', '');
-        lines.push('Use these MCP tools to access the full knowledge base:', '');
-        lines.push(...sections.toolLines);
-        lines.push('');
+        lines.push('## MCP Tools', '', ...sections.toolLines, '');
         // Skills
         if (sections.skillLines.length > 0) {
-            lines.push('## Available Skills', '');
-            lines.push('Load with `autosnippet_skill({ operation: "load", name: "<skill>" })`:', '');
-            lines.push(...sections.skillLines);
-            lines.push('');
+            lines.push('## Skills', '', 'Load with `autosnippet_skill({ operation: "load", name: "<skill>" })`:', '', ...sections.skillLines, '');
         }
-        // Workflow
-        lines.push(...this._renderWorkflow());
+        // Constraints
+        lines.push('## Constraints', '', '1. Do NOT modify knowledge base files directly (`AutoSnippet/recipes/`, `.autosnippet/`).', '2. Prefer Recipes as project standards; source code is supplementary.', '3. Create or update knowledge only through MCP tools.', '');
         const content = `${lines.join('\n')}\n`;
         const filePath = path.join(this.projectRoot, 'AGENTS.md');
         const result = safeWriteFile(filePath, content, { logger: this.logger });
         return { filePath, tokensUsed: estimateTokens(content), skipped: !result.written };
     }
     // ─── CLAUDE.md ─────────────────────────────────────
-    /** @private */
     _writeClaudeMd(sections) {
         const lines = [
             `# ${this.projectName} — Claude Code Instructions`,
             '',
             '> Auto-generated by AutoSnippet. Regenerated when knowledge base changes.',
             '',
+            'This project uses **AutoSnippet** for knowledge management.',
+            'Access the knowledge base through MCP tools.',
+            '',
         ];
-        // Constraints (Claude prefers clear bullet points)
-        lines.push(...this._renderConstraints());
-        lines.push('');
         // Coding Standards
         if (sections.ruleLines.length > 0) {
-            lines.push('## Coding Standards', '');
-            lines.push('These are mandatory project rules extracted from the knowledge base:', '');
-            lines.push(...sections.ruleLines);
-            lines.push('');
+            lines.push('## Coding Standards', '', ...sections.ruleLines, '');
         }
-        // Patterns (Claude benefits from When/Do format)
+        // Patterns
         if (sections.patternRows.length > 0) {
-            lines.push('## Key Patterns', '');
-            lines.push('| Trigger | When | Do |');
-            lines.push('|---------|------|----|');
-            lines.push(...sections.patternRows);
-            lines.push('');
+            lines.push('## Key Patterns', '', '| Trigger | When | Do |', '|---------|------|----|', ...sections.patternRows, '');
         }
         // MCP — Claude Code natively supports MCP
-        lines.push('## MCP Integration', '');
-        lines.push('This project has an AutoSnippet MCP server configured. ', 'Use the following tools to access project knowledge:', '');
-        lines.push(...sections.toolLines);
-        lines.push('');
-        // Key tools highlight for Claude
-        lines.push('### Task Workflow', '');
-        lines.push('1. **Every message → `autosnippet_task({ operation: "prime" })`** — Load decisions + tasks + knowledge context (ALWAYS FIRST)');
-        lines.push('2. **Create task for non-trivial work** — ≥2 files OR ≥10 lines → `create` → `claim` → code → `close`');
-        lines.push('3. **User agrees/disagrees → `autosnippet_task({ operation: "record_decision" })`** — Persist decision immediately');
-        lines.push('4. **Before writing code**: `autosnippet_search({ query: "<topic>" })` to find relevant patterns');
-        lines.push('5. **Complete task**: `autosnippet_task({ operation: "close", id: "<id>", reason: "..." })`');
-        lines.push('6. **Session end**: Close or defer ALL in_progress tasks — zero in_progress on exit');
-        lines.push('');
+        lines.push('## MCP Tools', '', ...sections.toolLines, '');
         // Skills
         if (sections.skillLines.length > 0) {
-            lines.push('## Skills', '');
-            lines.push(...sections.skillLines);
-            lines.push('');
+            lines.push('## Skills', '', ...sections.skillLines, '');
         }
+        // Constraints
+        lines.push('', '## Constraints', '', '1. Do NOT modify knowledge base files directly (`AutoSnippet/recipes/`, `.autosnippet/`).', '2. Prefer Recipes as project standards; source code is supplementary.', '3. Create or update knowledge only through MCP tools.', '');
         const content = `${lines.join('\n')}\n`;
         const filePath = path.join(this.projectRoot, 'CLAUDE.md');
         const result = safeWriteFile(filePath, content, { logger: this.logger });
@@ -262,50 +225,20 @@ export class AgentInstructionsGenerator {
     // ─── copilot-instructions.md ───────────────────────
     /**
      * 动态生成 copilot-instructions.md
-     * 替代原有的静态模板复制
-     * @private
+     * 读取 templates/instructions/conventions.md + HTML markers
      */
-    _writeCopilotInstructions(sections) {
-        const lines = [
-            '# AutoSnippet Copilot Instructions',
+    _writeCopilotInstructions(_sections) {
+        const body = this._loadConventionsTemplate();
+        const content = [
+            '<!-- autosnippet:begin -->',
             '',
-            '## Project Overview',
-            `- Project: **${this.projectName}**`,
-            '- Knowledge System: AutoSnippet V3 (ESM, SQLite, MCP)',
-            '- Knowledge Base: `AutoSnippet/` directory (recipes, skills, constitution)',
+            '# AutoSnippet Conventions',
             '',
-            ...this._renderConstraints(),
+            body,
             '',
-        ];
-        // Coding Standards
-        if (sections.ruleLines.length > 0) {
-            lines.push('## Coding Standards', '');
-            lines.push(...sections.ruleLines);
-            lines.push('');
-        }
-        // MCP Tools (compact for Copilot)
-        lines.push('## MCP Tools', '');
-        lines.push('Access the knowledge base through MCP:', '');
-        // Copilot: show fewer, most essential tools
-        const essentialTools = [
-            '- `autosnippet_search` — Search knowledge (mode: auto/context/keyword/semantic)',
-            '- `autosnippet_knowledge` — Browse/get recipes (operation: list/get/insights)',
-            '- `autosnippet_submit_knowledge` — Submit candidate (strict validation, all fields required)',
-            '- `autosnippet_guard` — Code compliance check',
-            '- `autosnippet_skill` — Load project skills (list/load)',
-            '- `autosnippet_health` — Service health & KB stats',
-        ];
-        lines.push(...essentialTools);
-        lines.push('');
-        // Knowledge Types
-        lines.push('## Knowledge Types', '');
-        lines.push('- **rule** — Coding standards, enforced by Guard');
-        lines.push('- **pattern** — Reusable code patterns and architecture');
-        lines.push('- **fact** — Structural knowledge (relations, data flow)');
-        lines.push('');
-        // Workflow
-        lines.push(...this._renderWorkflow());
-        const content = `${lines.join('\n')}\n`;
+            '<!-- autosnippet:end -->',
+            '',
+        ].join('\n');
         const destDir = path.join(this.projectRoot, '.github');
         const filePath = path.join(destDir, 'copilot-instructions.md');
         const { canWrite } = checkWriteSafety(filePath);
@@ -315,83 +248,14 @@ export class AgentInstructionsGenerator {
         const result = safeWriteFile(filePath, content, { logger: this.logger });
         return { filePath, tokensUsed: estimateTokens(content), skipped: !result.written };
     }
-    // ─── 共享模板片段 ──────────────────────────────────
-    /**
-     * 核心约束（所有 Agent 共享）
-     * @private
-     */
-    _renderConstraints() {
-        return [
-            "## CRITICAL: You Operate autosnippet_task — The User Doesn't",
-            '',
-            'You are the task operator. Users speak naturally; you translate to task operations.',
-            "DO NOT tell users to call autosnippet_task. That's YOUR job.",
-            '',
-            '- WRONG: "You can run autosnippet_task({ operation: \'create\' }) to create a task"',
-            '- RIGHT: *(you run create yourself and tell the user "Created task asd-42: Fix login bug")*',
-            '',
-            '## Task Tracking Rules (MANDATORY)',
-            '',
-            '1. **MUST prime on EVERY message** — `autosnippet_task({ operation: "prime" })` BEFORE anything else. No exceptions.',
-            '2. **MUST create task for non-trivial work** — ≥2 files OR ≥10 lines → create BEFORE starting.',
-            '3. **MUST claim before coding** — `autosnippet_task({ operation: "claim", id })` then code.',
-            '4. **MUST close when done** — `autosnippet_task({ operation: "close", id, reason })` with meaningful reason.',
-            '5. **MUST handle unfinished tasks first** — If prime shows in-progress, ask user: Continue, Defer, Abandon? Do NOT auto-resume.',
-            '6. **NEVER skip prime** — Even for follow-up messages.',
-            '7. **NEVER start new work with open in-progress tasks** — Handle existing first.',
-            '8. **NEVER leave tasks in in_progress when session ends** — Close or defer everything.',
-            '9. **NEVER tell the user to run task commands** — You are the operator.',
-            '',
-            'When in doubt → create a task. When idle → `autosnippet_task({ operation: "ready" })`.',
-            '',
-            '**When NOT to create**: Quick questions, single-file trivial fixes (<10 lines), code explanation, running tests.',
-            '',
-            '## Knowledge Rules',
-            '',
-            '1. **User agrees/disagrees with a plan → `autosnippet_task({ operation: "record_decision" })` immediately** — Persist team memory first.',
-            '2. **Do NOT modify** knowledge base files directly (`AutoSnippet/recipes/`, `.autosnippet/`).',
-            '3. **Prefer Recipes** as project standards; source code is supplementary.',
-            '4. Use `autosnippet_search` for knowledge retrieval; do not retry on failure in the same turn.',
-            '5. Skills handle semantics and workflow; MCP handles capabilities — do not hardcode URLs in Skills.',
-        ];
-    }
+    // ─── 模板读取 ──────────────────────────────────────
     /**
-     * 推荐工作流（AGENTS.md 用）
-     * @private
+     * 读取 templates/instructions/conventions.md — 唯一内容源
+     * .mdc、copilot-instructions.md、Channel F 动态版全部从这里读取
      */
-    _renderWorkflow() {
-        return [
-            '## User Says → You Run',
-            '',
-            '| User Says | Your Action |',
-            '|---|---|',
-            '| "Fix this bug" / "帮我修 bug" | `create` → `claim` → code → `close` |',
-            '| "Implement this" / "做功能" | `create` → `claim` → code → `close` |',
-            '| "Continue" / "继续" | resume in-progress → code → `close` |',
-            '| "Pause" / "先不做了" | `defer(id, reason)` |',
-            '| "Abandon" / "不做了" | `fail(id, reason)` |',
-            '| "Break it down" / "太大了" | `decompose(id, subtasks)` |',
-            '| "What\'s next" / "有什么要做的" | `ready()` → present list |',
-            '| "Agreed" / "就这么定了" | `record_decision(...)` |',
-            '| Quick question (no code) | No task. Just answer. |',
-            '',
-            '## Session Closing Protocol',
-            '',
-            'Before ending work, you MUST complete this checklist:',
-            '',
-            '- [ ] Close every claimed task with reason describing what was accomplished',
-            '- [ ] Defer any incomplete tasks with notes on why and what remains',
-            '- [ ] Verify zero tasks in in_progress state',
-            '- [ ] If prime showed ready tasks, mention them to the user for next session',
-            '',
-            '**Work is not done until all tasks are closed or deferred.**',
-            '',
-            '## Context Pressure',
-            '',
-            '- `_contextHint: CONTEXT_PRESSURE:WARNING` → Summarize completed work, then continue',
-            '- `_contextHint: CONTEXT_PRESSURE:CRITICAL` → Call `autosnippet_task({ operation: "prime" })` immediately',
-            '',
-        ];
+    _loadConventionsTemplate() {
+        const tplPath = path.join(TEMPLATES_DIR, 'instructions/conventions.md');
+        return fs.readFileSync(tplPath, 'utf8').trimEnd();
     }
 }
 export default AgentInstructionsGenerator;

package/dist/lib/service/delivery/CursorDeliveryPipeline.d.ts

@@ -91,12 +91,15 @@ export declare class CursorDeliveryPipeline {
         };
         channelC: {
             synced: number;
+            builtinSynced: number;
+            projectSynced: number;
             skipped: number;
             errors: number;
             details: {
                 synced: string[];
                 skipped: string[];
                 errors: string[];
+                builtinSynced: string[];
             };
         };
         channelD: {
@@ -155,18 +158,15 @@ export declare class CursorDeliveryPipeline {
     }>;
     /**
      * 加载知识条目（active + high-confidence pending）
-     * @private
      */
     _loadEntries(): Promise<KnowledgeEntryProps[]>;
     /**
      * 从 KnowledgeService.list() 返回值提取条目数组
-     * @private
      */
     _extractItems(result: unknown): KnowledgeEntryProps[];
     /**
      * 按 kind 分类知识条目
      * dev-document 类型单独分流，不进入 Channel A/B 压缩
-     * @private
      */
     _classify(entries: KnowledgeEntryProps[]): {
         rules: KnowledgeEntryProps[];
@@ -176,17 +176,14 @@ export declare class CursorDeliveryPipeline {
     };
     /**
      * 排序 — 质量分 + 统计使用量
-     * @private
      */
     _rank(entries: KnowledgeEntryProps[]): KnowledgeEntryProps[];
     /**
      * 计算排名分
-     * @private
      */
     _rankScore(entry: KnowledgeEntryProps): number;
     /**
      * Channel A 生成
-     * @private
      */
     _generateChannelA(rules: KnowledgeEntryProps[]): {
         filePath: string;
@@ -201,7 +198,6 @@ export declare class CursorDeliveryPipeline {
      * Channel B 生成（patterns + facts）
      * @param patterns kind='pattern' 的知识条目
      * @param [facts=[]] kind='fact' 的知识条目
-     * @private
      */
     _generateChannelB(patterns: KnowledgeEntryProps[], facts?: KnowledgeEntryProps[]): {
         topicCount: number;
@@ -217,7 +213,6 @@ export declare class CursorDeliveryPipeline {
     /**
      * Channel B+ — Call Graph Architecture Rules (Phase 5.2)
      * 从调用图拓扑分析架构分层，生成 architecture smart rule
-     * @private
      * @returns |null}
      */
     _generateCallGraphArchitectureRules(): {
@@ -227,28 +222,28 @@ export declare class CursorDeliveryPipeline {
     } | null;
     /**
      * 从文件路径中提取层级目录 (第一或第二级有意义的目录)
-     * @private
      */
     _extractLayerDir(filePath: string): string | null;
     /**
      * Channel C 生成
-     * @private
      */
     _generateChannelC(): Promise<{
         synced: number;
+        builtinSynced: number;
+        projectSynced: number;
         skipped: number;
         errors: number;
         details: {
             synced: string[];
             skipped: string[];
             errors: string[];
+            builtinSynced: string[];
         };
     }>;
     /**
      * Channel D — Dev Documents 生成
      * 将 knowledgeType='dev-document' 的条目以原始 MD 写入
      * .cursor/skills/autosnippet-devdocs/references/ 目录
-     * @private
      */
     _generateChannelD(documents: KnowledgeEntryProps[]): {
         documentsCount: number;
@@ -258,7 +253,6 @@ export declare class CursorDeliveryPipeline {
     /**
      * Channel F — Agent Instructions 生成
      * 生成 AGENTS.md / CLAUDE.md / .github/copilot-instructions.md
-     * @private
      */
     _generateChannelF(rules: KnowledgeEntryProps[], patterns: KnowledgeEntryProps[]): {
         filesWritten: number;
@@ -279,24 +273,20 @@ export declare class CursorDeliveryPipeline {
     };
     /**
      * 文件名安全 slug 化
-     * @private
      */
     _slugify(text: string): string;
     /**
      * 镜像 .cursor/ 交付物料到目标 IDE 目录（Qoder / Trae 等兼容 IDE）
      * 只复制 autosnippet- 前缀的文件/目录，不触碰用户自定义内容
      * @param targetDirName 目标目录名，如 '.qoder' 或 '.trae'
-     * @private
      */
     _mirrorToIDE(targetDirName: string): void;
     /**
      * 递归复制目录
-     * @private
      */
     _copyDirRecursive(src: string, dest: string): void;
     /**
      * 从项目路径推断项目名称
-     * @private
      */
     _inferProjectName(projectRoot: string): string;
 }

package/dist/lib/service/delivery/CursorDeliveryPipeline.js

@@ -88,6 +88,12 @@ export class CursorDeliveryPipeline {
             // ── Channel A: Always-On Rules ──
             const channelA = this._generateChannelA(rules);
             stats.channelA = channelA;
+            // ── Baseline: 零知识库时注入基础引导 ──
+            if (entries.length === 0 && channelA.rulesCount === 0) {
+                const baseline = this.rulesGenerator.writeBaselineRules();
+                stats.channelA = { rulesCount: 0, tokensUsed: baseline.tokensUsed };
+                this.logger.info?.('[CursorDelivery] Baseline rules written (zero knowledge entries)');
+            }
             // ── Channel B: Smart Rules (by topic) + Facts ──
             const channelB = this._generateChannelB(patterns, facts);
             stats.channelB = channelB;
@@ -132,7 +138,6 @@ export class CursorDeliveryPipeline {
     // ─── 内部方法 ───────────────────────────────────────
     /**
      * 加载知识条目（active + high-confidence pending）
-     * @private
      */
     async _loadEntries() {
         const allEntries = [];
@@ -164,7 +169,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 从 KnowledgeService.list() 返回值提取条目数组
-     * @private
      */
     _extractItems(result) {
         if (Array.isArray(result)) {
@@ -182,7 +186,6 @@ export class CursorDeliveryPipeline {
     /**
      * 按 kind 分类知识条目
      * dev-document 类型单独分流，不进入 Channel A/B 压缩
-     * @private
      */
     _classify(entries) {
         const rules = [], patterns = [], facts = [], documents = [];
@@ -204,7 +207,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 排序 — 质量分 + 统计使用量
-     * @private
      */
     _rank(entries) {
         return [...entries].sort((a, b) => {
@@ -215,7 +217,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 计算排名分
-     * @private
      */
     _rankScore(entry) {
         const qual = entry.quality;
@@ -233,7 +234,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * Channel A 生成
-     * @private
      */
     _generateChannelA(rules) {
         const topRules = this._rank(rules).slice(0, BUDGET.CHANNEL_A_MAX_RULES);
@@ -250,7 +250,6 @@ export class CursorDeliveryPipeline {
      * Channel B 生成（patterns + facts）
      * @param patterns kind='pattern' 的知识条目
      * @param [facts=[]] kind='fact' 的知识条目
-     * @private
      */
     _generateChannelB(patterns, facts = []) {
         const result = { topicCount: 0, patternsCount: 0, factsCount: 0, totalTokens: 0, topics: {} };
@@ -304,7 +303,6 @@ export class CursorDeliveryPipeline {
     /**
      * Channel B+ — Call Graph Architecture Rules (Phase 5.2)
      * 从调用图拓扑分析架构分层，生成 architecture smart rule
-     * @private
      * @returns |null}
      */
     _generateCallGraphArchitectureRules() {
@@ -435,7 +433,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 从文件路径中提取层级目录 (第一或第二级有意义的目录)
-     * @private
      */
     _extractLayerDir(filePath) {
         if (!filePath) {
@@ -453,15 +450,17 @@ export class CursorDeliveryPipeline {
     }
     /**
      * Channel C 生成
-     * @private
      */
     async _generateChannelC() {
         try {
             const syncResult = await this.skillsSyncer.sync();
-            this.logger.info?.(`[CursorDelivery] Channel C: ${syncResult.synced.length} synced, ` +
+            this.logger.info?.(`[CursorDelivery] Channel C: ${syncResult.builtinSynced.length} builtin + ` +
+                `${syncResult.synced.length} project synced, ` +
                 `${syncResult.skipped.length} skipped, ${syncResult.errors.length} errors`);
             return {
-                synced: syncResult.synced.length,
+                synced: syncResult.builtinSynced.length + syncResult.synced.length,
+                builtinSynced: syncResult.builtinSynced.length,
+                projectSynced: syncResult.synced.length,
                 skipped: syncResult.skipped.length,
                 errors: syncResult.errors.length,
                 details: syncResult,
@@ -471,9 +470,11 @@ export class CursorDeliveryPipeline {
             this.logger.error?.(`[CursorDelivery] Channel C error: ${err.message}`);
             return {
                 synced: 0,
+                builtinSynced: 0,
+                projectSynced: 0,
                 skipped: 0,
                 errors: 1,
-                details: { synced: [], skipped: [], errors: [err.message] },
+                details: { synced: [], skipped: [], builtinSynced: [], errors: [err.message] },
             };
         }
     }
@@ -481,7 +482,6 @@ 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: [] };
@@ -554,7 +554,6 @@ export class CursorDeliveryPipeline {
     /**
      * Channel F — Agent Instructions 生成
      * 生成 AGENTS.md / CLAUDE.md / .github/copilot-instructions.md
-     * @private
      */
     _generateChannelF(rules, patterns) {
         try {
@@ -594,7 +593,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 文件名安全 slug 化
-     * @private
      */
     _slugify(text) {
         return (text
@@ -607,7 +605,6 @@ export class CursorDeliveryPipeline {
      * 镜像 .cursor/ 交付物料到目标 IDE 目录（Qoder / Trae 等兼容 IDE）
      * 只复制 autosnippet- 前缀的文件/目录，不触碰用户自定义内容
      * @param targetDirName 目标目录名，如 '.qoder' 或 '.trae'
-     * @private
      */
     _mirrorToIDE(targetDirName) {
         try {
@@ -650,7 +647,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 递归复制目录
-     * @private
      */
     _copyDirRecursive(src, dest) {
         fs.mkdirSync(dest, { recursive: true });
@@ -667,7 +663,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 从项目路径推断项目名称
-     * @private
      */
     _inferProjectName(projectRoot) {
         return path.basename(projectRoot);

package/dist/lib/service/delivery/KnowledgeCompressor.d.ts

@@ -65,7 +65,7 @@ export declare class KnowledgeCompressor {
     }[];
     /**
      * 将 Fact 压缩结果格式化为 Markdown 字符串
-     * @param {Array<{ title: string, summary: string }>} factLines
+     * @param factLines
      */
     formatFactLines(factLines: Array<{
         title: string;

package/dist/lib/service/delivery/KnowledgeCompressor.js

@@ -144,7 +144,7 @@ export class KnowledgeCompressor {
     }
     /**
      * 将 Fact 压缩结果格式化为 Markdown 字符串
-     * @param {Array<{ title: string, summary: string }>} factLines
+     * @param factLines
      */
     formatFactLines(factLines) {
         if (factLines.length === 0) {