已开启
feat: 对齐模板/契约到 delivery-kit V2 基线(注入 OH-ARCH/context/复杂度裁剪) #7
feat: 对齐模板/契约到 delivery-kit V2 基线(注入 OH-ARCH/context/复杂度裁剪) #7
已开启
zhufenghao创建于 8月3日
zhufenghao
zhufenghao成员
8月3日

关联的issue:

Closes #2

修改描述:

以 ohos-delivery-kit(dev) V2 骨架为基线,对齐 ohos-sdd 的 4 个模板 + 契约 + CLI 锚点 + 示例,注入 ohos-sdd 独有价值。仅改 ohos-sdd,delivery-kit 作为参考基线不动。spec-for-validation 范式差异大,本期不改(Issue #2 已声明)。

涉及仓库:oshunter/ohos-sdd(本仓单仓)

模板(4 个,以 delivery-kit V2 骨架重写)

  • proposal.md:扁平骨架 + change_type/Agent Scope Guard/用户场景与业务触发(条件);保留澄清记录/方案探索/上下文检索日志。target_release 保留嵌套 {id,status}(下游 spec-repository-structure.md 多处引用 proposal.target_release.id,扁平化会引发连带破坏)。
  • spec.md:AC 统一 Given/When/Then + 独立 错误码定义/测试设计提示(Red 条件);保留接口规格(声明层)/非功能性/多设备/全局特性/context-references/自审清单。
  • design.md:采纳 代码事实基线/实现入口/状态归属与不变量/既有模式复用/类图(条件章节);保留 调用链层级分析/适用架构规则(OH-ARCH-*)/构建系统影响;安全基础检查 提升为主章节。
  • execution-plan.md:采纳 per-task RED→GREEN/状态所有权/任务间接口(Produces/Consumes)/Anti-Fake Completion/代码范围映射/Review Gates;保留 受影响文件全量清单。

契约(artifacts.yaml)

为 proposal/spec/design/execution-plan 补 required_sections/conditional_sections/owns,对齐 delivery-kit 契约严格度。保留 ohos-sdd schema ohos-sdd-artifacts/v1(CLI validate_contract_source 仅读 schema/archive/phase_order/template,新字段向前兼容,无破坏)。

CLI 锚点同步(保持验证基线绿)

模板标题变更后,CLI 硬编码的章节锚点必须同步,否则 validate --source 与 run_cli_smoke.sh 红:

  • ohos_sdd_engine.py:LEVEL_B 与 _HEADING_GROUPS 锚点更新(proposal→# Proposal/## 成功标准,spec→# Spec/## 验证映射,design→# Design,execution-plan→# Execution Plan);Level C 边 验收追溯→验证映射。
  • ohos_sdd_spec_for_validation.py:禁止令牌 ## 上下文和现状→## 调用链层级分析(design 章节已重命名)。

示例对齐

examples/archive-shape/.../issue-12345 的 proposal/spec/design/execution-plan H1 与 ## 成功标准 节对齐新模板(CLI smoke 依赖该样例)。

spec-validate.sh

proposal.md 文件名识别为 requirement 类型(移除旧"需求基线"文本标记后兜底识别失败)。

入库必检项

是否涉及非兼容变更: 否(模板/契约/锚点/示例对齐,CLI 逻辑仅改章节名常量,无行为语义变更)
TDD自验结果: 不涉及(无业务代码)
XTS自验结果: 不涉及
检视意见是否都已闭环: 是

验证(全绿)

  • validate-artifacts.sh(validate --source):PASS,195 checks,0 broken,0 warn
  • tests/run_cli_smoke.sh:pass=35 fail=0
  • tests/spec-validate.sh examples:0 FAIL,0 WARN
  • tests/quality-report.sh examples --no-summary:Spec 质量评估通过
  • tests/test-published-layout.sh:pass=13 fail=0
  • tests/validate-skills.sh:All 56 skill checks passed
  • CLI 模块 py_compile:OK
  • (pytest 本环境未安装,属既有环境限制,非回归)

不在范围(Issue #2 已声明)

  • spec-for-validation.md 范式统一(待决策)
  • examples/issue-99001 等其余样例按新结构刷新(可后续批量)
  • spec-validate.sh 占位符/校验深度增强(Issue #1 P1-5/P2-6)

提交信息

  • 分支:feat/align-templates-to-v2
  • Commit:feat: 对齐模板/契约到 delivery-kit V2 基线...(含 Co-Authored-By:Agent / Signed-off-by)
likedislike
合并受阻
zhufenghaozhufenghao成员
8月3日 关联了issue:docs: 仓库文档/索引一致性优化(模板索引缺漏、路径漂移、计数漂移等),feat: 对齐 ohos-sdd 模板与契约到 delivery-kit V2 基线