autosnippet 2.9.0 → 2.11.0

package/lib/service/chat/ProducerAgent.js

@@ -2,7 +2,7 @@
  * ProducerAgent.js — v3.0 生产者 Agent
  *
  * 职责:
- * - 将 Analyst 的分析文本转换为结构化的 submit_candidate 调用
+ * - 将 Analyst 的分析文本转换为结构化的 submit_knowledge 调用
  * - 遵循 PROJECT_SNAPSHOT_STYLE_GUIDE 格式
  * - 使用 read_project_file 获取代码片段
  * - CandidateGuardrail 验证每次提交
@@ -21,19 +21,20 @@ import Logger from '../../infrastructure/logging/Logger.js';
 
 const PRODUCER_SYSTEM_PROMPT = `你是知识管理专家。你会收到一段代码分析文本，需要将其中的知识点转化为结构化的知识候选。
 
-核心原则: 分析文本已经包含了所有发现，你的唯一工作是将它们格式化为 submit_candidate 调用。
+核心原则: 分析文本已经包含了所有发现，你的唯一工作是将它们格式化为 submit_knowledge 调用。
 
 每个候选必须:
 1. 有清晰的标题 (描述知识点的核心，使用项目真实类名)
-2. 有项目特写风格的正文 (结合代码展示)
+2. 有项目特写风格的正文 (content.markdown 字段，结合代码展示)
 3. 标注相关文件路径
-4. 选择正确的 knowledgeType (必须是维度约束中允许的类型)
+4. 选择正确的 kind (rule/pattern/fact)
+5. 提供完整的 Cursor 交付字段 (trigger, doClause, whenClause 等)
 
 工作流程:
 1. 阅读分析文本，识别每个独立的知识点/发现
 2. 用 read_project_file 批量获取关键代码片段:
    read_project_file({ filePaths: ["FileA.m", "FileB.m"], maxLines: 80 })
-3. 立刻调用 submit_candidate 提交
+3. 立刻调用 submit_knowledge 提交
 4. 重复直到分析中的所有知识点都已提交
 
 关键规则:
@@ -55,7 +56,7 @@ const PRODUCER_SYSTEM_PROMPT = `你是知识管理专家。你会收到一段代
 // ──────────────────────────────────────────────────────────────────
 
 const PRODUCER_TOOLS = [
-  'submit_candidate',
+  'submit_knowledge',
   'submit_with_check',
   'read_project_file',
 ];
