kld-sdd 2.6.11 → 2.6.13

package/README.md

@@ -104,6 +104,25 @@ npx kld-sdd
 
 初始化完成后，打开你的 AI 编辑器，激活 `opsx-*` skills 开始工作。
 
+### 提效评估报告（SkyWalk V3）
+
+归档与独立 `report` 命令会基于同一 Report Model 生成 Markdown / HTML / JSON 三份同源产物（`schema_version=sdd-efficiency-report/v3`）。单次变更 HTML 使用桌面方案 A，只展示当前 change 的四个页签：概览、指标与阶段、问题与证据、产物与追溯，不混入跨变更趋势。
+
+报告中的业务名称优先于缩写：E1=每个验收场景平均用时，Q3=规约检查得分，P4=编码前检查覆盖，P-R=标准阶段重复次数，P-H=执行记录完整度。标准测量阶段固定为 propose、spec、design、task、check、apply、archive；test、explore 是辅助阶段，可展示但不进入效率分母。
+
+```bash
+# 单变更报告（默认 html；可指定 markdown/json）
+node skywalk-sdd/log.cjs report --project=. --change=<name> --format=json --output=reports/demo.json
+
+# 双周 / 月度周期对比（需完整窗口）
+node skywalk-sdd/log.cjs report --project=. --period=biweekly --date-from=YYYY-MM-DD --date-to=YYYY-MM-DD
+node skywalk-sdd/log.cjs report --project=. --period=monthly --date-from=YYYY-MM-DD --date-to=YYYY-MM-DD
+```
+
+`propose` 须确认 `change-type`；所有阶段必须显式携带 change，历史 general 事件只能通过 `scope_link` 归属。`check_result` 应携带 reviewer 独立性与 warning 处置元数据；归档 `archive_result` 只列真实写入成功的 `report_path` / `report_html_path` / `report_json_path`。
+
+任务采用两个不可混淆的口径：“文档完成度”来自 tasks checkbox，“事件可追溯度”来自严格 task/test 证据。问题同时显示“类别数”和“规则命中次数”；指标同时显示“可计算性”和“可信度”。旧 E4/P1/P2/Q5 与旧 Q3 构建一次通过率仅出现在 legacy 区。
+
 ---
 
 ## 核心工作流：5 个 skills
@@ -285,6 +304,7 @@ your-project/
 │   └── tasks.md
 ├── skywalk-sdd/
 │   ├── log.cjs                      # Telemetry + semantic-* 命令入口
+│   ├── metrics-v3.cjs               # V3 提效评估纯计算模块（随 init 部署）
 │   ├── ontology/                    # 本地本体解析、校验、观察和对账运行时
 │   └── state/ontology/
 │       ├── .locks/<change>.lock     # observe/reconcile/check/archive 跨进程锁