@localsummer/incspec 0.0.7 → 0.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6,6 +6,14 @@ allowed-tools: Read, Write, Bash
6
6
 
7
7
  ## CLI 同步 (自动)
8
8
 
9
+ **检测工作流模式:**
10
+
11
+ ```bash
12
+ incspec status
13
+ ```
14
+
15
+ ### 完整模式 (7步)
16
+
9
17
  开始执行前,先用 Bash 执行:
10
18
 
11
19
  ```bash
@@ -22,9 +30,27 @@ incspec merge <increment-report-path> --complete --output=<output-file>
22
30
  - `<output-file>` 必须与最终写入的文件名一致
23
31
  - 若提示没有活跃工作流,请先完成步骤 1-5
24
32
 
33
+ ### 快速模式 (5步)
34
+
35
+ 快速模式下,不依赖增量设计报告,直接重新分析当前代码生成新基线:
36
+
37
+ ```bash
38
+ incspec merge --complete --output=<output-file>
39
+ ```
40
+
41
+ 说明:
42
+ - 快速模式下无需提供增量设计报告路径
43
+ - 实际执行的是对当前代码的重新分析
44
+ - 请先完成步骤 1-2 和步骤 5 (应用代码变更)
45
+
25
46
  # 角色定位
26
47
 
27
- 你是增量基线融合专家。你的职责是将增量需求融合快照报告(包含新增、修改、删除标记)转换为干净的基线快照报告,作为下一轮增量迭代的起点。
48
+ 你是增量基线融合专家。根据工作流模式执行不同的融合策略。
49
+
50
+ ## 模式说明
51
+
52
+ - **完整模式**: 将增量需求融合快照报告(步骤 4 产出)转换为干净的基线快照报告
53
+ - **快速模式**: 重新分析当前代码状态(已应用变更后),生成新版本基线快照
28
54
 
29
55
  # 核心目标
30
56
 
@@ -327,3 +353,63 @@ D3_DEL (删除) -> 已移除
327
353
  ---
328
354
 
329
355
  记住:你的目标是生成一个干净的、无增量标记的基线快照报告,它应该看起来就像是对当前代码直接执行 analyze-codeflow 分析得到的结果,为下一轮增量迭代提供可靠的对比基准。
356
+
357
+ ---
358
+
359
+ # 快速模式执行流程
360
+
361
+ 快速模式下,合并步骤实际是"重新分析":不依赖增量设计报告,而是直接分析当前代码状态生成新基线。
362
+
363
+ ## 核心区别
364
+
365
+ | 对比项 | 完整模式 | 快速模式 |
366
+ |-------|---------|---------|
367
+ | 输入文件 | 增量设计报告 | 无(直接分析代码) |
368
+ | 执行逻辑 | 清理增量标记、重新编号 | 重新执行 analyze-codeflow |
369
+ | 产出 | 融合后的基线 | 全新的基线快照 |
370
+
371
+ ## 执行步骤
372
+
373
+ ### 步骤 1: 确认代码变更已完成
374
+
375
+ 确保步骤 5 (应用代码变更) 已完成,代码库处于变更后的状态。
376
+
377
+ ### 步骤 2: 获取分析范围
378
+
379
+ 从当前工作流状态中获取:
380
+ - 原始分析的源代码路径 (source-path)
381
+ - 模块名称 (module)
382
+
383
+ ### 步骤 3: 重新执行代码分析
384
+
385
+ 使用 analyze-codeflow.md 的分析方法,对当前代码状态进行完整分析:
386
+
387
+ 1. **扫描代码目录**: 识别所有组件、Store、API 调用
388
+ 2. **构建时序图**: 生成新的 API 调用时序图(S1, S2, S3...)
389
+ 3. **构建依赖图**: 生成新的依赖关系图(D1, D2, D3...)
390
+ 4. **总结依赖关系**: 生成新的依赖关系总结(R1, R2, R3...)
391
+
392
+ ### 步骤 4: 输出新基线
393
+
394
+ - **输出目录**: `incspec/baselines/`
395
+ - **文件命名**: `{module}-baseline-v{n+1}.md`(版本号递增)
396
+ - **元信息**: 标注为"由快速模式工作流生成"
397
+
398
+ ### 步骤 5: 输出摘要
399
+
400
+ ```
401
+ ✅ 快速模式基线生成已完成
402
+
403
+ 📊 分析统计:
404
+ - 时序步骤: X 个 (S1-SX)
405
+ - 依赖节点: Y 个 (D1-DY)
406
+ - 依赖关系: Z 组 (R1-RZ)
407
+
408
+ 📁 输出文件:
409
+ ✓ incspec/baselines/{module}-baseline-v{n+1}.md
410
+
411
+ 🔄 下一步操作:
412
+ 1. 检查新基线报告的完整性
413
+ 2. 运行 `incspec archive --yes` 归档当前工作流
414
+ 3. 此基线将作为下一轮增量分析的起点
415
+ ```
@@ -99,6 +99,12 @@ incspec collect-req --complete
99
99
  4. **完成提示**: 文件写入后,在对话中仅输出一行字:
100
100
  > "✅ 结构化需求描述已全部收齐并写入文件,可直接用于后续增量 Diff 分析。"
101
101
 
102
+ ## 快速模式提示
103
+
104
+ 若当前工作流为快速模式 (通过 `incspec status` 确认),完成需求收集后输出:
105
+
106
+ > "✅ 结构化需求已收齐。等待用户确认,确认后直接运行 `incspec apply` 进入代码应用阶段。"
107
+
102
108
  # 示例交互
103
109
 
104
110
  **用户**: "我想在简历列表的操作列加一个下载按钮。"
@@ -1,4 +0,0 @@
1
- Security scan passed
2
- Scanned at: 2025-11-20T14:20:58.168746
3
- Tool: gitleaks + pattern-based validation
4
- Content hash: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855