@@ -79,7 +80,7 @@ const PRODUCER_BUDGET = {
 
 const STYLE_GUIDE = `# 「项目特写」写作要求
 
-submit_candidate 的 code 字段必须是「项目特写」。
+submit_knowledge 的 content.markdown 字段必须是「项目特写」。
 
 ## 什么是「项目特写」
 将一种技术的**基本用法**与**本项目的具体特征**融合为一体。
@@ -93,7 +94,30 @@ submit_candidate 的 code 字段必须是「项目特写」。
 ## 格式要求
 - 标题使用项目真实类名/前缀，不用占位名
 - 代码来源标注: (来源: FileName.m:行号)
-- 不要纯代码罗列，必须有项目上下文`;
+- 不要纯代码罗列，必须有项目上下文
+
+## Cursor 交付字段（每个 submit_knowledge 必须附带）
+
+每个候选必须提供以下交付字段，它们直接决定在 Cursor IDE 中作为 Rules 的展示质量。
+注意：language / category / knowledgeType / source 由系统自动设置，无需填写。
+
+### 必填
+- trigger: "@" + 核心类名 kebab-case，如 @bd-base-request。每个候选 trigger 必须唯一
+- kind: 此候选的知识类型 — rule(强制约束) / pattern(实现模式) / fact(项目事实)
+- doClause: 英文祈使句 ≤60 tokens，概括此知识的正向规则（以动词开头）。如 "Use dispatch_once for thread-safe singleton initialization"
+- description: 中文简述 ≤80 字，引用真实类名和数字
+
+### 推荐
+- dontClause: 反向约束英文描述（不以 "Don't" 开头，调用方会加前缀）。如 "use @synchronized for singleton"
+- whenClause: 触发场景英文。如 "When implementing singleton pattern or global shared instance"
+- topicHint: 主题分类，取值 networking / ui / data / architecture / conventions
+- coreCode: 最典型纯代码片段 3-8 行（不含 Markdown 格式、无 # 标题、无围栏、无 > 引用）
+
+### 规范
+1. trigger 以 @ 开头，kebab-case，不得在同一批次重复
+2. doClause 英文祈使句，不含中文
+3. coreCode 是可直接复制到编辑器的纯代码
+4. kind 根据内容本质判断：强制约束 → rule，实现模式 → pattern，项目事实 → fact`;
 
 // ──────────────────────────────────────────────────────────────────
 // Prompt 构建
@@ -135,10 +159,11 @@ function buildProducerPrompt(analysisReport, dimConfig, projectInfo) {
 1. 每个独立的知识点单独提交为一个候选 — 目标: 至少 3 个候选
 2. 先使用分析中已有的代码片段直接提交候选; 仅在需要更多代码上下文时才用 read_project_file
 3. filePaths 填写分析中提到的相关文件路径
-4. summary 概括该知识点的核心价值
+4. description 中文简述 ≤80 字，引用真实类名
 5. reasoning 中 sources 必须非空，填写来源文件名如 ["FileName.m"]，confidence 填 0.7~0.9
 6. 不要跳过任何分析中提到的知识点
-7. 如果 read_project_file 失败（文件不存在），直接用分析文本内容提交，不要重试其他路径`);
+7. 如果 read_project_file 失败（文件不存在），直接用分析文本内容提交，不要重试其他路径
+8. 每个候选必须有 trigger (@kebab-case)、kind (rule/pattern/fact)、doClause (英文祈使句)`);
 
   return parts.join('\n\n');
 }
@@ -207,7 +232,7 @@ export class ProducerAgent {
 
       // 统计提交 (区分成功/失败)
       const submitCalls = (result.toolCalls || []).filter(
-        tc => (tc.tool || tc.name) === 'submit_candidate' || (tc.tool || tc.name) === 'submit_with_check'
+        tc => (tc.tool || tc.name) === 'submit_knowledge' || (tc.tool || tc.name) === 'submit_with_check'
       );
       const successCount = submitCalls.filter(tc => {
         const res = tc.result;
@@ -221,7 +246,7 @@ export class ProducerAgent {
       if (rejectedCount > successCount && rejectedCount >= 2 && options.retryOnRejection !== false) {
         this.#logger.info(`[ProducerAgent] 高拒绝率 (${rejectedCount}/${submitCalls.length}) — 尝试修正`);
         try {
-          const retryPrompt = `你的 ${rejectedCount} 个提交被拒绝了。请根据拒绝原因改进后重新提交，确保:\n1. code 字段 ≥ 200 字符\n2. 包含代码块 (\`\`\`)\n3. 包含来源标注 (来源: FileName.m:行号)\n4. 标题使用项目真实类名`;
+          const retryPrompt = `你的 ${rejectedCount} 个提交被拒绝了。请根据拒绝原因改进后重新提交，确保:\n1. content.markdown 字段 ≥ 200 字符\n2. 包含代码块 (\`\`\`)\n3. 包含来源标注 (来源: FileName.m:行号)\n4. 标题使用项目真实类名\n5. 必填: trigger (@kebab-case)、kind (rule/pattern/fact)、doClause (英文祈使句)`;
           const retryResult = await this.#chatAgent.execute(retryPrompt, {
             source: 'system',
             conversationId: options.sessionId ? `producer-retry-${options.sessionId}-${dimId}` : undefined,
@@ -238,7 +263,7 @@ export class ProducerAgent {
           });
 
           const retrySubmits = (retryResult.toolCalls || []).filter(
-            tc => (tc.tool || tc.name) === 'submit_candidate' || (tc.tool || tc.name) === 'submit_with_check'
+            tc => (tc.tool || tc.name) === 'submit_knowledge' || (tc.tool || tc.name) === 'submit_with_check'
           );
           const retrySuccess = retrySubmits.filter(tc => {
             const res = tc.result;
@@ -263,6 +288,7 @@ export class ProducerAgent {
             toolCalls: [...(result.toolCalls || []), ...(retryResult.toolCalls || [])],
             reply: retryResult.reply || result.reply || '',
             tokenUsage: mergedTokenUsage,
+            reasoningQuality: retryResult.reasoningQuality || result.reasoningQuality || null,
           };
         } catch (retryErr) {
           this.#logger.warn(`[ProducerAgent] 修正轮失败 "${dimId}": ${retryErr.message}`);
@@ -277,6 +303,7 @@ export class ProducerAgent {
         toolCalls: result.toolCalls || [],
         reply: result.reply || '',
         tokenUsage: result.tokenUsage || null,
+        reasoningQuality: result.reasoningQuality || null,
       };
     } catch (err) {
       this.#logger.error(`[ProducerAgent] ❌ dimension "${dimId}" error: ${err.message}`);