8dafa5bc52
- Add archives/ directory for immutable external skill snapshots - Strict immutability rule: only README/CHANGELOG can be modified - First import: dev-pipeline-universal v1.0.0 (Hermes Agent) - Import dev-pipeline-universal into hermes-agent/skills/ with CHANGELOG - Update hermes-agent/publish/registry.json with imported skill - Rewrite meta-skills/create-hermes-agent-skill/ with full spec: - SKILL.md frontmatter fields and validator constraints - Recommended body structure (Overview → When to Use → Pitfalls → Verification) - Progressive disclosure (3-level loading) - 8 writing quality principles - Official reference skills from GitHub repo - Tool chain docs (skill_manage, /learn, skill_view) - Update README.md with archives/ in directory structure
110 lines
3.8 KiB
Markdown
110 lines
3.8 KiB
Markdown
# 研发流水线 — 质量门禁规范
|
||
# 每个阶段完成后，由马总管自动执行质量门禁检查
|
||
|
||
---
|
||
|
||
## 质量门禁总览
|
||
|
||
```
|
||
需求 ──→ [QG1] ──→ 设计 ──→ [QG2] ──→ 编码 ──→ [QG3] ──→ 测试 ──→ [QG4] ──→ 部署
|
||
```
|
||
|
||
---
|
||
|
||
## QG1: 需求分析门禁
|
||
|
||
**执行时机：** ①需求分析完成后，进入②设计之前
|
||
|
||
| 检查项 | 通过标准 | 执行方式 |
|
||
|--------|---------|---------|
|
||
| 产物格式完整 | YAML所有必填字段非空 | 自动 |
|
||
| 验收标准可测试 | 每条AC标记testable=true | 自动 |
|
||
| 范围边界清晰 | in_scope和out_of_scope均非空 | 自动 |
|
||
| 用户确认 | 乔确认需求理解正确 | 人工 |
|
||
|
||
**不通过处理：** 补充缺失信息，重新跟乔确认
|
||
|
||
---
|
||
|
||
## QG2: 技术方案门禁
|
||
|
||
**执行时机：** ②设计完成后，进入③编码之前
|
||
|
||
| 检查项 | 通过标准 | 执行方式 |
|
||
|--------|---------|---------|
|
||
| 产物格式完整 | YAML所有必填字段非空 | 自动 |
|
||
| 文件变更清单 | file_changes列表非空 | 自动 |
|
||
| API设计与需求对齐 | 每个AC至少对应一个API或功能点 | AI审查 |
|
||
| 无遗留阻断问题 | open_issues中无阻断级问题 | 自动 |
|
||
| 重大决策确认 | 涉及架构变更时需乔确认 | 条件人工 |
|
||
|
||
**不通过处理：** 反馈问题给架构师Agent重新设计（最多2轮）
|
||
|
||
---
|
||
|
||
## QG3: 编码实现门禁
|
||
|
||
**执行时机：** ③编码完成后，进入④审查之前
|
||
|
||
| 检查项 | 通过标准 | 执行方式 |
|
||
|--------|---------|---------|
|
||
| 产物格式完整 | YAML所有必填字段非空 | 自动 |
|
||
| 代码可编译/无语法错误 | self_check.compiles=true | 自动 |
|
||
| lint通过 | self_check.lint_passes=true | 自动 |
|
||
| 文件变更与设计一致 | 实际变更文件 ⊆ 设计中的file_changes | AI审查 |
|
||
| 无常驻进程残留 | 无未关闭的后台服务 | 自动 |
|
||
|
||
**不通过处理：** 反馈给程序员Agent修复（最多3轮）
|
||
|
||
---
|
||
|
||
## QG4: 测试验证门禁
|
||
|
||
**执行时机：** ⑤测试完成后，进入⑥部署之前
|
||
|
||
| 检查项 | 通过标准 | 执行方式 |
|
||
|--------|---------|---------|
|
||
| 所有测试通过 | verdict=ALL_PASS | 自动 |
|
||
| 覆盖率达标 | line_percent >= 阈值(见测试规范) | 自动 |
|
||
| 无回归 | existing_tests_still_pass=true | 自动 |
|
||
| 冒烟测试通过 | smoke.failed=0 | 自动 |
|
||
| 部署确认 | 乔确认可以部署 | 人工 |
|
||
|
||
**不通过处理：** 失败信息反馈给程序员Agent修复 → 重新测试（最多3轮）
|
||
|
||
---
|
||
|
||
## 门禁执行规则
|
||
|
||
### 重试策略
|
||
```
|
||
第1次失败 → 同模型重试，附带失败原因
|
||
第2次失败 → 换备用模型重试
|
||
第3次失败 → 上报乔，进入人工介入
|
||
```
|
||
|
||
### 备用模型降级链（示例 — 根据实际可用模型替换）
|
||
|
||
降级原则：主模型失败时，按以下优先级替换：
|
||
1. 同平台其他模型（相同 API 端点）
|
||
2. 不同平台同等级模型
|
||
3. 快速响应模型兜底
|
||
|
||
| 角色 | 降级策略 |
|
||
|------|---------|
|
||
| 架构师 | 强推理模型 → 同平台次强模型 → 通用模型 |
|
||
| 设计师 | 编码版模型 → 通用强模型 → 快速模型 |
|
||
| 主程序员 | 深度编码模型 → 其他编码模型 → 快速模型 |
|
||
| 结对程序员 | 与主程序员不同家族模型 → 主程序员模型 |
|
||
| 审查员 | 深度推理模型 → 架构师模型 |
|
||
| 测试员 | Agent能力强的模型 → 编码模型 |
|
||
|
||
### 超时保护
|
||
| 阶段 | 超时时间 | 超时处理 |
|
||
|------|---------|---------|
|
||
| ②设计 | 30分钟 | 终止，记录已有产出，人工介入 |
|
||
| ③UI设计 | 10分钟 | 换模型重试，精简prompt |
|
||
| ④编码 | 50分钟 | 终止，保留已写代码，人工介入 |
|
||
| ⑤审查 | 25分钟 | 终止，标记"审查超时"，进入测试 |
|
||
| ⑥测试 | 40分钟 | 终止，保留已有测试结果，人工介入 |
|