feat: AI 修复预生成 + 审查面板 diff 预览两步确认 + SQLFluff 行号修复 + PMD 内置规则精简

- AI 修复预生成:静态/custom/AI 条目审查时预生成修复片段(originalText/newText),展开问题即显示行级 diff,无预生成时展示占位提示,匹配失败回退实时 LLM 生成

- 修复前 diff 预览:侧边新建编辑器组打开内置 diff,确认后写入(两步确认),不覆盖当前文件

- fix: sqlfluff 在 jinja 标签位于注释内时 JJ01 JSON 缺失 end_line_no/end_line_pos,适配器 Range 构造产生 NaN 被 VSCode 交换 start/end 导致行号 LNaN;新增 resolveSqlFluffRange 兜底 + 面板/report 行号 Number.isFinite 防御

- fix: 从 PMD 内置 ruleset 移除 5 条实际不可触发规则(AvoidAssertAsIdentifier、AvoidEnumAsIdentifier、AccessorClassGeneration、AccessorMethodGeneration、LoosePackageCoupling),内置配置 274→269 条全部可触发,同步 static-rules.json 与翻译脚本

- docs: README/DESIGN 更新
This commit is contained in:
范智鹏
2026-08-25 21:58:14 +08:00
parent 59e5fcde8c
commit 9c676e46e6
22 changed files with 445 additions and 86 deletions
+4 -4
View File
@@ -37,7 +37,7 @@
团队采用自定义方法论 **SDADStage-Driven Agent Development,阶段驱动智能体开发)**,定义于仓库根目录 `AGENTS.md`,以 AI 编码智能体(DeepSeek `deepseek-v4-flash / deepseek-v4-pro`)作为执行主体、人类作为阶段守门人。流程**顺序执行、不可跳过或合并**;②需求澄清为自循环、可能重复多次直至共识,④人类审批为**必经门**。**范式步骤名称即 AI 使用日志「范式步骤」列的取值**,一一对应、可逐条核验:
**① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批(必经门) → ⑤ 编码实现 → ⑥ 审查验证**
**① 用户提出 → ② 需求澄清 → ③ 方案设计 → ④ 人类审批 → ⑤ 编码实现 → ⑥ 审查验证**
```mermaid
flowchart TB
@@ -61,7 +61,7 @@ flowchart TB
S6 -.->|"修改建议 → 回退③"| S3
end
LOG["日志规则(每阶段完成后自动执行)<br/>立即向 _AI_USAGE_LOG.md 追加:日期时间(不可乱填或估算)· 范式步骤 · 修改摘要 · 中间过程 · 涉及文件 · 使用模型;完成记录后方可进入下一步"]
LOG["日志规则(每阶段完成后自动执行)<br/>立即向 _AI_USAGE_LOG.md 追加:日期时间(不可乱填或估算)· 范式步骤 · 修改摘要 · 中间产物 · 涉及文件 · 使用模型;完成记录后方可进入下一步"]
LINE -.->|"每阶段完成即记录"| LOG
@@ -92,7 +92,7 @@ flowchart TB
| ⑤ 编码实现 | 「Phase 1 基础层:类型定义 + 配置模块」「Phase 2.2 ESLint 适配器落地」「Phase 3 编排器」「Phase 4.2 AI 引擎 + Schema:流式逐块解析 + 验证 JSON」「Phase 5.1 命令注册器 + extension.ts 骨架:8 个命令注册」「Phase 6.1 构建脚本」 | `src/` 各模块源码 | deepseek-v4-flash / deepseek-v4-pro |
| ⑥ 审查验证 | 「编译/测试(lint & compile & test)」「美化 VSIX:修复 .vscodeignore 体积和 README」「交付检查:打标 VSIX」;回归记录「Bug fix: codeReviewer.openSetup 命令 catch 与用户交互不足」「Bug fix: stylelint 规则列表不存在 → .vscodeignore 忽略 .mjs」「修复界面原型:TreeView 和 Webview 不同步」「面板语言不匹配以及交互卡顿(分组延迟推送)」「AI 引擎重试逻辑优化」 | 通过 lint+test 的构建产物、.vsix 包、回归后的修复代码 | npm / F5 / vsce / deepseek-v4-flash |
> **闭环反馈机制**:① 顺序执行、不可跳过或合并,每个阶段完成后立即向 `_AI_USAGE_LOG.md` 追加一条记录(日期时间 / 范式步骤 / 修改摘要 / 中间过程 / 涉及文件 / 使用模型)方可进入下一步;② 需求澄清为自循环——沿设计树一次一问、重复多次直至共识达成;③ 人类审批为必经门——方案层面问题回退③方案设计、否决回退②需求澄清,未通过不得进入编码;④ 审查验证发现严重代码问题回退⑤编码实现(必要时上溯③方案设计),修改建议回退对应环节修复后回归验证;⑤ 线上缺陷作为新任务回到①用户提出重新走流程——由此构成「提出→澄清→设计→审批→编码→验证」的完整闭环。
> **闭环反馈机制**:① 顺序执行、不可跳过或合并,每个阶段完成后立即向 `_AI_USAGE_LOG.md` 追加一条记录(日期时间 / 范式步骤 / 修改摘要 / 中间产物 / 涉及文件 / 使用模型)方可进入下一步;② 需求澄清为自循环——沿设计树一次一问、重复多次直至共识达成;③ 人类审批为必经门——方案层面问题回退③方案设计、否决回退②需求澄清,未通过不得进入编码;④ 审查验证发现严重代码问题回退⑤编码实现(必要时上溯③方案设计),修改建议回退对应环节修复后回归验证;⑤ 线上缺陷作为新任务回到①用户提出重新走流程——由此构成「提出→澄清→设计→审批→编码→验证」的完整闭环。
---
@@ -254,7 +254,7 @@ flowchart TB
| DeepSeek`deepseek-v4-flash` / `deepseek-v4-pro`) | AI 编码智能体本体:由人类下达阶段指令,按 SDAD 技能逐步执行需求归纳、方案生成、原型生成、逐文件编码、缺陷修复(日志「使用工具」列全程留痕) |
| `AGENTS.md` | 方法论载体:五大铁律、六阶段技能加载规则、常用命令表;每次会话注入给智能体 |
| `.opencode/skills/stage-1-propose … stage-6-verify` | 六阶段执行技能:按阶段 `load skill stage-N-*` 切换智能体行为模式 |
| `_AI_USAGE_LOG.md` | 过程留痕账本:时间|范式步骤|工具类型|交互模式|耗时|使用工具,与范式图步骤名一一对应 |
| `_AI_USAGE_LOG.md` | 过程留痕账本:日期时间|范式步骤|修改摘要|中间产物|涉及文件|使用模型,与范式图步骤名一一对应 |
| `docs/superpowers/specs/` | 阶段产物库:design spec、implementation plan、20 个逐文件 step 文档、原型 HTML——「严禁提前实现」的依据 |
---