diff --git a/skills_library/pipelines/sdlc_general/roles/agent.qc/review-design/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.qc/review-design/SKILL.md index 735acb3..8002fab 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.qc/review-design/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.qc/review-design/SKILL.md @@ -8,11 +8,16 @@ capability: task_capability 被查对象:agent.design。审查其产出时逐项核对,任一项不合格即 review_reject 并列出问题。 -## 一、应用级设计落盘 +## 一、应用级设计落盘(对照 project-directory-spec + web-application-spec + module-development-spec) - 对照 `project-directory-spec`: - `repos/{项目名}_pc/docs/01-design/architecture.md`(架构 + 模块划分 + 模块间依赖 + 开发顺序) - `repos/{项目名}_pc/docs/01-design/ui-design.md`(视觉风格/布局/交互模式) +- **应用与模块关系(关键,对照 web-application-spec + module-development-spec)**: + - 应用是唯一部署单元:一个应用 = 一个入口(`app/{应用名}.py`)= 一个端口。architecture.md 必须明确这是【单体应用】(或明确列出多个应用),**不能把功能模块设计成独立服务/微服务** + - 模块不是独立部署单元:每个模块是应用内的 Python 包,通过 `load_{module}()` 挂载到应用,**无独立 app.py / 端口 / Dockerfile / 服务** + - 目录结构:repos/ 下应有 `{应用名}_app`(应用仓库)+ `{模块名}`(模块仓库)。若只有模块仓库没有应用仓库,或模块仓库里带了 app.py / Dockerfile → 退回(违反 module-development-spec) + - 若 architecture.md 出现"四模块服务""每模块一个端口/容器"等设计 → 退回:这是把功能模块错误设计成微服务 ## 二、模块级设计落盘