已开启
feat: 对齐模板/契约到 delivery-kit V2 基线(注入 OH-ARCH/context/复杂度裁剪) #7
zhufenghao创建于 8月3日
feat: 对齐模板/契约到 delivery-kit V2 基线(注入 OH-ARCH/context/复杂度裁剪) #7
已开启
合并受阻
8月3日 关联了issue:docs: 仓库文档/索引一致性优化(模板索引缺漏、路径漂移、计数漂移等),feat: 对齐 ohos-sdd 模板与契约到 delivery-kit V2 基线
8月3日 关联了issue:docs: 仓库文档/索引一致性优化(模板索引缺漏、路径漂移、计数漂移等),feat: 对齐 ohos-sdd 模板与契约到 delivery-kit V2 基线
关联的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 骨架重写)
change_type/Agent Scope Guard/用户场景与业务触发(条件);保留澄清记录/方案探索/上下文检索日志。target_release保留嵌套{id,status}(下游spec-repository-structure.md多处引用proposal.target_release.id,扁平化会引发连带破坏)。Given/When/Then+ 独立错误码定义/测试设计提示(Red 条件);保留接口规格(声明层)/非功能性/多设备/全局特性/context-references/自审清单。代码事实基线/实现入口/状态归属与不变量/既有模式复用/类图(条件章节);保留调用链层级分析/适用架构规则(OH-ARCH-*)/构建系统影响;安全基础检查提升为主章节。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 schemaohos-sdd-artifacts/v1(CLIvalidate_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 warntests/run_cli_smoke.sh:pass=35 fail=0tests/spec-validate.sh examples:0 FAIL,0 WARNtests/quality-report.sh examples --no-summary:Spec 质量评估通过tests/test-published-layout.sh:pass=13 fail=0tests/validate-skills.sh:All 56 skill checks passedpy_compile:OKpytest本环境未安装,属既有环境限制,非回归)不在范围(Issue #2 已声明)
spec-for-validation.md范式统一(待决策)examples/issue-99001等其余样例按新结构刷新(可后续批量)spec-validate.sh占位符/校验深度增强(Issue #1 P1-5/P2-6)提交信息
feat/align-templates-to-v2feat: 对齐模板/契约到 delivery-kit V2 基线...(含 Co-Authored-By:Agent / Signed-off-by)