文件	最后提交记录	最后更新时间
docs	docs: user-guide 版本口径对齐 CHANGELOG 0.5.0 Unreleased CLI version 命令发布前仍报 0.4.0（惯例），但本文档化的四件套契约/ 归档硬门禁/状态触发 evidence 均属 CHANGELOG [0.5.0] Unreleased，适用版本表述按此澄清，避免读者对照 CHANGELOG 困惑。 Co-Authored-By: Claude <noreply@anthropic.com>	2 个月前
examples	docs: user-guide 对齐 #10/#15 合入后行为；修复 archive-shape README 过时口径 - user-guide：init/status/validate 输出按当前 main 重捕——四件套脚手架（不再生成 manifest/evidence）、 12345 全绿 41 checks、脚手架红示例改为内容级（spec-quality/design-quality/ source-references/placeholders）；archive 节由「#10 预告」改为现行硬门禁行为； Level D 速查与 EDGE 路由表补齐 spec-quality/then-boundary/design-quality/ plan→source-references 等新边；FAQ-1 兜底改四件套逐一校验；FAQ-4 改为四件套必需、task.md 不可替代 execution-plan - examples/archive-shape/README：99001 预期红因改为 manifest.status + 0.4.x 旧 plan 形态（implementation-evidence），回修路由 ohos-validate/ ohos-plan；evidence 门禁措辞改状态触发（PR #15 review 遗留的过时口径） Co-Authored-By: Claude <noreply@anthropic.com>	2 个月前
hooks	feat: initial migration from spec-for-ai to ohos-sdd (v0.4.0) 迁移内容: - skills/ (10 SKILL.md + README.md) - runtime/assets/ (cli 4 + templates 17 + profiles 11 + contracts 2 + workflow 3 + analysis 11 + rules 8) - examples/ (2 change 示例 + bugfix 示例) - tests/ (8 自验脚本，路径适配新布局) - docs/ (design-overview + workflow-guide + security-guide，9→3 文件合并) - packaging/ (精简 build.sh + 三端平台模板) - plugin.yaml + provenance.yaml + hooks/ + prompts/ - README.md + AGENTS.md + CHANGELOG.md + .gitignore CLI 引擎适配: - 支持 3 种布局:源仓 openharmony/、发布 flat、新仓 runtime/assets/ - validate_contract_source() 新增 runtime/assets/contracts/ 回退 - _find_profiles_dir() 新增 runtime/assets/profiles walk-up - _root_from_change() 新增 runtime/assets/ 目录检测 - contract_template_checks._resolve() 新增 runtime/assets 前缀 - 静态模板路径解析新增 openharmony/ 前缀剥离 + runtime/assets/ 回退验证: - pytest 76 passed - run_cli_smoke.sh 35 pass 0 fail - test-published-layout.sh 13 pass 0 fail - spec-validate.sh 95 pass 0 fail 0 warn - validate-skills.sh 86 pass 0 fail - validate-artifacts.sh 190 checks 0 broken - build.sh 三端 dist 生成成功	2 个月前
packaging	fix: cross-platform build.sh + CLI (Windows Git Bash + macOS + Linux) Co-authored-by: oshunter<bo.lu@huawei.com>	2 个月前
prompts	feat: initial migration from spec-for-ai to ohos-sdd (v0.4.0) 迁移内容: - skills/ (10 SKILL.md + README.md) - runtime/assets/ (cli 4 + templates 17 + profiles 11 + contracts 2 + workflow 3 + analysis 11 + rules 8) - examples/ (2 change 示例 + bugfix 示例) - tests/ (8 自验脚本，路径适配新布局) - docs/ (design-overview + workflow-guide + security-guide，9→3 文件合并) - packaging/ (精简 build.sh + 三端平台模板) - plugin.yaml + provenance.yaml + hooks/ + prompts/ - README.md + AGENTS.md + CHANGELOG.md + .gitignore CLI 引擎适配: - 支持 3 种布局:源仓 openharmony/、发布 flat、新仓 runtime/assets/ - validate_contract_source() 新增 runtime/assets/contracts/ 回退 - _find_profiles_dir() 新增 runtime/assets/profiles walk-up - _root_from_change() 新增 runtime/assets/ 目录检测 - contract_template_checks._resolve() 新增 runtime/assets 前缀 - 静态模板路径解析新增 openharmony/ 前缀剥离 + runtime/assets/ 回退验证: - pytest 76 passed - run_cli_smoke.sh 35 pass 0 fail - test-published-layout.sh 13 pass 0 fail - spec-validate.sh 95 pass 0 fail 0 warn - validate-skills.sh 86 pass 0 fail - validate-artifacts.sh 190 checks 0 broken - build.sh 三端 dist 生成成功	2 个月前
runtime	fix: 触发器改表头列语义 + 代码/文档分类（review r3）修复 r3 的三条阻塞： 1. 追溯语义冲突——纯文档变更不再需要清空实际列：实际列如实回填 docs/a.md 等文档路径不会被误判为代码实现（文档/媒体扩展名白名单） 2. 固定列序误判——改为按表头定位「实际文件/符号」列；紧凑三列表 (Task\|文件\|操作)无该列,无法判定,保守视为已实现(有钉死测试) 3. N/A 夹带绕过——'N/A：无代码 / src/a.cpp' 不再放行:N/A 值仅豁免理由部分无代码路径的情形新增测试:诚实 docs 回填绿 / N/A:理由绿 / N/A 夹带红 / 紧凑表保守红模板引导同步:execution-plan.md 改'如实回填(纯文档照填路径,不要清空)' 全仓不变式措辞:'实际列 N/A' → '实际范围仅文档类文件或 N/A:理由' 验证:pytest 121+12 · smoke 42/42 · spec-validate PASS · validate-skills 92/92(重建 dist) · published-layout 13/13 AI[100%] Human Fixed[0%] Human[0%] AI Adopted[100%] Co-authored-by: claude (glm-5.2) <ai@local> Co-authored-by: opencode (glm-5.2) <ai@local>	2 个月前
skills	fix: 触发器改表头列语义 + 代码/文档分类（review r3）修复 r3 的三条阻塞： 1. 追溯语义冲突——纯文档变更不再需要清空实际列：实际列如实回填 docs/a.md 等文档路径不会被误判为代码实现（文档/媒体扩展名白名单） 2. 固定列序误判——改为按表头定位「实际文件/符号」列；紧凑三列表 (Task\|文件\|操作)无该列,无法判定,保守视为已实现(有钉死测试) 3. N/A 夹带绕过——'N/A：无代码 / src/a.cpp' 不再放行:N/A 值仅豁免理由部分无代码路径的情形新增测试:诚实 docs 回填绿 / N/A:理由绿 / N/A 夹带红 / 紧凑表保守红模板引导同步:execution-plan.md 改'如实回填(纯文档照填路径,不要清空)' 全仓不变式措辞:'实际列 N/A' → '实际范围仅文档类文件或 N/A:理由' 验证:pytest 121+12 · smoke 42/42 · spec-validate PASS · validate-skills 92/92(重建 dist) · published-layout 13/13 AI[100%] Human Fixed[0%] Human[0%] AI Adopted[100%] Co-authored-by: claude (glm-5.2) <ai@local> Co-authored-by: opencode (glm-5.2) <ai@local>	2 个月前
tests	fix: 触发器改表头列语义 + 代码/文档分类（review r3）修复 r3 的三条阻塞： 1. 追溯语义冲突——纯文档变更不再需要清空实际列：实际列如实回填 docs/a.md 等文档路径不会被误判为代码实现（文档/媒体扩展名白名单） 2. 固定列序误判——改为按表头定位「实际文件/符号」列；紧凑三列表 (Task\|文件\|操作)无该列,无法判定,保守视为已实现(有钉死测试) 3. N/A 夹带绕过——'N/A：无代码 / src/a.cpp' 不再放行:N/A 值仅豁免理由部分无代码路径的情形新增测试:诚实 docs 回填绿 / N/A:理由绿 / N/A 夹带红 / 紧凑表保守红模板引导同步:execution-plan.md 改'如实回填(纯文档照填路径,不要清空)' 全仓不变式措辞:'实际列 N/A' → '实际范围仅文档类文件或 N/A:理由' 验证:pytest 121+12 · smoke 42/42 · spec-validate PASS · validate-skills 92/92(重建 dist) · published-layout 13/13 AI[100%] Human Fixed[0%] Human[0%] AI Adopted[100%] Co-authored-by: claude (glm-5.2) <ai@local> Co-authored-by: opencode (glm-5.2) <ai@local>	2 个月前
.gitignore	feat: initial migration from spec-for-ai to ohos-sdd (v0.4.0) 迁移内容: - skills/ (10 SKILL.md + README.md) - runtime/assets/ (cli 4 + templates 17 + profiles 11 + contracts 2 + workflow 3 + analysis 11 + rules 8) - examples/ (2 change 示例 + bugfix 示例) - tests/ (8 自验脚本，路径适配新布局) - docs/ (design-overview + workflow-guide + security-guide，9→3 文件合并) - packaging/ (精简 build.sh + 三端平台模板) - plugin.yaml + provenance.yaml + hooks/ + prompts/ - README.md + AGENTS.md + CHANGELOG.md + .gitignore CLI 引擎适配: - 支持 3 种布局:源仓 openharmony/、发布 flat、新仓 runtime/assets/ - validate_contract_source() 新增 runtime/assets/contracts/ 回退 - _find_profiles_dir() 新增 runtime/assets/profiles walk-up - _root_from_change() 新增 runtime/assets/ 目录检测 - contract_template_checks._resolve() 新增 runtime/assets 前缀 - 静态模板路径解析新增 openharmony/ 前缀剥离 + runtime/assets/ 回退验证: - pytest 76 passed - run_cli_smoke.sh 35 pass 0 fail - test-published-layout.sh 13 pass 0 fail - spec-validate.sh 95 pass 0 fail 0 warn - validate-skills.sh 86 pass 0 fail - validate-artifacts.sh 190 checks 0 broken - build.sh 三端 dist 生成成功	2 个月前
AGENTS.md	feat: initial migration from spec-for-ai to ohos-sdd (v0.4.0) 迁移内容: - skills/ (10 SKILL.md + README.md) - runtime/assets/ (cli 4 + templates 17 + profiles 11 + contracts 2 + workflow 3 + analysis 11 + rules 8) - examples/ (2 change 示例 + bugfix 示例) - tests/ (8 自验脚本，路径适配新布局) - docs/ (design-overview + workflow-guide + security-guide，9→3 文件合并) - packaging/ (精简 build.sh + 三端平台模板) - plugin.yaml + provenance.yaml + hooks/ + prompts/ - README.md + AGENTS.md + CHANGELOG.md + .gitignore CLI 引擎适配: - 支持 3 种布局:源仓 openharmony/、发布 flat、新仓 runtime/assets/ - validate_contract_source() 新增 runtime/assets/contracts/ 回退 - _find_profiles_dir() 新增 runtime/assets/profiles walk-up - _root_from_change() 新增 runtime/assets/ 目录检测 - contract_template_checks._resolve() 新增 runtime/assets 前缀 - 静态模板路径解析新增 openharmony/ 前缀剥离 + runtime/assets/ 回退验证: - pytest 76 passed - run_cli_smoke.sh 35 pass 0 fail - test-published-layout.sh 13 pass 0 fail - spec-validate.sh 95 pass 0 fail 0 warn - validate-skills.sh 86 pass 0 fail - validate-artifacts.sh 190 checks 0 broken - build.sh 三端 dist 生成成功	2 个月前
CHANGELOG.md	fix: 触发器改表头列语义 + 代码/文档分类（review r3）修复 r3 的三条阻塞： 1. 追溯语义冲突——纯文档变更不再需要清空实际列：实际列如实回填 docs/a.md 等文档路径不会被误判为代码实现（文档/媒体扩展名白名单） 2. 固定列序误判——改为按表头定位「实际文件/符号」列；紧凑三列表 (Task\|文件\|操作)无该列,无法判定,保守视为已实现(有钉死测试) 3. N/A 夹带绕过——'N/A：无代码 / src/a.cpp' 不再放行:N/A 值仅豁免理由部分无代码路径的情形新增测试:诚实 docs 回填绿 / N/A:理由绿 / N/A 夹带红 / 紧凑表保守红模板引导同步:execution-plan.md 改'如实回填(纯文档照填路径,不要清空)' 全仓不变式措辞:'实际列 N/A' → '实际范围仅文档类文件或 N/A:理由' 验证:pytest 121+12 · smoke 42/42 · spec-validate PASS · validate-skills 92/92(重建 dist) · published-layout 13/13 AI[100%] Human Fixed[0%] Human[0%] AI Adopted[100%] Co-authored-by: claude (glm-5.2) <ai@local> Co-authored-by: opencode (glm-5.2) <ai@local>	2 个月前
LICENSE	fix: add missing Codex install/uninstall scripts + LICENSE (issue #3) Issue #3: packaging/codex/README.md and codex-tools.md referenced install.sh, uninstall.sh, uninstall-local.sh but none existed. Added: - packaging/codex/install.sh: project-level install with dist freshness check, idempotent reinstall (cleans stale files via uninstall first), owned-files manifest recording - packaging/codex/uninstall.sh: manifest-driven removal with relpath safety (rejects absolute paths, .. traversal, non-ohos-sdd prefixes), empty directory cleanup, user file preservation - packaging/codex/uninstall-local.sh: legacy ~/plugins/ohos-sdd cleanup - LICENSE: MIT license file (provenance.yaml declared MIT but sourceLicenseFileFound was false) Updated: - packaging/codex/README.md: fix manifest name reference (.ohos-sdd-codex-install.json -> ohos-sdd-owned-files.txt) Verified: - Install: 71 files (10 skills + shared assets + CLI + manifest) - Uninstall: 70 files removed, 0 skipped, complete cleanup - Idempotent reinstall: user files preserved - Manifest safety: absolute paths, .. traversal, non-ohos-sdd prefixes all rejected AI[100%] Human Fixed[0%] Human[0%] AI Adopted[100%] Co-authored-by: opencode (glm-5.2) <ai@local>	2 个月前
README.md	Merge branch 'main' into docs/user-guide	2 个月前
plugin.yaml	feat: initial migration from spec-for-ai to ohos-sdd (v0.4.0) 迁移内容: - skills/ (10 SKILL.md + README.md) - runtime/assets/ (cli 4 + templates 17 + profiles 11 + contracts 2 + workflow 3 + analysis 11 + rules 8) - examples/ (2 change 示例 + bugfix 示例) - tests/ (8 自验脚本，路径适配新布局) - docs/ (design-overview + workflow-guide + security-guide，9→3 文件合并) - packaging/ (精简 build.sh + 三端平台模板) - plugin.yaml + provenance.yaml + hooks/ + prompts/ - README.md + AGENTS.md + CHANGELOG.md + .gitignore CLI 引擎适配: - 支持 3 种布局:源仓 openharmony/、发布 flat、新仓 runtime/assets/ - validate_contract_source() 新增 runtime/assets/contracts/ 回退 - _find_profiles_dir() 新增 runtime/assets/profiles walk-up - _root_from_change() 新增 runtime/assets/ 目录检测 - contract_template_checks._resolve() 新增 runtime/assets 前缀 - 静态模板路径解析新增 openharmony/ 前缀剥离 + runtime/assets/ 回退验证: - pytest 76 passed - run_cli_smoke.sh 35 pass 0 fail - test-published-layout.sh 13 pass 0 fail - spec-validate.sh 95 pass 0 fail 0 warn - validate-skills.sh 86 pass 0 fail - validate-artifacts.sh 190 checks 0 broken - build.sh 三端 dist 生成成功	2 个月前
provenance.yaml	chore: update provenance commit hash	2 个月前

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 (11 文件)
│   ├── 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/ 为可选过程证据，存在时严格校验；evidence/reviews/ 状态触发（与复杂度无关）——代码范围映射的实际范围包含代码文件时归档必须三份 Approved Review Evidence，纯文档/规格变更（实际范围仅文档类文件或 N/A：理由）可选（存在即严校验）
归档（硬门禁）：ohos-sdd archive 写 registry 前强制通过 A/B/C + 严格 D，失败不产生 registry 副作用

详见 docs/guide/workflow-guide.md；命令上手（安装后 5 分钟跑通、逐命令参考、Level A–E 速查）见 docs/guide/user-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)