From c994f4b2c71e7932561165bb4b3f5fac1d06b5ca Mon Sep 17 00:00:00 2001 From: ssw Date: Thu, 16 Jul 2026 20:11:08 +0800 Subject: [PATCH] =?UTF-8?q?feat(ssw-loop):=20=E5=85=B3=E5=8D=A1=20A=20?= =?UTF-8?q?=E6=94=B9=E5=86=99=20+=20SKILL.md=20=E5=90=8C=E6=AD=A5=20v1.0+?= =?UTF-8?q?=20(Task=2016+17,=20=E6=96=87=E6=A1=A3=E6=9E=B6=E6=9E=84?= =?UTF-8?q?=E8=BF=81=E7=A7=BB)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 关卡 A: 检测 7 文件 (3 主 MD 优先 + 1 render.html + 4 运营 MD); 老模式 3 HTML backward-compat - SKILL.md: 重写文档格式分配段 (v1.0+ 新架构), 关卡 F/A 描述同步, 目录速查覆盖 8 vendor + 11 tmpl + 7 script - 行数下限同步 MD 数 (老 HTML 100/50/80 → MD 80/40/50) --- skills/ssw-loop/SKILL.md | 106 ++++++++------ .../ssw-loop/scripts/check_required_docs.sh | 131 +++++++++++++----- 2 files changed, 166 insertions(+), 71 deletions(-) diff --git a/skills/ssw-loop/SKILL.md b/skills/ssw-loop/SKILL.md index 60cb88c..a15fe36 100644 --- a/skills/ssw-loop/SKILL.md +++ b/skills/ssw-loop/SKILL.md @@ -1,6 +1,6 @@ --- name: ssw-loop -description: JNPF + dacli 软件开发流程, 7阶段 (init→design→review→execute→test→summary→iterate). 产物 = 3 HTML (设计/测试/总结) + 4 MD (计划/问题/调研/踩坑) + 子代理派发 + 三层验证 ladder + 4 关卡 CI. 触发词: 开发/带 appCode/ssw-loop. +description: JNPF + dacli 软件开发流程, 7阶段 (init→design→review→execute→test→summary→iterate). v1.0+ 产物 = 7 MD (3 主 design/testcase/summary + 4 运营 plan/debug/research/learnings) + 1 render.html 汇总 + 7 _assets/render-*.html viewer + 子代理派发 + 三层验证 ladder + 4 关卡 CI. 触发词: 开发/带 appCode/ssw-loop. --- # ssw-loop @@ -15,40 +15,45 @@ description: JNPF + dacli 软件开发流程, 7阶段 (init→design→review→ | "只跑测试" | → 阶段 5 | 触发 ssw-e2e-test skill + dacli test run/render | | "只改某个 form" | → 阶段 4 子代理 | templates/subagent/form-create.md.tmpl | | "上下文恢复" (compaction 后) | → 恢复 | 先跑 `dacli app status` + `dacli doc get plan.md --section=1. 当前任务` | -| "总结" | → 阶段 6 | templates/docs/summary.html.tmpl + 跑 4 关卡 | +| "总结" | → 阶段 6 | templates/docs/summary.md.tmpl + 跑 4 关卡 | | "怎么用 dacli" | → 不在本 skill | 触发 dacli-ts skill (用 `dacli --help` / `dacli --help`) | ## 🛡️ 4 个硬关卡 (CI 强制, 违反 = 任务失败) | # | 关卡 | 脚本 | 防什么 | |---|---|---|---| -| **A** | 文档完整 | `scripts/check_required_docs.sh ` | **3 HTML + 3 MD** + learnings.md 全在 (design/testcase/summary.html + plan/debug/research.md + learnings.md) | +| **A** | 文档完整 | `scripts/check_required_docs.sh ` | **7 文件齐全**: 3 主 MD (design/testcase/summary) + 1 render.html (新模式) / 3 主 HTML (老模式 backward-compat) + 4 运营 MD (plan/debug/research/learnings) | | **B** | 防假 PASS | `scripts/check_summary_no_fake_pass.sh ` | 4 铁律: 按钮存在性 + 截图去重 + 数字可重跑 + 子代理 learnings | | **C** | 子代理回写 | `scripts/check_subagent_learnings.sh ` | learnings.md 必含试通命令+踩坑 | -| **F** | 资源规范 | `scripts/check_html_assets.sh ` | 3 HTML 必须 `` 不内联 | +| **F** | 资源规范 | `scripts/check_html_assets.sh ` | **新模式**: render.html + 7 viewer (引 md-dark.css + marked.min.js + render-doc.js) **老模式 (backward-compat)**: 3 HTML 引 _assets/style.css + script.js | **关卡设计原则**: bash 脚本零依赖, 全部接受 `` 参数, 不硬编码应用名. CI 集成直接 `bash scripts/check_*.sh docs//`. -**产物格式分配 (v0.12+ 新)**: -- **HTML (3 个, 人类决策权重高)**: `design.html` `testcase.html` `summary.html` — 暗黑风格 + TOC + Mermaid, 人类打开浏览器最佳 -- **MD (4 个, AI 切片读占 80%+)**: `plan.md` `debug.md` `research.md` `learnings.md` — 纯文本, `dacli doc get --section=标题` 精确切片 +**产物格式分配 (v1.0+ 新架构, 2026-07-16 jxcj M1 实战沉淀)**: +- **MD 源 (7 个, AI + 人类通用)**: `design.md` `testcase.md` `summary.md` `plan.md` `debug.md` `research.md` `learnings.md` — 纯文本, `dacli doc get --section=h2_xxx` 精确切片 +- **render.html (1 个, 汇总入口)**: `_assets/md-dark.css` 暗黑主题, 链接 7 viewer +- **`_assets/render-{doc}.html` (7 个, viewer)**: 1 模板 → 7 viewer (`scripts/build_viewers.sh` 生成), 左 sidebar TOC + scroll-spy + 主区域 marked 渲染 + mermaid SVG +- **暗黑 CSS (1 个, 跨 app 通用)**: `templates/html/md-dark.css` 复用 ssw-loop 现有暗黑色系 (#0d1117 背景 / #00d4ff 青 / #58a6ff 蓝) + +> 老模式 (3 HTML + style.css) backward-compat 保留, 已迁完的 app 仍能 PASS 关卡 F (新模式检测) + 关卡 A (legacy mode). ## 🔄 7 阶段流程 (详情 → `references/stages.md`) | 阶段 | 主代理职责 | 子代理职责 | 必填产物 | |---|---|---|---| -| 1. 初始化 | **分支: 全新 app** → `dacli app create --appCode=<新app> --appName=<中文> --account=admin --password=123456` 端到端 (v3.0+ 已删 `--restart`); **现有 app 重建 system** → `dacli app init --appCode= --auto-recover` (B-2 fix). 后跟 `app login` + `app status` + **跑 `dacli form fix-entity --type=all`** (提前避免 BS-102/103) | — | `plan.md` 元信息 + **当前任务段 + 项目启动基线段 (## 0. ...)** | -| 2. 设计 | 派 N 代理 (按模块/表) | design.html + testcase.html + research.md (含字段类型映射 §2) | 2 HTML + 1 MD + assets/ | -| 3. 审核 | 多角色虚拟评审 | 修正 design.html/testcase.html | 评审记录 | +| 1. 初始化 | **分支: 全新 app** → `dacli app create --appCode=<新app> --appName=<中文> --account=admin --password=123456` 端到端 (v3.0+ 已删 `--restart`); **现有 app 重建 system** → `dacli app init --appCode= --auto-recover` (B-2 fix). 后跟 `app login` + `app status` + **跑 `dacli form fix-entity --type=all`** (提前避免 BS-102/103). **必跑 `bash scripts/scaffold.sh `** 一键建 docs/{app}/ (含 render.html + 7 viewer) | — | `plan.md` 元信息 + **当前任务段 + 项目启动基线段 (## 0. ...)** | +| 2. 设计 | 派 N 代理 (按模块/表) | **3 主 MD** (design.md + testcase.md + summary.md 的 ## 0. 目录 + 8 章) + research.md (含字段类型映射 §2) | 3 MD + research.md + assets/ | +| 3. 审核 | 多角色虚拟评审 | 修正 design.md/testcase.md (## 8 评审记录段) | 评审记录 | | 4. 执行 | **派子代理 (1 form = 1 代理)** | dm→form→menu + **learnings.md 强制写入 (每段必含 试通命令+踩坑+关键决策)** | form + menu + learnings 1 段 + plan.md "已决事项" 1 行 | -| 5. 测试 | 串 **TC-A → TC-C → TC-B** (顺序固定, 与 stages.md:110 一致; SKILL.md 早期写错已修正) | **派子代理**跑每层 (TC-A API (~5s) → TC-C 源码渲染层 9 关 (`dacli test render --module=form\|workflow\|portal\|di\|report\|bigscreen\|menu\|role\|user\|log`) → TC-B 浏览器真实 7 检查 (v0.14+ webapi+浏览器, **必传 `--appCode=` 否则 BS-新10**, 见 `ssw-e2e-test/references/tc-ab-real-test.md`)) | test_logs/ + screenshots/ + debug.md 问题记录 | -| 6. 总结 | summary.html + **跑关卡 B** | — | summary.html (含 4 铁律证据) | +| 5. 测试 | 串 **TC-A → TC-C → TC-B** (顺序固定) | **派子代理**跑每层 (TC-A API → TC-C 源码渲染层 9 关 → TC-B 浏览器真实 7 检查, 必传 `--appCode=` 否则 BS-新10) | test_logs/ + screenshots/ + debug.md 问题记录 | +| 6. 总结 | summary.md + **跑关卡 B** + **跑 4 关卡 (A/F/B/C)** | — | summary.md (含 4 铁律证据) | | 7. 迭代 | 阶段 2 重启 (按新需求) | — | updated docs (跨迭代累计不删) | -> **🆕 v0.12+ (jxcj 2026-06-30 实战)**: -> - **阶段 1 后强制跑** `dacli form fix-entity --type=all` (P0 修复 entity @TableId + Service NPE) -> - **learnings.md 必含** `## 0. 项目启动基线` 段 (v0.12+ 新模板) + `## {enCode}` per-form 段 -> - **关卡 C** 接受 `## 0.` 段(无 form 段也 PASS, 跨 appCode 通用) +> **🆕 v1.0+ (jxcj 2026-07-16 实战沉淀, 文档架构迁移)**: +> - **scaffold.sh 一键建 11 文件**: render.html + 3 主 MD + 4 运营 MD + 7 viewer (auto-build) + 1 主题 CSS +> - **MD 全文搜索 ROI**: 单 460 行 design.md 比 25K tokens HTML 省 99% (`dacli doc get --section=h2_xxx`) +> - **viewer 自动 build**: 改 1 个 MD 源, 重跑 `bash scripts/build_viewers.sh docs/{app}/` 重新生成 viewer +> - **关卡 F 双模式**: 新模式 (1 render.html + 7 viewer) + 老模式 (3 HTML backward-compat) > > **🆕 v0.21+ (jxcj 2026-07-15 实战, 大应用强制 M 分批)**: > - **大应用** (≥10 模块 ≥20 表, e.g. jxcj 11 模块 27 表) 强制 **M 分批**: @@ -70,7 +75,7 @@ description: JNPF + dacli 软件开发流程, 7阶段 (init→design→review→ **禁止改 dacli 红线** (痛点: 经常乱改 dacli): - ❌ 禁止改 `dacli/`、`web/`、`uniapp/`、`jnpf/` -- ✅ 允许改 `docs/{app_code}/{plan,debug,research,learnings}.md`、`boot/ssw-{app_code}-biz/` +- ✅ 允许改 `docs/{app_code}/*.md` + `boot/ssw-{app_code}-biz/` + viewer 重新 build (跑 scripts/build_viewers.sh) - ❌ dacli FAIL → 派子代理修 dacli (4 步法), 不绕过 - ❌ 禁止用 curl 绕 dacli @@ -79,28 +84,29 @@ description: JNPF + dacli 软件开发流程, 7阶段 (init→design→review→ - 写后必填 1 段 (试通命令 + 踩坑 + 关键决策) - 不写 = 任务失败 (关卡 C 检测) -## 🎨 HTML 资源强约束 (token 节省 80%) +## 🎨 文档资源强约束 (v1.0+ 新架构, token 节省 80%) -> **适用范围**: 仅 design.html / testcase.html / summary.html (3 个, 关卡 F 检测) +> **适用范围**: render.html + 7 _assets/render-*.html viewer (关卡 F 检测) | ❌ 禁止 | ✅ 必须 | |---|---| -| 每次生成 CSS/JS | `` | -| 内联 `