autosnippet 3.2.3 → 3.2.4

package/config/constitution.yaml

@@ -31,6 +31,7 @@ roles:
     permissions:
       - "read:recipes"
       - "read:guard_rules"
+      - "guard_rule:check_code"
       - "create:candidates"
       - "candidate:update"
       - "knowledge:create"

package/lib/cli/SetupService.js

@@ -442,8 +442,13 @@ export class SetupService {
     configured.push('cursor-mcp');
 
     // 模板文件（可能因已存在/用户文件而跳过）
-    if (this._copyCopilotInstructions()) configured.push('copilot-instructions');
-    this._ensureTaskGraphInstructions();
+    const copilotCopied = this._copyCopilotInstructions();
+    if (copilotCopied) {
+      configured.push('copilot-instructions');
+    } else {
+      // 模板未复制（用户已有文件）→ 注入 AutoSnippet 段落
+      this._ensureTaskGraphInstructions();
+    }
     if (this._generateAgentInstructionFiles()) configured.push('agent-instructions');
     if (this._copyCursorRules()) configured.push('cursor-rules');
     if (this._copySkillsTemplate()) configured.push('skills-template');
@@ -735,35 +740,30 @@ export class SetupService {
     return true;
   }
 
-  /** @private TaskGraph 决策记忆激活段落注入 */
+  /**
+   * @private TaskGraph 决策记忆段落注入
+   * 从 templates/copilot-instructions.md 提取 <!-- autosnippet:begin/end --> 间的内容注入。
+   * 单一数据源：模板即注入内容，无需维护第二份文件。
+   */
   _ensureTaskGraphInstructions() {
     const githubDir = join(this.projectRoot, '.github');
     const filePath = join(githubDir, 'copilot-instructions.md');
 
-    // 使用 HTML 注释标记界定段落，避免标题被编辑后重复追加（D3）
     const BEGIN_MARKER = '<!-- autosnippet:begin -->';
     const END_MARKER = '<!-- autosnippet:end -->';
 
-    const autosnippetSection = `
-${BEGIN_MARKER}
-## AutoSnippet
-
-This project uses AutoSnippet for knowledge management and decision tracking.
-In VS Code Agent Mode, type \`#asd\` before your message to activate project memory.
-
-### ⚠️ MANDATORY — Call \`autosnippet_ready\` FIRST
-
-Before doing ANY work, you MUST call \`autosnippet_ready()\` at the start of every conversation.
-This loads **active team decisions** and **pending tasks** that you must respect.
-Skipping this step will cause you to contradict team agreements.
-
-\`\`\`
-autosnippet_ready()           → Load decisions + context (ALWAYS FIRST)
-autosnippet_decide(record)    → Save new team agreement
-autosnippet_task(create/close) → Task lifecycle
-\`\`\`
-${END_MARKER}
-`;
+    // 从模板提取标记间内容
+    const templateSrc = join(REPO_ROOT, 'templates', 'copilot-instructions.md');
+    if (!existsSync(templateSrc)) {
+      return { action: 'skipped' };
+    }
+    const templateContent = readFileSync(templateSrc, 'utf8');
+    const beginIdx = templateContent.indexOf(BEGIN_MARKER);
+    const endIdx = templateContent.indexOf(END_MARKER);
+    if (beginIdx === -1 || endIdx === -1) {
+      return { action: 'skipped' };
+    }
+    const snippetContent = templateContent.slice(beginIdx, endIdx + END_MARKER.length);
 
     if (!existsSync(githubDir)) {
       mkdirSync(githubDir, { recursive: true });
@@ -771,22 +771,21 @@ ${END_MARKER}
 
     if (existsSync(filePath)) {
       const existing = readFileSync(filePath, 'utf8');
-      // 通过 HTML 注释标记检测，不依赖可编辑的标题文本
       if (existing.includes(BEGIN_MARKER)) {
         // 替换现有段落（支持升级）
         const updated = existing.replace(
           new RegExp(`${BEGIN_MARKER}[\\s\\S]*?${END_MARKER}`),
-          autosnippetSection.trim()
+          snippetContent
         );
         writeFileSync(filePath, updated);
         return { action: 'updated' };
       }
       // 追加到末尾
-      writeFileSync(filePath, existing + '\n' + autosnippetSection);
+      writeFileSync(filePath, `${existing}\n\n${snippetContent}\n`);
       return { action: 'appended' };
     }
 
-    writeFileSync(filePath, autosnippetSection.trimStart());
+    writeFileSync(filePath, `${snippetContent}\n`);
     return { action: 'created' };
   }
 

package/lib/service/cursor/AgentInstructionsGenerator.js

@@ -281,19 +281,22 @@ export class AgentInstructionsGenerator {
     // Key tools highlight for Claude
     lines.push('### Recommended Workflow', '');
     lines.push(
-      '1. **Session start**: `autosnippet_ready()` — Restore task context and decisions'
+      '1. **Every message → `autosnippet_ready()`** — Load decisions + tasks + knowledge context (ALWAYS FIRST)'
     );
     lines.push(
-      '2. **Before writing code**: `autosnippet_search({ query: "<topic>" })` to find relevant patterns'
+      '2. **User agrees/disagrees → `autosnippet_decide(record/revise/unpin)`** — Persist decision immediately'
     );
     lines.push(
-      '3. **Check compliance**: `autosnippet_guard({ code: "<your code>" })` before committing'
+      '3. **Before writing code**: `autosnippet_search({ query: "<topic>" })` to find relevant patterns'
     );
     lines.push(
-      '4. **Complete task**: `autosnippet_task({ operation: "close", id: "<id>" })`'
+      '4. **Check compliance**: `autosnippet_guard({ code: "<your code>" })` before committing'
     );
     lines.push(
-      '5. **Guard diagnostics**: Read ruleId → `autosnippet_search({ query: "<ruleId>" })` → fix'
+      '5. **Complete task**: `autosnippet_task({ operation: "close", id: "<id>" })`'
+    );
+    lines.push(
+      '6. **Guard diagnostics**: Read ruleId → `autosnippet_search({ query: "<ruleId>" })` → fix'
     );
     lines.push('');
 
@@ -390,11 +393,13 @@ export class AgentInstructionsGenerator {
     return [
       '## Mandatory Constraints',
       '',
-      '1. **Do NOT modify** knowledge base files directly (`AutoSnippet/recipes/`, `.autosnippet/`).',
-      '2. Create or update knowledge **only** through MCP tools (`autosnippet_submit_knowledge`).',
-      '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.',
+      '1. **Every message → `autosnippet_ready()`** — Load latest decisions and task context. Skipping causes contradictions with team agreements.',
+      '2. **User agrees/disagrees with a plan → `autosnippet_decide(record/revise/unpin)` immediately** — Persist team memory first, then continue execution.',
+      '3. **Do NOT modify** knowledge base files directly (`AutoSnippet/recipes/`, `.autosnippet/`).',
+      '4. Create or update knowledge **only** through MCP tools (`autosnippet_submit_knowledge`).',
+      '5. **Prefer Recipes** as project standards; source code is supplementary.',
+      '6. Use `autosnippet_search` for knowledge retrieval; do not retry on failure in the same turn.',
+      '7. Skills handle semantics and workflow; MCP handles capabilities — do not hardcode URLs in Skills.',
     ];
   }
 
@@ -406,15 +411,16 @@ export class AgentInstructionsGenerator {
     return [
       '## Recommended Workflow',
       '',
-      '### Session Start (ALWAYS)',
-      '1. `autosnippet_ready()` — Restore task context and decisions',
+      '### First Actions (MANDATORY)',
+      '1. **Every message** → `autosnippet_ready()` — Load decisions + tasks + knowledge context (never skip)',
+      '2. **User agrees/disagrees** → `autosnippet_decide({ operation: "record" | "revise" | "unpin" })` — Persist decision before continuing',
       '',
       '### Task Lifecycle',
-      '2. `autosnippet_task({ operation: "claim", id: "asd-xxx" })` — Start working',
-      '3. `autosnippet_search({ query: "<topic>" })` — Search knowledge before coding',
-      '4. **CODE** — Write the implementation',
-      '5. `autosnippet_guard({ code: "<code>" })` — Check compliance',
-      '6. `autosnippet_task({ operation: "close", id: "asd-xxx" })` — Complete',
+      '3. `autosnippet_task({ operation: "claim", id: "asd-xxx" })` — Start working',
+      '4. `autosnippet_search({ query: "<topic>" })` — Search knowledge before coding',
+      '5. **CODE** — Write the implementation',
+      '6. `autosnippet_guard({ code: "<code>" })` — Check compliance',
+      '7. `autosnippet_task({ operation: "close", id: "asd-xxx" })` — Complete',
       '',
       '### Guard Diagnostics Response',
       'When editor shows diagnostics from "AutoSnippet Guard":',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "3.2.3",
+  "version": "3.2.4",
   "description": "Extract code patterns into a knowledge base for AI coding assistants",
   "type": "module",
   "main": "lib/bootstrap.js",

package/templates/copilot-instructions.md

@@ -1,3 +1,4 @@
+<!-- autosnippet:begin -->
 <!-- On every human message, call autosnippet_ready() as your first action. No exceptions. -->
 <!-- On any explicit user agreement/disagreement about a plan/decision, call autosnippet_decide(...) immediately to persist team memory. -->
 
@@ -175,3 +176,4 @@ Skill 包含：完整的 V3 字段格式、JSON 示例模板、维度分析策
 ---
 <!-- REMINDER: If you have not yet called autosnippet_ready(), do it now before responding. -->
 <!-- REMINDER: If user has explicitly agreed/disagreed with a plan, call autosnippet_decide(...) before continuing. -->
+<!-- autosnippet:end -->