speccore 6.76.1 → 6.77.0

package/dist/core/requirement-clarifier.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectProfessionalLevel = detectProfessionalLevel;
+exports.buildClarifyPrompt = buildClarifyPrompt;
+exports.parseClarifiedRequirement = parseClarifiedRequirement;
+exports.writeClarifiedDoc = writeClarifiedDoc;
+exports.assessRequirementDoc = assessRequirementDoc;
+exports.buildClarifiedHeader = buildClarifiedHeader;
+/**
+ * requirement-clarifier — 需求专业化模块
+ *
+ * 将用户原始需求描述（口语化/非专业）整理为 PRD 级专业需求文档。
+ * 支持专业度检测、AI 整理 Prompt 构建、结果解析和文件写入。
+ *
+ * v6.76.0+
+ */
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const logger_1 = require("../utils/logger");
+const task_utils_1 = require("../utils/task-utils");
+/**
+ * 检测文档专业度
+ * 宽松策略：满足 2+ 个条件即判定为 "low"
+ */
+function detectProfessionalLevel(content) {
+    if (!content || content.trim().length < 50)
+        return 'low';
+    const checks = {
+        // 1. 口语化检测：大量短句、无标点或口语词
+        oral: (() => {
+            const oralPatterns = /(我要|我想|能不能|可不可以|帮忙|弄一个|搞一个|加个|改下|顺便|反正|大概|差不多)/g;
+            const oralMatches = content.match(oralPatterns);
+            const oralRatio = oralMatches ? oralMatches.length / content.length : 0;
+            return oralRatio > 0.005; // 口语词密度 > 0.5%
+        })(),
+        // 2. 无结构化标题：没有 ## 二级标题
+        noStructure: !/^#{2,3}\s+/m.test(content),
+        // 3. 无验收标准：没有"验收"、"AC"、"验收标准"等关键词
+        noAcceptance: !/(验收标准|验收条件|AC[:：]|acceptance criteria|验收准则|测试标准)/i.test(content),
+        // 4. 无业务规则：没有"规则"、"约束"、"限制"等关键词
+        noRules: !/(业务规则|约束条件|限制条件|校验规则|规则[:：]|rule[:：])/i.test(content),
+        // 5. 纯文本段落：没有表格、列表、代码块等结构化元素
+        noFormatting: !/(\|.*\|.*\||^\s*[-*]\s+|```)/m.test(content),
+        // 6. 无功能边界：没有"范围"、"边界"、"不涉及"等关键词
+        noBoundary: !/(功能范围|范围[:：]|边界|不涉及|不包含|排除)/i.test(content),
+    };
+    const failCount = Object.values(checks).filter(Boolean).length;
+    if (failCount >= 4)
+        return 'low';
+    if (failCount >= 2)
+        return 'medium';
+    return 'high';
+}
+/**
+ * 构建需求专业化 Prompt
+ * 让 AI 以专业产品经理角色整理 PRD
+ */
+function buildClarifyPrompt(rawDesc, context) {
+    const sections = [];
+    sections.push('# 需求专业化 — 将原始描述整理为 PRD 级需求文档');
+    sections.push('');
+    sections.push('## 你的角色');
+    sections.push('你是资深产品经理 + 领域专家。请将用户的原始需求描述整理为一份专业的需求规格说明书（PRD）。');
+    sections.push('');
+    sections.push('## 用户原始输入');
+    sections.push('```');
+    sections.push(rawDesc);
+    sections.push('```');
+    sections.push('');
+    if (context?.sourceFile) {
+        sections.push(`> 来源: ${context.sourceFile}`);
+        sections.push('');
+    }
+    sections.push('## 整理要求');
+    sections.push('');
+    sections.push('### 必须包含的章节');
+    sections.push('1. **背景与目标**：为什么要做这个功能，解决什么问题，预期收益');
+    sections.push('2. **用户故事**：作为 [角色]，我希望 [目标]，以便 [价值]（可写多个）');
+    sections.push('3. **功能规格**：');
+    sections.push('   - 功能清单（按模块组织）');
+    sections.push('   - 每个功能的详细描述（输入、处理、输出）');
+    sections.push('   - 业务规则（校验、约束、状态流转）');
+    sections.push('   - 异常场景和边界条件');
+    sections.push('4. **验收标准（AC）**：可测试的、具体的验收条件，每条用 [ ] 标记');
+    sections.push('5. **非功能需求**：性能、安全、兼容性等（如适用）');
+    sections.push('6. **依赖与约束**：依赖的其他系统/模块，技术/业务约束');
+    sections.push('');
+    sections.push('### 写作规范');
+    sections.push('- 使用 Markdown 格式，结构清晰');
+    sections.push('- 语言专业、准确，避免口语化表达');
+    sections.push('- 技术术语使用行业标准表述');
+    sections.push('- 不要添加文档中未提及的功能，不要脑补');
+    sections.push('- 如果原始描述不完整，标注「待补充」而不是自行编造');
+    sections.push('');
+    sections.push('## 输出格式');
+    sections.push('直接输出整理后的 Markdown PRD 文档，不要输出 JSON、不要输出解释、不要输出代码块包裹整个文档。');
+    sections.push('文档末尾附加「原始输入」章节，记录用户原始描述。');
+    sections.push('');
+    return sections.join('\n');
+}
+/**
+ * 解析 AI 返回的整理结果
+ * 提取 PRD 内容和原始输入
+ */
+function parseClarifiedRequirement(response) {
+    // 移除常见的代码块包裹
+    let cleaned = response.trim();
+    if (cleaned.startsWith('```markdown')) {
+        cleaned = cleaned.slice('```markdown'.length).trim();
+    }
+    if (cleaned.startsWith('```')) {
+        cleaned = cleaned.slice(3).trim();
+    }
+    if (cleaned.endsWith('```')) {
+        cleaned = cleaned.slice(0, -3).trim();
+    }
+    const hasOriginalSection = /## 原始输入/.test(cleaned);
+    return { content: cleaned, hasOriginalSection };
+}
+/**
+ * 写入澄清后的需求文档
+ * 位置: 010-requirements/converted/clarified-{slug}.md
+ */
+async function writeClarifiedDoc(content, iterDir, sourceName) {
+    const convertedDir = (0, path_1.join)(iterDir, '010-requirements', 'converted');
+    await (0, fs_extra_1.ensureDir)(convertedDir);
+    // 生成文件名：基于来源名 + 时间戳
+    const baseName = (0, path_1.basename)(sourceName, '.md')
+        .replace(/[^\w\u4e00-\u9fa5-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        || 'clarified';
+    const now = new Date();
+    const timestamp = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, '0')}${String(now.getDate()).padStart(2, '0')}`;
+    const filename = `clarified-${baseName}-${timestamp}.md`;
+    const filepath = (0, path_1.join)(convertedDir, filename);
+    // 备份已有文件
+    const backup = await (0, task_utils_1.backupWithTimestamp)(filepath);
+    if (backup) {
+        logger_1.logger.info(`   📦 旧版已备份: ${(0, path_1.basename)(backup)}`);
+    }
+    await (0, fs_extra_1.writeFile)(filepath, content, 'utf-8');
+    return filepath;
+}
+/**
+ * 读取需求文档并检测专业度
+ * 返回检测结果和建议
+ */
+async function assessRequirementDoc(filePath) {
+    const content = await (0, fs_extra_1.readFile)(filePath, 'utf-8');
+    const level = detectProfessionalLevel(content);
+    const issues = [];
+    if (level !== 'high') {
+        if (!/(验收标准|验收条件|AC[:：]|acceptance criteria)/i.test(content)) {
+            issues.push('缺少验收标准（AC）');
+        }
+        if (!/(业务规则|约束条件|校验规则)/i.test(content)) {
+            issues.push('缺少业务规则');
+        }
+        if (!/^#{2,3}\s+/m.test(content)) {
+            issues.push('缺少结构化标题');
+        }
+        if (/(我要|我想|能不能|可不可以|帮忙|弄一个|搞一个)/g.test(content)) {
+            issues.push('存在口语化表述');
+        }
+    }
+    return { level, content, issues };
+}
+/**
+ * 生成澄清后的文档头部元信息
+ */
+function buildClarifiedHeader(originalSource, clarifyTime = new Date().toISOString()) {
+    return `---
+source: "${originalSource}"
+clarified-at: "${clarifyTime}"
+status: "clarified"
+---
+
+`;
+}
+//# sourceMappingURL=requirement-clarifier.js.map

package/dist/core/requirement-clarifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-clarifier.js","sourceRoot":"","sources":["../../src/core/requirement-clarifier.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccore",
-  "version": "6.76.1",
+  "version": "6.77.0",
   "description": "SpecCore - Code by Spec, Not by Vibe.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/.agents/skills/spec-dev/SKILL.md

@@ -1,10 +0,0 @@
----
-name: spec-dev
-description: 路由到 speccore ask 引擎
-allowed-tools: ["Bash"]
-disable-model-invocation: false
----
-
-直接执行: execute_command("speccore ask '用户原话'")
-
-不要输出命令文本，不要分析意图，一切交给 speccore ask。

package/.agents/skills/spec-synthesize/SKILL.md

@@ -1,10 +0,0 @@
----
-name: spec-synthesize
-description: 路由到 speccore ask 引擎
-allowed-tools: ["Bash"]
-disable-model-invocation: false
----
-
-直接执行: execute_command("speccore ask '用户原话'")
-
-不要输出命令文本，不要分析意图，一切交给 speccore ask。