autosnippet 3.2.18 → 3.2.20

package/dist/lib/platform/ios/spm/SpmDiscoverer.js

@@ -15,7 +15,7 @@ import { PackageSwiftParser } from './PackageSwiftParser.js';
 export class SpmDiscoverer extends ProjectDiscoverer {
     #parser = null;
     #projectRoot = null;
-    /** @type {Array<{ pkgPath: string, parsed: ReturnType<PackageSwiftParser['parse']> }>} */
+    /** >} */
     #parsedPackages = [];
     get id() {
         return 'spm';

package/dist/lib/platform/ios/spm/SpmHelper.js

@@ -21,7 +21,7 @@ export class SpmHelper {
     #targetPackageMap;
     /** 包级依赖图：packagePath → Set<packagePath>（用于跨包循环检测） */
     #packageDepGraph;
-    /** @type {GraphCache} 磁盘缓存层 */
+    /** 磁盘缓存层 */
     #graphCache;
     constructor(projectRoot, options = {}) {
         this.#projectRoot = projectRoot;
@@ -181,7 +181,7 @@ export class SpmHelper {
     // ─────────────── 包级依赖图构建 ───────────────
     /**
      * 解析所有 Package.swift 中的 .package(path: "...") 声明，构建包级依赖图
-     * @param {{ path: string, parsed: object }[]} allParsed
+     * @param allParsed
      */
     #buildPackageDepGraph(allParsed) {
         this.#packageDepGraph.clear();
@@ -392,7 +392,7 @@ export class SpmHelper {
      * 确保 Package.swift 中有对目标包的 .package(path: "...") 声明
      * @param content Package.swift 内容
      * @param fromPkgPath 当前包的 Package.swift 路径
-     * @param {{ packageName: string, packagePath: string }} toPkg 目标包信息
+     * @param toPkg 目标包信息
      * @returns }
      */
     #ensurePackageDependency(content, fromPkgPath, toPkg) {

package/dist/lib/platform/ios/xcode/SaveEventFilter.js

@@ -36,9 +36,9 @@ class SaveEventFilter {
     _contentHashes;
     _selfWrites;
     constructor() {
-        /** @type {Map<string, number>} filePath → 最后一次 self-write 的时间戳 */
+        /** filePath → 最后一次 self-write 的时间戳 */
         this._selfWrites = new Map();
-        /** @type {Map<string, string>} filePath → 上次处理时的内容 MD5 哈希 */
+        /** filePath → 上次处理时的内容 MD5 哈希 */
         this._contentHashes = new Map();
         // 定期清理过期条目，防止内存泄漏
         this._cleanupInterval = setInterval(() => this._cleanup(), 60_000);

package/dist/lib/platform/ios/xcode/XcodeIntegration.js

@@ -90,7 +90,7 @@ export async function insertHeaders(watcher, fullPath, headers, opts = {}) {
     const CM = await import('../../ClipboardManager.js');
     const NU = (await import('../../NativeUi.js'));
     const result = { inserted: [], skipped: [], cancelled: false };
-    /** @type {Map<string, string>} 模块名 → 提示注释（'提示操作插入'按钮选择时记录） */
+    /** 模块名 → 提示注释（'提示操作插入'按钮选择时记录） */
     const depWarnings = opts.depWarnings instanceof Map ? new Map(opts.depWarnings) : new Map();
     if (!headers || headers.length === 0) {
         return result;

package/dist/lib/repository/base/BaseRepository.js

@@ -12,7 +12,7 @@ export class BaseRepository {
     db;
     logger;
     tableName;
-    /** @type {Set<string>|null} lazily-populated column whitelist */
+    /** lazily-populated column whitelist */
     #columnWhitelist = null;
     constructor(database, tableName) {
         // 校验 tableName 防止 SQL 注入（与列名使用相同的标识符规则）

package/dist/lib/repository/task/TaskRepository.impl.d.ts

@@ -64,8 +64,8 @@ export declare class TaskRepositoryImpl {
     db: Database;
     logger: WinstonLogger;
     constructor(database: DatabaseWrapper, drizzle?: DrizzleDB);
-    /** @private 预编译复杂查询（仅保留 drizzle 无法表达的递归 CTE） */
-    _prepareStatements(): void;
+    /** 预编译复杂查询（仅保留 drizzle 无法表达的递归 CTE） */
+    private _prepareStatements;
     /**
      * 创建任务
      * ★ Drizzle 类型安全 INSERT

package/dist/lib/repository/task/TaskRepository.impl.js

@@ -25,7 +25,7 @@ export class TaskRepositoryImpl {
         this.#drizzle = drizzle ?? getDrizzle();
         this._prepareStatements();
     }
-    /** @private 预编译复杂查询（仅保留 drizzle 无法表达的递归 CTE） */
+    /** 预编译复杂查询（仅保留 drizzle 无法表达的递归 CTE） */
     _prepareStatements() {
         // ── 环检测 (递归 CTE) — drizzle 不支持递归 CTE ──
         this._reachableStmt = this.db.prepare(`

package/dist/lib/repository/token/TokenUsageStore.js

@@ -21,7 +21,7 @@ export class TokenUsageStore {
     #dailyStmt;
     #bySourceStmt;
     #summaryStmt;
-    /** @type {{ data: object, expireAt: number } | null} */
+    /** | null} */
     #reportCache = null;
     /** @param db — raw better-sqlite3 instance */
     constructor(db, drizzle) {

package/dist/lib/service/automation/ActionPipeline.d.ts

@@ -13,7 +13,7 @@ export declare class ActionPipeline {
     register(type: string, handler: (trigger: Record<string, unknown>, context: Record<string, unknown>) => Promise<unknown>): void;
     /**
      * 执行管线
-     * @param {{ type: string, name?: string, params?: object }} trigger
+     * @param trigger
      * @returns >}
      */
     execute(trigger: {

package/dist/lib/service/automation/ActionPipeline.js

@@ -20,7 +20,7 @@ export class ActionPipeline {
     }
     /**
      * 执行管线
-     * @param {{ type: string, name?: string, params?: object }} trigger
+     * @param trigger
      * @returns >}
      */
     async execute(trigger, context) {

package/dist/lib/service/bootstrap/BootstrapEventEmitter.js

@@ -7,9 +7,9 @@
  * @module shared/BootstrapEventEmitter
  */
 export class BootstrapEventEmitter {
-    /** @type {object|null} EventBus 实例 */
+    /** EventBus 实例 */
     #eventBus;
-    /** @type {object|null} BootstrapTaskManager 实例 */
+    /** BootstrapTaskManager 实例 */
     #taskManager;
     /** @param container DI Container */
     constructor(container) {

package/dist/lib/service/bootstrap/BootstrapTaskManager.d.ts

@@ -102,7 +102,7 @@ export declare class BootstrapTaskManager {
      *
      * 如果上一个会话仍在运行，自动 abort 后再创建新会话（防止重复触发产出重复 Candidate）。
      *
-     * @param {Array<{id: string, meta: object}>} taskDefs 任务定义列表
+     * @param taskDefs 任务定义列表
      */
     startSession(taskDefs: TaskDef[]): BootstrapSession;
     /**

package/dist/lib/service/bootstrap/BootstrapTaskManager.js

@@ -118,7 +118,7 @@ class BootstrapSession {
 export class BootstrapTaskManager {
     #currentSession = null;
     #eventBus = null;
-    /** @type {Function|null} 获取 RealtimeService 的 getter（延迟获取，避免循环依赖） */
+    /** 获取 RealtimeService 的 getter（延迟获取，避免循环依赖） */
     #getRealtimeService = null;
     constructor({ eventBus, getRealtimeService } = {}) {
         this.#eventBus = eventBus || null;
@@ -132,7 +132,7 @@ export class BootstrapTaskManager {
      *
      * 如果上一个会话仍在运行，自动 abort 后再创建新会话（防止重复触发产出重复 Candidate）。
      *
-     * @param {Array<{id: string, meta: object}>} taskDefs 任务定义列表
+     * @param taskDefs 任务定义列表
      */
     startSession(taskDefs) {
         // ── 并发锁：如果上一个 session 还在运行，先中止 ──

package/dist/lib/service/bootstrap/DimensionCopyRegistry.d.ts

@@ -25,7 +25,7 @@ export declare class DimensionCopy {
     /**
      * 批量为维度数组注入语言差异化文案（单语言版本）
      * 会直接修改维度对象的 label 和 guide 字段
-     * @param {Array<{ id: string, label: string, guide: string }>} dimensions
+     * @param dimensions
      * @param lang 主语言
      * @returns >} 原数组引用
      */
@@ -46,7 +46,7 @@ export declare class DimensionCopy {
      *   - guide 以主语言为主体，追加次要语言的差异化要点
      *   - 如果主语言和次要语言属于同一语言族，跳过（避免重复）
      *
-     * @param {Array<{ id: string, label: string, guide: string }>} dimensions
+     * @param dimensions
      * @param primary 主语言 ID
      * @param secondary 次要语言 ID 列表
      * @returns >} 原数组引用

package/dist/lib/service/bootstrap/DimensionCopyRegistry.js

@@ -311,7 +311,7 @@ export class DimensionCopy {
     /**
      * 批量为维度数组注入语言差异化文案（单语言版本）
      * 会直接修改维度对象的 label 和 guide 字段
-     * @param {Array<{ id: string, label: string, guide: string }>} dimensions
+     * @param dimensions
      * @param lang 主语言
      * @returns >} 原数组引用
      */
@@ -333,7 +333,7 @@ export class DimensionCopy {
      *   - guide 以主语言为主体，追加次要语言的差异化要点
      *   - 如果主语言和次要语言属于同一语言族，跳过（避免重复）
      *
-     * @param {Array<{ id: string, label: string, guide: string }>} dimensions
+     * @param dimensions
      * @param primary 主语言 ID
      * @param secondary 次要语言 ID 列表
      * @returns >} 原数组引用

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

@@ -8,7 +8,7 @@
  *
  * 设计原则：
  *   1. 内容来源统一 — 从 _loadEntries() 已加载的知识条目中提取
- *   2. 格式差异化 — 同一数据按目标工具特性适配输出
+ *   2. 互补不重复 — .mdc 处理行为规则，Channel F 处理项目知识
  *   3. 轻量索引 — 只输出摘要和规则，详细内容引导至 MCP 工具
  *   4. 幂等生成 — 每次 deliver 重写全部文件，不做增量 diff
  */
@@ -59,7 +59,6 @@ export declare class AgentInstructionsGenerator {
     };
     /**
      * 从知识条目构建共享内容段
-     * @private
      */
     _buildSections({ rules, patterns, skills, }: {
         rules: KnowledgeEntryProps[];
@@ -71,7 +70,6 @@ export declare class AgentInstructionsGenerator {
         skillLines: string[];
         toolLines: string[];
     };
-    /** @private */
     _writeAgentsMd(sections: {
         ruleLines: string[];
         patternRows: string[];
@@ -82,7 +80,6 @@ export declare class AgentInstructionsGenerator {
         tokensUsed: number;
         skipped: boolean;
     };
-    /** @private */
     _writeClaudeMd(sections: {
         ruleLines: string[];
         patternRows: string[];
@@ -95,10 +92,9 @@ export declare class AgentInstructionsGenerator {
     };
     /**
      * 动态生成 copilot-instructions.md
-     * 替代原有的静态模板复制
-     * @private
+     * 读取 templates/instructions/conventions.md + HTML markers
      */
-    _writeCopilotInstructions(sections: {
+    _writeCopilotInstructions(_sections: {
         ruleLines: string[];
         patternRows: string[];
         skillLines: string[];
@@ -109,14 +105,9 @@ export declare class AgentInstructionsGenerator {
         skipped: boolean;
     };
     /**
-     * 核心约束（所有 Agent 共享）
-     * @private
+     * 读取 templates/instructions/conventions.md — 唯一内容源
+     * .mdc、copilot-instructions.md、Channel F 动态版全部从这里读取
      */
-    _renderConstraints(): string[];
-    /**
-     * 推荐工作流（AGENTS.md 用）
-     * @private
-     */
-    _renderWorkflow(): string[];
+    _loadConventionsTemplate(): string;
 }
 export default AgentInstructionsGenerator;

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;