mcp-probe-kit 3.2.0 → 3.3.0

package/build/lib/template-loader.js

@@ -14,8 +14,8 @@ const TEMPLATE_VALIDATORS = {
         requiredFields: ['技术选型'],
     },
     'specs/feature/tasks.md': {
-        requiredSections: ['概述', '任务列表', '检查点', '文件变更清单'],
-        requiredFields: ['阶段 1', '阶段 2', '阶段 3'],
+        requiredSections: ['概述', '交付物清单', '任务列表', '检查点', '文件变更清单'],
+        requiredFields: ['阶段 1', '阶段 2', '阶段 3', '证据块'],
     },
 };
 const EMBEDDED_TEMPLATES = {
@@ -214,36 +214,60 @@ const EMBEDDED_TEMPLATES = {
 
 实现 {feature_name} 功能的任务分解。每条任务都要回链到需求（FR）与设计章节，确保不漏、不越界。
 
+> **二元禁令（零容忍）**：本文件及后续实现的交付物中，禁止出现 \`[填写]\`、\`TODO\`、\`// ...\`、省略号占位。
+> 这不是"尽量"，是"零"。任何用占位符代替真实内容的行为都视为未完成。
+
+---
+
+## 交付物清单（Scope-lock）
+
+> 先数清楚要产出什么，锁定数量。实现完成前必须回读本清单逐项核对，数量对不上即未完成。
+
+- **预计新建文件数**: [填写：N 个]
+- **预计修改文件数**: [填写：N 个]
+- **预计新增/修改函数数**: [填写：约 N 个]
+- **交付物逐项列举**:
+  1. [填写：交付物 1，如 src/auth/login.ts]
+  2. [填写：交付物 2]
+
 ---
 
 ## 任务列表
 
-> 每条任务：动词开头、单一明确、可在一次提交内完成，并标注 _需求_ 与 _设计_。
-> 示例：2.1 实现登录接口 POST /api/login — _需求: FR-1_ ｜ _设计: API 设计_
+> **每条任务的硬性结构**（缺一不可）：
+> 1. **标题**：[动词] + [对象] + [约束/验收点]。如"实现登录接口 POST /api/login，校验邮箱格式并返回 JWT"。
+>    - ❌ 反例（过于宽泛，会被打回）："优化登录"、"处理用户模块"
+> 2. **证据块**：动手前先读相关代码，贴出关键原文片段（文件:行号 + 代码），证明已理解现状再改。
+> 3. **涉及文件 + 行数预算**：列出本任务触及的文件；单文件预计超 500 行时，必须在此写明拆分方案（拆成哪些模块/组件）。
+> 4. **回链**：标注 _需求: FR-n_ 与 _设计: 章节_。
 
 ### 阶段 1: 准备工作
 
-- [ ] 1.1 [填写：任务标题]
-  - [填写：具体操作说明]
+- [ ] 1.1 [填写：动词+对象+约束的具体标题]
+  - **证据块**: [填写：先读 \`文件:行号\`，贴出现状关键片段]
+  - **涉及文件**: [填写：路径 + 行数预算；超 500 行写拆分方案]
   - _需求: [填写：FR-n]_ ｜ _设计: [填写：design.md 章节]_
 
 ---
 
 ### 阶段 2: 核心实现
 
-- [ ] 2.1 [填写：任务标题]
-  - [填写：具体操作说明]
+- [ ] 2.1 [填写：动词+对象+约束的具体标题]
+  - **证据块**: [填写：先读 \`文件:行号\`，贴出现状关键片段]
+  - **涉及文件**: [填写：路径 + 行数预算；超 500 行写拆分方案]
   - _需求: [填写：FR-n]_ ｜ _设计: [填写：design.md 章节]_
-- [ ] 2.2 [填写：任务标题]
-  - [填写：具体操作说明]
+- [ ] 2.2 [填写：动词+对象+约束的具体标题]
+  - **证据块**: [填写：先读 \`文件:行号\`，贴出现状关键片段]
+  - **涉及文件**: [填写：路径 + 行数预算；超 500 行写拆分方案]
   - _需求: [填写：FR-n]_ ｜ _设计: [填写：design.md 章节]_
 
 ---
 
 ### 阶段 3: 集成测试
 
-- [ ] 3.1 [填写：任务标题（对照验收标准逐条核验）]
-  - [填写：具体操作说明]
+- [ ] 3.1 [填写：动词+对象+约束的标题（对照验收标准逐条核验）]
+  - **证据块**: [填写：先读相关测试/接口现状]
+  - **涉及文件**: [填写：测试文件路径]
   - _需求: [填写：FR-n]_ ｜ _设计: [填写：design.md 章节]_
 
 ---
@@ -269,19 +293,23 @@ const EMBEDDED_TEMPLATES = {
 
 ## 文件变更清单
 
-| 文件 | 操作 | 说明 |
-|------|------|------|
-| [填写：文件路径] | 新建/修改 | [填写：说明] |
+| 文件 | 操作 | 行数预算 | 说明 |
+|------|------|----------|------|
+| [填写：文件路径] | 新建/修改 | [填写：预计行数] | [填写：说明] |
 
 ---
 
 ## 检查清单
 
+- [ ] 交付物清单（Scope-lock）已填，实现后数量已逐项核对
+- [ ] 每条任务标题是"动词+对象+约束"的具体描述，无宽泛标题
+- [ ] 每条任务含证据块（先读后写）
+- [ ] 每条任务标注涉及文件与行数预算，超 500 行的有拆分方案
 - [ ] 任务分阶段合理，粒度可在单次提交内完成
-- [ ] 每项任务可执行且可验证
 - [ ] 每条任务都回链到 FR 与 design 章节
 - [ ] 需求覆盖矩阵已填，无遗漏的 FR
 - [ ] 阶段 3 包含"对照验收标准核验"
+- [ ] 全文无 \`[填写]\` / \`TODO\` / 省略号占位（二元禁令）
 `,
     'specs/feature/strict/requirements.md': `# 需求文档：{feature_name}
 
@@ -399,26 +427,50 @@ const EMBEDDED_TEMPLATES = {
 
 实现 {feature_name} 的任务分解；每条任务回链 FR 与 design 章节。
 
+> **二元禁令**：交付物中零容忍 \`[填写]\` / \`TODO\` / \`// ...\` 等占位。动手前先读相关代码贴出证据，再写实现。单文件超 500 行必须拆分。
+
+---
+
+## 交付物清单（Scope-lock）
+
+- 预计文件数: [填写：N]
+- 预计任务数: [填写：N]
+
+> 实现完成前回读本清单逐项核对，数量不符即未完成。
+
 ---
 
 ## 任务列表
 
+> 每条任务标题须为「[动词]+[对象]+[约束]」的具体写法（如「新建 auth.service.ts 实现 JWT 签发，≤120 行」），禁止「优化登录」式宽泛描述。
+
 ### 阶段 1: 准备工作
 
-- [ ] 1.1 [填写：任务标题] — _需求: [填写：FR-n]_ ｜ _设计: [填写：章节]_
+- [ ] 1.1 [填写：动词+对象+约束]
+  - 证据块: [填写：动手前需读的文件:行号]
+  - 文件: [填写：路径]（预算 [填写] 行，超 500 行拆分）
+  - _需求: [填写：FR-n]_ · _设计: [填写：章节]_
 
 ---
 
 ### 阶段 2: 核心实现
 
-- [ ] 2.1 [填写：任务标题] — _需求: [填写：FR-n]_ ｜ _设计: [填写：章节]_
-- [ ] 2.2 [填写：任务标题] — _需求: [填写：FR-n]_ ｜ _设计: [填写：章节]_
+- [ ] 2.1 [填写：动词+对象+约束]
+  - 证据块: [填写：文件:行号]
+  - 文件: [填写：路径]（预算 [填写] 行）
+  - _需求: [填写：FR-n]_ · _设计: [填写：章节]_
+- [ ] 2.2 [填写：动词+对象+约束]
+  - 证据块: [填写：文件:行号]
+  - 文件: [填写：路径]（预算 [填写] 行）
+  - _需求: [填写：FR-n]_ · _设计: [填写：章节]_
 
 ---
 
 ### 阶段 3: 集成测试
 
-- [ ] 3.1 [填写：任务标题（对照验收标准核验）] — _需求: [填写：FR-n]_
+- [ ] 3.1 [填写：动词+对象+约束（对照验收标准逐条核验）]
+  - 验收点: [填写：对应哪条验收标准]
+  - _需求: [填写：FR-n]_
 
 ---
 
@@ -440,9 +492,17 @@ const EMBEDDED_TEMPLATES = {
 
 ## 文件变更清单
 
-| 文件 | 操作 | 说明 |
-|------|------|------|
-| [填写：文件路径] | 新建/修改 | [填写：说明] |
+| 文件 | 操作 | 行数预算 | 说明 |
+|------|------|----------|------|
+| [填写：文件路径] | 新建/修改 | [填写：≤500] | [填写：说明] |
+
+---
+
+## 交付前自检
+
+- [ ] 无占位符 / TODO / 省略注释
+- [ ] 交付物数量与 Scope-lock 一致
+- [ ] 每个文件 ≤ 500 行、每条任务回链 FR
 `,
 };
 export function normalizeTemplateProfile(input) {