sdd-review
对 BiSheng 项目的 SDD 文档执行审查。
معلومات المصدر
- المستودع
- dataelement/bisheng
- آخر نشاط في المصدر
- ٧ يونيو ٢٠٢٦ في ٠٦:٢٦
- لغة SKILL.md المكتشفة
- الصينية
- النجوم
- ١٢٬٠٣١
- التفرعات
- ١٬٩٧٧
خيارات التثبيت
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
مراجعة ملفات المصدر
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
مستكشف الملفات
4 ملفاتعرض SKILL.md
SKILL.md
تعليمات المصدر · معاينة للقراءة فقط- name
- sdd-review
- description
- 对 BiSheng 项目的 SDD 文档执行审查。
# SDD Review Skill
## 调用方式
```
/sdd-review <feature_dir> <doc_type>
```
例：
```
/sdd-review features/v2.5.0/004-rebac-core spec
/sdd-review features/v2.5.0/001-multi-tenant tasks
```
## 审查流程
### 第一步：解析参数
从用户输入或调用上下文中提取：
- `feature_dir`：特性目录路径（如 `features/v2.5.0/004-rebac-core`）
- `doc_type`：文档类型，必须是 `spec` / `design` / `tasks`
若参数缺失或无效，向用户报告错误后停止。
---
### spec 模式（辅助审查，不自动推进）
spec.md 合并了需求规范和技术设计，因此 spec 审查同时覆盖需求覆盖和架构合规检查。
**第二步（spec）：执行合并审查**
读取文件：
- `<feature_dir>/spec.md`（已写的规格文档）
- spec.md 中"关联 PRD"字段指向的文件（若未标注，读取 `docs/PRD/` 下与特性名最相关的文件）
- `features/v2.5.0/release-contract.md`（不变量约束，确认 spec 未越界）
- `docs/architecture/02-backend-modules.md`（后端模块架构）
- `docs/architecture/10-permission-rbac.md`（权限体系）
按 `references/spec-checklist.md` 中的检查清单执行 14 项检查。
**第三步（spec）：展示报告，等待用户确认**
向用户展示分析结果：
- 无 gap / 无问题：告知"审查通过，可继续确认"
- 有 gap / 有问题：展示每个问题（MISSING / FORMAT / CONFLICT / ISSUE），供用户决定是否修改
**等待用户确认**（唯一手动暂停点）。用户确认后，将 `<feature_dir>/tasks.md` 状态表中 spec.md 行更新为 `✅ 已评审`。
---
### design 模式（辅助审查，不自动推进）
design.md 是"现状快照 + 关键决策"文档，决定新 agent 接手时能否在不读代码情况下快速建立认知。审查重点是**接手测试**四要素：现状、决策、坑、契约。
**第二步（design）：执行审查**
读取文件：
- `<feature_dir>/design.md`（已写的设计文档）
- `<feature_dir>/spec.md`（校验 design 没偏离需求）
- `<feature_dir>/tasks.md`（若存在；校验偏差记录已回写）
- `features/_templates/design.md`（模板结构基线）
- `features/v{X.Y.Z}/release-contract.md`（关键约束、不变量）
按 `references/design-checklist.md` 中的检查清单执行 24 项检查。
**第三步（design）：展示报告，等待用户确认**
向用户展示分析结果：
- 无问题：告知"审查通过，可继续确认"
- 有问题：展示每个问题（ISSUE 含 SEVERITY 和 LOC），供用户决定是否修改
**等待用户确认**（唯一手动暂停点）。用户确认后，将 `<feature_dir>/tasks.md` 状态表中 design.md 行更新为 `✅ 已评审`（若状态表尚无该行，提示用户补一行 `| design.md | 🔲 草稿 | ... |`）。
---
### tasks 模式（自动审查）
**第二步（tasks）：执行审查**
读取文件：
- `<feature_dir>/tasks.md`
- `<feature_dir>/spec.md`（验收标准 + 技术方案）
- `features/v2.5.0/release-contract.md`（领域归属 + 不变量）
按 `references/tasks-checklist.md` 中的检查清单执行 21 项检查。
**第三步（tasks）：处理审查结果**
**输出格式**：
- 有问题：`ISSUE: <描述> | SEVERITY: high/medium/low | TASK: <T-NN 若适用>`
- 无问题：`LGTM`
**处理逻辑**：
- `LGTM` → 更新 `<feature_dir>/tasks.md` 状态表，将 `tasks.md` 行改为 `✅ 已拆解`
- 有 `high`/`medium` ISSUE → 修复后重新审查（最多 2 轮）
- `low` ISSUE → 记录但跳过
- 2 轮后仍有 `high`/`medium` → 停止，向用户报告剩余问题
## 错误处理
- feature_dir 不存在 → 报告路径错误，停止
- doc_type 不是 spec / design / tasks → 报告参数错误，停止
- spec.md 不存在 → 报告"找不到 spec.md，请先完成 spec"，停止
- design.md 不存在（design 模式）→ 报告"找不到 design.md，请先按 features/_templates/design.md 完成 design"，停止
- tasks.md 不存在（tasks 模式）→ 报告"找不到 tasks.md，请先完成 tasks"，停止
عرض على GitHub