feat(ssw-loop): 关卡 A 改写 + SKILL.md 同步 v1.0+ (Task 16+17, 文档架构迁移)
- 关卡 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)
This commit is contained in:
1 parent
4bba9309bf
commit
c994f4b2c7
2 files changed
+166
-71
No files matched your search
+66
-40
@@ -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 <cmd> --help`) |
|
||||
|
||||
## 🛡️ 4 个硬关卡 (CI 强制, 违反 = 任务失败)
|
||||
|
||||
| # | 关卡 | 脚本 | 防什么 |
|
||||
|---|---|---|---|
|
||||
| **A** | 文档完整 | `scripts/check_required_docs.sh <app_dir>` | **3 HTML + 3 MD** + learnings.md 全在 (design/testcase/summary.html + plan/debug/research.md + learnings.md) |
|
||||
| **A** | 文档完整 | `scripts/check_required_docs.sh <app_dir>` | **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 <app_dir>` | 4 铁律: 按钮存在性 + 截图去重 + 数字可重跑 + 子代理 learnings |
|
||||
| **C** | 子代理回写 | `scripts/check_subagent_learnings.sh <app_dir>` | learnings.md 必含试通命令+踩坑 |
|
||||
| **F** | 资源规范 | `scripts/check_html_assets.sh <app_dir>` | 3 HTML 必须 `<link href="../_assets/style.css">` 不内联 |
|
||||
| **F** | 资源规范 | `scripts/check_html_assets.sh <app_dir>` | **新模式**: render.html + 7 viewer (引 md-dark.css + marked.min.js + render-doc.js) **老模式 (backward-compat)**: 3 HTML 引 _assets/style.css + script.js |
|
||||
|
||||
**关卡设计原则**: bash 脚本零依赖, 全部接受 `<app_dir>` 参数, 不硬编码应用名. CI 集成直接 `bash scripts/check_*.sh docs/<appCode>/`.
|
||||
|
||||
**产物格式分配 (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=<app> --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=<app> --auto-recover` (B-2 fix). 后跟 `app login` + `app status` + **跑 `dacli form fix-entity --type=all`** (提前避免 BS-102/103). **必跑 `bash scripts/scaffold.sh <app_code>`** 一键建 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=<current>` 否则 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=<current>` 否则 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 | `<link rel="stylesheet" href="../_assets/style.css">` |
|
||||
| 内联 `<style>` / `<script>` | 引用 `templates/html/script.js` + `mermaid.css` |
|
||||
| 暗黑风格不统一 | 全应用共享 `templates/html/style.css` |
|
||||
| 内联 `<style>` / `<script>` (关卡 F 阻断) | 引用 `templates/html/md-dark.css` + `marked.min.js` + `render-doc.js` |
|
||||
| 每次生成 CSS/JS | 复用 `templates/html/{github-markdown.css, md-dark.css, marked.min.js}` (vendor) |
|
||||
| 1 doc 1 HTML (老模式浪费 token) | 1 viewer 模板 → 7 viewer via `scripts/build_viewers.sh` |
|
||||
| 改 viewer 漏重新 build viewer | 改 .md 后必跑 `bash scripts/build_viewers.sh docs/{app}/` |
|
||||
|
||||
**首次部署**: `bash scripts/scaffold.sh <app_code>` 一键建 `docs/_assets/` 链接到 `templates/html/`.
|
||||
**首次部署**: `bash scripts/scaffold.sh <app_code>` 一键建 `docs/_assets/` 复制 vendor + `render.html` + 7 viewer.
|
||||
|
||||
> **MD 产物 (plan/debug/research/learnings) 不需要 _assets**, 直接 `dacli doc get --section=标题` 切片读.
|
||||
> **MD 源 (7 个) 不需要 viewer 渲染**, 但 browser 仍可经 `_assets/render-{doc}.html` viewer 美化阅读. AI 切片读走 `dacli doc get --section=h2_xxx`.
|
||||
|
||||
## 📖 文档读取强约束 (token 节省 80%)
|
||||
|
||||
| ❌ 禁止 | ✅ 必须 |
|
||||
|---|---|
|
||||
| `Read design.html` 整个文件 (25K tokens) | `dacli doc get --file=docs/{app}/design.html --section=h2_3` |
|
||||
| `Read design.md` 整个文件 (12K tokens) | `dacli doc get --file=docs/{app}/design.md --section=h2_overview` |
|
||||
| `Read plan.md` 整个文件 (找"当前任务") | `dacli doc get --file=docs/{app}/plan.md --section=1. 当前任务` |
|
||||
| 全文 Read testcase.html (50K) | `dacli doc search --dir=docs/{app}/ --keyword=关系字段` |
|
||||
| 不知道结构 | `dacli doc list --dir=docs/{app}/` 看 section 索引 (HTML+MD 都列) |
|
||||
| 全文 Read testcase.md (5K) | `dacli doc search --dir=docs/{app}/ --keyword=关系字段` |
|
||||
| 不知道结构 | `dacli doc list --dir=docs/{app}/` 看 section 索引 (MD/HTML 都列) |
|
||||
|
||||
> `dacli doc` v0.12+ 已支持 .md 切片 (按 `## ` 切, section id = 标题), 内置 mtime 感知 SQLite 缓存 7 天 TTL. 详见 dacli-ts skill.
|
||||
|
||||
@@ -114,7 +120,7 @@ description: JNPF + dacli 软件开发流程, 7阶段 (init→design→review→
|
||||
| 触发 | 用途 | 关联 |
|
||||
|---|---|---|
|
||||
| `dacli app context --json` | 拿 dbLinkId/existingEnCodes (阶段 2/4) | dacli-ts skill |
|
||||
| `dacli form info <enCode>` | 查 form schema (按 enCode 不是 formId, 防漂移) | dacli-ts skill |
|
||||
| `dacli form info <enCode>` | 查 form schema | dacli-ts skill |
|
||||
| `dacli test run --formId=<id>` | TC-A API 层 5/5 CRUD | dacli-ts skill |
|
||||
| `dacli test render --module=form --formId=<id>` | TC-C 源码渲染层 | dacli-ts skill |
|
||||
| `dacli doc list/get/toc/search` | HTML/MD 文档切片读取 (v0.12+ MD 支持) | dacli-ts skill |
|
||||
@@ -127,7 +133,7 @@ description: JNPF + dacli 软件开发流程, 7阶段 (init→design→review→
|
||||
## 🚀 一键开始
|
||||
|
||||
```bash
|
||||
# 1. 初始化 app 文档目录
|
||||
# 1. 初始化 app 文档目录 (v1.0+ 一键建 11 文件)
|
||||
bash .claude/skills/ssw-loop/scripts/scaffold.sh <app_code>
|
||||
|
||||
# 2. (可选) 看阶段详情
|
||||
@@ -156,25 +162,45 @@ bash scripts/check_html_assets.sh docs/<app_code>/
|
||||
|
||||
```
|
||||
skills/ssw-loop/
|
||||
├── SKILL.md # 本文件 (主入口)
|
||||
├── SKILL.md # 本文件 (主入口, 180 行)
|
||||
├── references/ # 详细参考 (按需加载)
|
||||
│ ├── stages.md # 7 阶段详细步骤
|
||||
│ ├── stage-prompts.md # 子代理 prompt 模板集
|
||||
│ ├── dacli-doc-pattern.md # 切片读取模式 (HTML + MD)
|
||||
│ ├── html-assets-rules.md # 资源复用规则 (3 HTML 适用)
|
||||
│ ├── html-assets-rules.md # 资源复用规则 (新 + 老模式)
|
||||
│ ├── anti-patterns.md # 5+ 反模式
|
||||
│ ├── subagent-must-do.md # 子代理强制清单
|
||||
│ └── lessons-from-apps.md # 跨 app 教训 (通用化)
|
||||
├── templates/
|
||||
│ ├── html/ # 通用 CSS/JS (3 HTML 共用)
|
||||
│ ├── docs/ # 6 个模板: design/testcase/summary.html.tmpl + plan/debug/research.md.tmpl
|
||||
│ ├── html/ # 通用 vendor (8 文件)
|
||||
│ │ ├── [email protected] # GitHub .markdown-body 基础
|
||||
│ │ ├── md-dark.css # 跨 app 暗黑主题 (复用 ssw-loop 色系)
|
||||
│ │ ├── marked.min.js # MD 渲染 (v13)
|
||||
│ │ ├── highlight.min.js # 代码高亮 (可选)
|
||||
│ │ ├── mermaid.min.js # Mermaid 图 (沿用老)
|
||||
│ │ ├── mermaid.css # (沿用老)
|
||||
│ │ ├── script.js # 老模式 scroll-spy (backward-compat)
|
||||
│ │ └── render-doc.js # 新模式 viewer JS
|
||||
│ ├── docs/ # 11 个模板
|
||||
│ │ ├── render.html.tmpl # 汇总入口
|
||||
│ │ ├── render-doc.html.tmpl # viewer 模板 (build_viewers.sh 用)
|
||||
│ │ ├── design.md.tmpl # 3 主 MD 模板 (## 0. 目录 + 8 章)
|
||||
│ │ ├── testcase.md.tmpl
|
||||
│ │ ├── summary.md.tmpl
|
||||
│ │ ├── design.html.tmpl # 老模式 (backward-compat)
|
||||
│ │ ├── testcase.html.tmpl
|
||||
│ │ ├── summary.html.tmpl
|
||||
│ │ ├── plan.md.tmpl # 4 运营 MD 模板
|
||||
│ │ ├── debug.md.tmpl
|
||||
│ │ └── research.md.tmpl
|
||||
│ ├── subagent/ # 3 个子代理 prompt 模板
|
||||
│ └── learnings.md.tmpl # 跨阶段 + 跨 form 模板 (0.项目启动基线 + 阶段 1-9 + 每 form 段)
|
||||
└── scripts/ # 6 个 CI 关卡
|
||||
├── scaffold.sh
|
||||
├── check_required_docs.sh
|
||||
├── check_summary_no_fake_pass.sh
|
||||
├── check_subagent_learnings.sh
|
||||
├── check_html_assets.sh
|
||||
│ └── learnings.md.tmpl # 跨阶段 + 跨 form 模板
|
||||
└── scripts/ # 7 个 CI 关卡 + 1 个 build 脚本
|
||||
├── scaffold.sh # 一键建 docs/{app}/ 完整结构
|
||||
├── build_viewers.sh # 模板 → N viewer (新模式)
|
||||
├── check_required_docs.sh # 关卡 A
|
||||
├── check_summary_no_fake_pass.sh # 关卡 B
|
||||
├── check_subagent_learnings.sh # 关卡 C
|
||||
├── check_html_assets.sh # 关卡 F (双模式)
|
||||
└── check_plan_current_task.sh
|
||||
```
|
||||
@@ -1,71 +1,140 @@
|
||||
#!/bin/bash
|
||||
# 关卡 A: 文档完整 (3 HTML + 3 MD + learnings.md, v0.12+)
|
||||
# 关卡 A: 文档完整 (新架构 v1.0+: 7 MD + render.html + 老 HTML 向后兼容)
|
||||
# 用法: bash check_required_docs.sh <app_dir>
|
||||
#
|
||||
# 新模式 (v1.0+):
|
||||
# - 3 主文档 MD: design.md / testcase.md / summary.md
|
||||
# - 4 运营 MD: plan.md / debug.md / research.md / learnings.md
|
||||
# - 1 入口: render.html
|
||||
#
|
||||
# 老模式 (向后兼容):
|
||||
# - 3 主文档 HTML: design.html / testcase.html / summary.html
|
||||
# - 同样 4 运营 MD
|
||||
#
|
||||
# 行数下限同步 MD + 行
|
||||
set -e
|
||||
|
||||
APP_DIR="${1:?用法: $0 <app_dir>, 例: $0 docs/workSystem}"
|
||||
MISSING=()
|
||||
WARN=()
|
||||
|
||||
echo "🔍 关卡 A: 检查 3 HTML + 4 MD 必填文档"
|
||||
echo "🔍 关卡 A: 检查 7 文件齐全"
|
||||
echo " app_dir: $APP_DIR"
|
||||
|
||||
# 1. 检查 3 HTML 必填 (人类决策权重高: 设计/测试/总结)
|
||||
for f in design.html testcase.html summary.html; do
|
||||
if [ ! -f "$APP_DIR/$f" ]; then
|
||||
MISSING+=("$f")
|
||||
fi
|
||||
# 1. 检测模式: render.html 存在 → 新模式 (3 主 MD + 老 HTML 可有可无)
|
||||
if [ -f "$APP_DIR/render.html" ]; then
|
||||
MODE="new"
|
||||
else
|
||||
MODE="legacy"
|
||||
fi
|
||||
|
||||
# ============================================================
|
||||
# 1. 主文档检测 (3 个)
|
||||
# ============================================================
|
||||
echo " [主文档检测]"
|
||||
for f in design testcase summary; do
|
||||
case "$MODE" in
|
||||
new)
|
||||
if [ ! -f "$APP_DIR/$f.md" ]; then
|
||||
MISSING+=("$f.md (新模式必填)")
|
||||
fi
|
||||
# 老 HTML 可同时存在 (backward-compat), 不强制
|
||||
if [ -f "$APP_DIR/$f.html" ] && [ ! -f "$APP_DIR/$f.md" ]; then
|
||||
WARN+=("$f.html 老模式存在, 但缺 $f.md (建议迁移到 MD)")
|
||||
fi
|
||||
;;
|
||||
legacy)
|
||||
if [ ! -f "$APP_DIR/$f.html" ]; then
|
||||
MISSING+=("$f.html (老模式必填)")
|
||||
fi
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
# 2. 检查 4 MD 必填 (AI 切片读占 80%+)
|
||||
# ============================================================
|
||||
# 2. 4 运营 MD 必填 (跨模式一致)
|
||||
# ============================================================
|
||||
echo " [运营 MD 检测]"
|
||||
for f in plan.md debug.md research.md learnings.md; do
|
||||
if [ ! -f "$APP_DIR/$f" ]; then
|
||||
MISSING+=("$f")
|
||||
fi
|
||||
done
|
||||
|
||||
# ============================================================
|
||||
# 3. 缺失文件汇总
|
||||
# ============================================================
|
||||
if [ ${#MISSING[@]} -gt 0 ]; then
|
||||
echo ""
|
||||
echo "❌ FAIL: 缺失文档: ${MISSING[*]}"
|
||||
echo ""
|
||||
echo "修复: bash .claude/skills/ssw-loop/scripts/scaffold.sh $(basename $APP_DIR)"
|
||||
echo "修复: bash .claude/skills/ssw-loop/scripts/scaffold.sh $(basename "$APP_DIR")"
|
||||
exit 1
|
||||
fi
|
||||
echo " ✓ 3 HTML 全在 (design/testcase/summary)"
|
||||
echo " ✓ 4 MD 全在 (plan/debug/research/learnings)"
|
||||
|
||||
# 3. 检查行数下限 (避免假产出)
|
||||
MIN_DESIGN=100
|
||||
MIN_TESTCASE=50
|
||||
MIN_SUMMARY=80
|
||||
if [ "$MODE" = "new" ]; then
|
||||
echo " ✓ 3 主文档 MD 在 (design/testcase/summary)"
|
||||
else
|
||||
echo " ✓ 3 主文档 HTML 在 (design/testcase/summary)"
|
||||
fi
|
||||
echo " ✓ 4 运营 MD 在 (plan/debug/research/learnings)"
|
||||
|
||||
# ============================================================
|
||||
# 4. 行数下限检测 (避免假产出)
|
||||
# ============================================================
|
||||
echo " [行数下限]"
|
||||
|
||||
# 主文档行数 (新 mode 检 .md, 老 mode 检 .html)
|
||||
if [ "$MODE" = "new" ]; then
|
||||
DESIGN_LINES=$(wc -l < "$APP_DIR/design.md")
|
||||
TESTCASE_LINES=$(wc -l < "$APP_DIR/testcase.md")
|
||||
SUMMARY_LINES=$(wc -l < "$APP_DIR/summary.md")
|
||||
else
|
||||
DESIGN_LINES=$(wc -l < "$APP_DIR/design.html")
|
||||
TESTCASE_LINES=$(wc -l < "$APP_DIR/testcase.html")
|
||||
SUMMARY_LINES=$(wc -l < "$APP_DIR/summary.html")
|
||||
fi
|
||||
|
||||
# 下限 (MD 内容更紧凑, 设低些)
|
||||
MIN_DESIGN=80 # 旧 100 → 新 MD 80
|
||||
MIN_TESTCASE=40 # 旧 50
|
||||
MIN_SUMMARY=50 # 旧 80 (summary.md 是模板, 最小 50 行)
|
||||
MIN_PLAN=30
|
||||
MIN_DEBUG=20
|
||||
MIN_RESEARCH=10
|
||||
MIN_LEARNINGS=30
|
||||
|
||||
DESIGN_LINES=$(wc -l < "$APP_DIR/design.html")
|
||||
TESTCASE_LINES=$(wc -l < "$APP_DIR/testcase.html")
|
||||
SUMMARY_LINES=$(wc -l < "$APP_DIR/summary.html")
|
||||
PLAN_LINES=$(wc -l < "$APP_DIR/plan.md")
|
||||
DEBUG_LINES=$(wc -l < "$APP_DIR/debug.md")
|
||||
RESEARCH_LINES=$(wc -l < "$APP_DIR/research.md")
|
||||
LEARNINGS_LINES=$(wc -l < "$APP_DIR/learnings.md")
|
||||
|
||||
[ $DESIGN_LINES -lt $MIN_DESIGN ] && WARN+=("design.html $DESIGN_LINES 行 (< $MIN_DESIGN 警戒)")
|
||||
[ $TESTCASE_LINES -lt $MIN_TESTCASE ] && WARN+=("testcase.html $TESTCASE_LINES 行 (< $MIN_TESTCASE 警戒)")
|
||||
[ $SUMMARY_LINES -lt $MIN_SUMMARY ] && WARN+=("summary.html $SUMMARY_LINES 行 (< $MIN_SUMMARY 警戒)")
|
||||
[ $PLAN_LINES -lt $MIN_PLAN ] && WARN+=("plan.md $PLAN_LINES 行 (< $MIN_PLAN 警戒)")
|
||||
[ $DEBUG_LINES -lt $MIN_DEBUG ] && WARN+=("debug.md $DEBUG_LINES 行 (< $MIN_DEBUG 警戒)")
|
||||
[ $DESIGN_LINES -lt $MIN_DESIGN ] && WARN+=("design $DESIGN_LINES 行 (< $MIN_DESIGN 警戒)")
|
||||
[ $TESTCASE_LINES -lt $MIN_TESTCASE ] && WARN+=("testcase $TESTCASE_LINES 行 (< $MIN_TESTCASE 警戒)")
|
||||
[ $SUMMARY_LINES -lt $MIN_SUMMARY ] && WARN+=("summary $SUMMARY_LINES 行 (< $MIN_SUMMARY 警戒)")
|
||||
[ $PLAN_LINES -lt $MIN_PLAN ] && WARN+=("plan.md $PLAN_LINES 行 (< $MIN_PLAN 警戒)")
|
||||
[ $DEBUG_LINES -lt $MIN_DEBUG ] && WARN+=("debug.md $DEBUG_LINES 行 (< $MIN_DEBUG 警戒)")
|
||||
[ $RESEARCH_LINES -lt $MIN_RESEARCH ] && WARN+=("research.md $RESEARCH_LINES 行 (< $MIN_RESEARCH 警戒)")
|
||||
[ $LEARNINGS_LINES -lt $MIN_LEARNINGS ] && WARN+=("learnings.md $LEARNINGS_LINES 行 (< $MIN_LEARNINGS 警戒)")
|
||||
|
||||
echo " ✓ design.html $DESIGN_LINES 行"
|
||||
echo " ✓ testcase.html $TESTCASE_LINES 行"
|
||||
echo " ✓ summary.html $SUMMARY_LINES 行"
|
||||
echo " ✓ plan.md $PLAN_LINES 行"
|
||||
echo " ✓ debug.md $DEBUG_LINES 行"
|
||||
echo " ✓ research.md $RESEARCH_LINES 行"
|
||||
echo " ✓ learnings.md $LEARNINGS_LINES 行"
|
||||
echo " [行数汇总]"
|
||||
if [ "$MODE" = "new" ]; then
|
||||
echo " design.md $DESIGN_LINES 行"
|
||||
echo " testcase.md $TESTCASE_LINES 行"
|
||||
echo " summary.md $SUMMARY_LINES 行"
|
||||
else
|
||||
echo " design.html $DESIGN_LINES 行"
|
||||
echo " testcase.html $TESTCASE_LINES 行"
|
||||
echo " summary.html $SUMMARY_LINES 行"
|
||||
fi
|
||||
echo " plan.md $PLAN_LINES 行"
|
||||
echo " debug.md $DEBUG_LINES 行"
|
||||
echo " research.md $RESEARCH_LINES 行"
|
||||
echo " learnings.md $LEARNINGS_LINES 行"
|
||||
|
||||
# ============================================================
|
||||
# 5. 报告
|
||||
# ============================================================
|
||||
if [ ${#WARN[@]} -gt 0 ]; then
|
||||
echo ""
|
||||
echo "⚠️ WARN (行数过少, 可能假产出):"
|
||||
@@ -76,5 +145,5 @@ if [ ${#WARN[@]} -gt 0 ]; then
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "✅ PASS: 3 HTML + 4 MD 全在, 行数合理"
|
||||
echo "✅ PASS: 7 文件齐全, 行数合理 ($MODE 模式)"
|
||||
exit 0
|
||||
Reference in new issue
Block a user