autosnippet 3.1.5 → 3.1.7

package/dashboard/dist/index.html

@@ -5,7 +5,7 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AutoSnippet Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-D9fV5GGQ.js"></script>
+    <script type="module" crossorigin src="/assets/index-Ciz4nd_4.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/yaml-qRaU8Ldn.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-CEnWn7aV.js">
     <link rel="modulepreload" crossorigin href="/assets/axios-C0Zqfgkc.js">

package/lib/external/mcp/handlers/bootstrap/MissionBriefingBuilder.js

@@ -16,6 +16,7 @@
 
 import { TierScheduler } from './pipeline/tier-scheduler.js';
 import { SUBMISSION_SCHEMA, EXAMPLE_TEMPLATES } from './shared/dimension-text.js';
+import { getDimensionSOP, sopToCompactText, PRE_SUBMIT_CHECKLIST } from './shared/dimension-sop.js';
 
 // ── 常量 ────────────────────────────────────────────────────
 
@@ -42,25 +43,45 @@ const SIZE_THRESHOLDS = {
  * @returns {object} — Mission Briefing 维度任务对象
  */
 function enrichDimensionTask(dim, skills, tier) {
-  // ── analysisGuide: 从 dim.guide + skill 内容增强 ──
-  let analysisGuide = `分析项目的${dim.label}。\n\n重点关注:\n${dim.guide}\n\n分析要求:\n1. 在具体文件/类中验证发现（引用 ≥3 个文件路径）\n2. 说明具体实现方式和代码特征\n3. 解释设计意图\n4. 提供统计数据（数量、占比）\n5. 每个知识点独立描述，目标 3-5 个发现`;
+  // ── analysisGuide: SOP 化 — 优先使用维度专属 SOP，否则回退通用指引 ──
+  const sop = getDimensionSOP(dim.id);
+  let analysisGuide;
+
+  if (sop) {
+    // SOP 结构化模式: steps + timeEstimate + commonMistakes
+    analysisGuide = {
+      goal: `分析项目的${dim.label}`,
+      focus: dim.guide,
+      steps: sop.steps,
+      timeEstimate: sop.timeEstimate || '10-15 min',
+      commonMistakes: sop.commonMistakes || [],
+    };
+  } else {
+    // 无 SOP 的维度: 保留原始文本指引（兼容新增维度未定义 SOP 的情况）
+    analysisGuide = `分析项目的${dim.label}。\n\n重点关注:\n${dim.guide}\n\n分析要求:\n1. 在具体文件/类中验证发现（引用 ≥3 个文件路径）\n2. 说明具体实现方式和代码特征\n3. 解释设计意图\n4. 提供统计数据（数量、占比）\n5. 每个知识点独立描述，目标 3-5 个发现`;
+  }
 
   // 如果有相关 skill，注入到 analysisGuide 中
   const relatedSkill = skills?.find(
     (s) => s.relatedDimension === dim.id || s.name === dim.skillMeta?.name
   );
   if (relatedSkill) {
-    analysisGuide += `\n\n参考已有 Skill (${relatedSkill.name}):\n${relatedSkill.content?.substring(0, 500) || ''}`;
+    const skillHint = `参考已有 Skill (${relatedSkill.name}):\n${relatedSkill.content?.substring(0, 500) || ''}`;
+    if (typeof analysisGuide === 'string') {
+      analysisGuide += `\n\n${skillHint}`;
+    } else {
+      analysisGuide.referenceSkill = skillHint;
+    }
   }
 
-  // ── submissionSpec ──
+  // ── submissionSpec: 嵌入 Quality Checklist ──
   const submissionSpec = {
     knowledgeTypes: dim.knowledgeTypes || [],
     targetCandidateCount: '3-5',
     contentStyle:
       '融合基本用法与项目特征的「项目特写」。\n四大核心内容:\n1. 项目选择了什么 — 采用了哪种写法/模式/约定\n2. 为什么这样选 — 统计分布、占比、历史决策\n3. 项目禁止什么 — 反模式、已废弃写法\n4. 新代码怎么写 — 可直接复制的代码模板 + 来源标注',
     contentQuality:
-      'content.markdown 必须 ≥200 字符，包含: (1) ## 标题 (2) 正文说明 (3) 至少一个 ```代码块``` (4) 来源标注「(来源: FileName.ext:行号)」。短于 200 字符的提交会被拒绝。',
+      'content.markdown 必须 ≥200 字符，包含: (1) ## 标题 (2) 正文说明 (3) 至少一个 ```代码块``` (4) 来源标注「(来源: FileName.ext:行号)」。短于 200 字符的提交会被拒绝。\n【禁止】标题和正文中不得出现 "Agent" 字样 — 所有候选必须以项目规范/开发规范的视角撰写，描述的是项目规则而非 AI Agent 指南。',
     cursorFields: {
       trigger: '@前缀-kebab-case（每个候选唯一）',
       kind: 'rule=强制约束 | pattern=实现模式 | fact=项目事实',
@@ -71,6 +92,7 @@ function enrichDimensionTask(dim, skills, tier) {
     },
     dimensionCompleteGuide:
       '调用 dimension_complete 时必须传递: referencedFiles=[本维度分析过的全部文件路径], keyFindings=[3-5条关键发现摘要], analysisText=详细分析报告(≥500字符,含##标题+列表+代码块)',
+    preSubmitChecklist: PRE_SUBMIT_CHECKLIST,
   };
 
   // ── skillMeta ──
@@ -533,6 +555,15 @@ export function buildMissionBriefing({
     for (const dim of briefing.dimensions) {
       delete dim.evidenceStarters;
     }
+    // Level 5: SOP 降级为紧凑文本 + 移除 FAIL_EXAMPLES
+    for (const dim of briefing.dimensions) {
+      if (dim.analysisGuide && typeof dim.analysisGuide === 'object') {
+        dim.analysisGuide = sopToCompactText(dim.analysisGuide);
+      }
+      if (dim.submissionSpec?.preSubmitChecklist?.FAIL_EXAMPLES) {
+        delete dim.submissionSpec.preSubmitChecklist.FAIL_EXAMPLES;
+      }
+    }
     // 更新 meta
     const newSize = JSON.stringify(briefing).length;
     briefing.meta.responseSizeKB = Math.round(newSize / 1024);

package/lib/external/mcp/handlers/bootstrap/base-dimensions.js

@@ -90,10 +90,10 @@ export const baseDimensions = [
         'Project tech stack, module structure, third-party dependencies, base extensions/classes, event hooks, infrastructure services, and runtime/interop features (auto-generated by bootstrap)',
     },
   },
-  // ⑦ Agent 开发注意事项（Skill）
+  // ⑦ 项目开发强制规范（Skill）
   {
     id: 'agent-guidelines',
-    label: 'Agent开发注意事项',
+    label: '项目开发强制规范',
     guide:
       '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、线程安全、内存约束、已废弃 API 标记、架构约束注释、TODO/FIXME',
     knowledgeTypes: ['boundary-constraint', 'code-standard'],
@@ -101,7 +101,7 @@ export const baseDimensions = [
     skillMeta: {
       name: 'project-agent-guidelines',
       description:
-        'Mandatory coding rules, deprecated APIs and agent constraints for this project (auto-generated by bootstrap)',
+        'Mandatory coding rules, deprecated APIs and project constraints (auto-generated by bootstrap)',
     },
   },
 
@@ -112,7 +112,7 @@ export const baseDimensions = [
     id: 'objc-deep-scan',
     label: '深度扫描（常量/Hook）',
     guide:
-      '全量扫描 #define 值宏/函数宏、extern/static 常量、Method Swizzling hook 对（Agent 必须使用项目常量，修改被 hook 方法前必须查阅 hook 清单）',
+      '全量扫描 #define 值宏/函数宏、extern/static 常量、Method Swizzling hook 对（开发者必须使用项目常量，修改被 hook 方法前必须查阅 hook 清单）',
     knowledgeTypes: ['code-standard', 'code-pattern'],
     conditions: { languages: ['objectivec', 'swift'] },
     skillWorthy: true,
@@ -128,7 +128,7 @@ export const baseDimensions = [
     id: 'category-scan',
     label: '基础类分类方法扫描',
     guide:
-      'Foundation/UIKit Category/Extension 逐方法清单（含完整实现代码与项目使用频次），仅扫描基础类分类、不含业务代码（Agent 遇到同等功能必须使用项目已有分类方法，禁止重复实现）',
+      'Foundation/UIKit Category/Extension 逐方法清单（含完整实现代码与项目使用频次），仅扫描基础类分类、不含业务代码（遇到同等功能必须使用项目已有分类方法，禁止重复实现）',
     knowledgeTypes: ['code-standard', 'code-pattern'],
     conditions: { languages: ['objectivec', 'swift'] },
     skillWorthy: true,

package/lib/external/mcp/handlers/bootstrap/pipeline/EpisodicMemory.js

@@ -95,7 +95,7 @@ export class EpisodicMemory {
   /** @type {object} 项目上下文 (不变信息) */
   #projectContext;
 
-  /** @type {import('../../../../../lib/infrastructure/logging/Logger.js').default} */
+  /** @type {import('../../../../../infrastructure/logging/Logger.js').default} */
   #logger;
 
   /**

package/lib/external/mcp/handlers/bootstrap/pipeline/ToolResultCache.js

@@ -32,7 +32,7 @@ export class ToolResultCache {
   /** @type {Map<string, {content: string, cachedAt: number, hitCount: number}>} */
   #fileCache = new Map();
 
-  /** @type {import('../../../../../lib/infrastructure/logging/Logger.js').default} */
+  /** @type {import('../../../../../infrastructure/logging/Logger.js').default} */
   #logger;
 
   /** @type {{hits: number, misses: number, evictions: number}} */

package/lib/external/mcp/handlers/bootstrap/pipeline/dimension-configs.js

@@ -103,8 +103,8 @@ export const DIMENSION_CONFIGS_V3 = {
     allowedKnowledgeTypes: ['best-practice'],
   },
   'agent-guidelines': {
-    label: 'Agent 开发注意事项',
-    guide: '总结 Agent 在此项目开发时必须遵守的规则和约束。',
+    label: '项目开发强制规范',
+    guide: '总结在此项目开发时必须遵守的强制规则和约束。',
     focusAreas: [
       '命名强制规则和前缀约定',
       '线程安全约束',

package/lib/external/mcp/handlers/bootstrap/pipeline/noAiFallback.js

@@ -121,7 +121,7 @@ export async function runNoAiFallback(fillContext) {
     if (guidelines) {
       candidates.push(guidelines);
       skills.push(
-        _wrapAsSkill('agent-guidelines', 'Agent 开发注意事项', guidelines.content.markdown)
+        _wrapAsSkill('agent-guidelines', '项目开发强制规范', guidelines.content.markdown)
       );
       report.candidatesCreated++;
       report.skillsCreated++;