ohos-sdd

OpenHarmony 规范驱动开发（SDD）工作流插件。将 AI Coding、需求工程、架构设计和质量门禁实践，导出为适合 OpenHarmony 大型多仓项目的可执行流程、模板和工具。

安装

oh-skillhub（推荐）

统一安装器，自动从 openharmony-skills release 分支拉取并生成 Claude Code / Codex / OpenCode 三端载荷。使用指南见 oh-skillhub issue #8。

ohos-marketplace（备选）

从 ohos-marketplace 仓手动安装三端 dist 产物。

本地开发安装

cd ohos-sdd
bash packaging/build.sh
# 产物在 dist/{platform}/ohos-sdd/

仓库结构

ohos-sdd/
├── plugin.yaml              # 插件清单（oh-skillhub 格式）
├── provenance.yaml          # 来源追踪
├── skills/                  # 10 个 SKILL.md（唯一源）
├── prompts/                 # session-router.md
├── hooks/                   # session-router.yaml
├── runtime/assets/          # 运行时资产
│   ├── cli/                 # ohos-sdd CLI (4 文件)
│   ├── templates/           # 模板 (20 文件)
│   ├── profiles/            # Profile (12 文件)
│   ├── contracts/           # Contract (2 文件)
│   ├── workflow/            # 工作流 (3 文件)
│   ├── analysis/            # 子系统分析 (11 文件)
│   └── rules/               # 架构规则 (8 文件)
├── docs/                    # 文档（不进插件发布）
├── examples/                # 示例（不进插件发布）
├── tests/                   # 自验脚本（不进插件发布）
└── packaging/               # 三端分发
    ├── build.sh
    ├── claude/
    ├── codex/
    └── opencode/

4 阶段工作流

定义 (Define) → 规格化 (Specify) → 设计 (Design) → 计划 (Plan)

定义 (Define)：proposal.md 需求输入 + 已确认基线（含 Agent Scope Guard）以及按条件启用的澄清决策附录
规格化 (Specify)：spec.md 特性规格（WHEN/THEN 外部行为、Public/System/InnerAPI 可观察性、API/错误码事实、开放级别、测试 Red 条件与兼容性）
设计 (Design)：design.md 架构设计；按条件补代码事实基线、既有模式复用、类图及 STATE/INV 状态不变量追溯
计划 (Plan)：execution-plan.md 执行计划，覆盖任务边界、Expected/Actual、Anti-Fake Completion 及 AC→Task→Code 追溯；Commit 可按项目需要增强，Review Evidence 按实际范围触发
最小交付合同：固定为 proposal.md、spec.md、design.md、execution-plan.md 四件套；简单变更通过缩短内容裁剪，不省略文件
运行时与过程资产：manifest.md 是推荐的运行时元数据；review.md、evidence/gates/ 为可选过程证据；evidence/checks/ 通常可选，但所选 Profile 声明 required Gate 时按阶段状态触发，且已有证据始终严格校验；evidence/reviews/ 状态触发（与复杂度无关）——代码范围映射的实际范围包含代码文件时归档必须三份 Approved Review Evidence，纯文档/规格变更（实际范围仅文档类文件或 N/A：理由）可选（存在即严校验）
归档（硬门禁）：ohos-sdd archive 写 registry 前强制通过 Level A–E；Profile Gate 声明、阶段证据或 Verdict 不一致时拒绝归档，失败不产生 registry 副作用

详见 docs/guide/workflow-guide.md。

Skills

Skill	用途
`using-ohos-sdd`	元路由：识别当前阶段，分发到对应能力 skill
`ohos-propose`	Define：proposal.md 需求澄清与基线
`ohos-spec`	Specify：spec.md 特性规格
`ohos-design`	Design：design.md 架构设计
`ohos-plan`	Plan：execution-plan.md；按需拆分 task.md
`ohos-review`	审查：规范符合性 + 代码质量
`ohos-validate`	A–E 分级校验（声称完成前必跑）
`ohos-clarify`	需求澄清与不涉及项确认
`ohos-security-threat-model`	高风险安全/隐私/合规变更的威胁建模
`ohos-spec-for-validation`	spec-for-validation.md 生成与检查

验证

# 运行全部测试
cd ohos-sdd
python3 -m pytest tests/test_validate.py tests/test_mini_yaml.py -v
bash tests/run_cli_smoke.sh
bash tests/test-published-layout.sh
bash tests/spec-validate.sh examples
bash tests/quality-report.sh examples --no-summary
bash tests/validate-skills.sh

# 构建 dist
bash packaging/build.sh

发布链路

ohos-sdd 仓 (plugin.yaml + skills/ + runtime/assets/)
    ↓ PR 同步 (publish-plugins.sh --target openharmony-skills)
openharmony-skills release (workflows/ohos-sdd/)
    ↓ oh-skillhub 拉取
三端安装 (Claude / Codex / OpenCode)