| name | arkweb-spec-review |
| description | ArkWeb Spec 文档评审。可作为独立 subagent 运行。检查文档完整性、一致性、可行性。触发词:评审设计文档、Spec review、检查设计文档、需求评审。 |
ArkWeb Spec 文档评审
Announce at start: "我正在使用 arkweb-spec-review skill 评审设计文档。"
运行模式
模式 A:Subagent 模式(推荐)
作为独立 subagent 被 arkweb-architect 调用时,设计文档和代码分析结果路径已在 task 描述中提供,直接执行评审。
输入格式(从 task 描述中解析):
## 待评审文档
{DOCS_REPO}/docs/{date}-{feature}-requirement.md
## 代码分析结果(用于交叉验证)
{DOCS_REPO}/analysis/{date}-{feature}-analysis.md
## 参考资料(按需读取)
- ACE Engine 索引:{DOCS_REPO}/analysis/arkweb-ace-engine-analysis.md
- WebWebView 分析:{DOCS_REPO}/analysis/web-webview-analysis.md
输出: 评审报告 → 保存到指定路径 → 回复评审结果摘要
模式 B:交互模式
在主 session 中直接调用,评审完成后呈现给用户,用户决定是否修改。
模式 C:最小化检视流程(独立检视 + 修改闭环)
适用于已有设计文档,只需检视和修改的场景,跳过 brainstorm/code-analysis/design-doc 全链路。
触发词: 检视设计文档、review checklist、快速检视
流程:检视 → 修改 → 复审 → 提 PR
Step 1: 读取设计文档 + Checklist 模版
Step 2: 执行 Checklist 33 项检视(输出结果表)
Step 3: 有阻塞项?
├─ 否 → 输出"通过",流程结束
└─ 是 → 逐组修改设计文档
├─ 每组修改提交一个 PR
├─ 老板审批合并
├─ 合并后重新检视该组修改项
└─ 全部通过 → 流程结束
与模式 A/B 的区别:
- 不执行完整评审维度检查(5 维度 31 项),仅做 Checklist 33 项检视
- 不依赖代码分析结果交叉验证
- 检视不通过时直接修改文档(而非打回 design-doc skill)
- 每组修改独立提 PR,合并后复审该组,不重跑全量检视
概述
对已生成的 ArkWeb 设计文档进行系统评审,确保完整性、一致性和技术可行性。
评审维度
1. 完整性检查(10 项)