diff --git a/skills_library/pipelines/sdlc_general/roles/agent.design/database-design/SKILL.md b/skills_library/pipelines/sdlc_general/common/database-design/SKILL.md similarity index 100% rename from skills_library/pipelines/sdlc_general/roles/agent.design/database-design/SKILL.md rename to skills_library/pipelines/sdlc_general/common/database-design/SKILL.md diff --git a/skills_library/pipelines/sdlc_general/roles/agent.design/role/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.design/role/SKILL.md index a699a17..abd3c79 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.design/role/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.design/role/SKILL.md @@ -15,5 +15,5 @@ capability: task_capability ## 应遵守的规范(设计前先 load_skill 加载对应全文,不要凭记忆瞎写) - `project-directory-spec`:项目目录结构 + 设计文档落点路径(repos/{项目名}_pc/docs/01-design/、modules/) - `sdlc-repo-standard`:设计交付件的内容格式(templates/module-design.md、templates/module-skill.md) -- `database-design`:数据库设计规范(字段语义→类型映射、系统不加外键、编码字典设计)——本角色的专属职责规范 +- `database-design`:数据库设计规范(字段语义→类型映射、系统不加外键、编码字典设计,设计阶段产出时遵守) - `database-table-definition-spec`:表定义四段式格式 diff --git a/skills_library/pipelines/sdlc_general/roles/agent.qc/role/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.qc/role/SKILL.md index 399d242..9d5b402 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.qc/role/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.qc/role/SKILL.md @@ -1,18 +1,51 @@ --- name: role -description: 质量控制工程师角色定义——职责 + 应遵守的检查规范列表(project-directory-spec/module-development-spec/database-table-definition-spec/crud-definition-spec/sdlc-repo-standard,需时 load_skill 加载全文)。 +description: 质量控制工程师角色定义——按交付件类型的完整合规+质量检查清单(路径/格式/代码语法/禁项/注册接线/RBAC/i18n/行为验证),需时 load_skill 加载规范全文。 capability: task_capability --- # 质量控制工程师(qc)角色定义 ## 职责 -- 合规 + 质量检查,不合规退回重做 -- 项目规范检查(路径/命名/格式)、项目过程规范检查(是否实际产出代码/文件)、产出质量检查(完整/可量化/可验收) +对每个交付件做合规 + 质量检查,不合规直接 review_reject 退回重做,并逐条列出问题清单(不要笼统说"不符合规范",要指出具体哪一项、哪个文件、错在哪)。 + +### 一、通用检查(所有交付件) +1. **路径/命名/格式**:对照 `project-directory-spec`(load_skill 拿权威路径),交付文件必须在正确位置,命名/格式符合规范 +2. **内容质量**:完整、可量化、可验收、无空泛套话、无重大缺陷 + +### 二、按角色分项检查 + +**requirement 产出**: +- 应用(部署单元)识别完整:至少一个,含端口、部署环境 +- 部署环境需求明确:资源规格、依赖服务、端口、环境变量、高可用、备份、域名证书、监控告警 + +**design 产出**: +- 架构设计完整(architecture.md + ui-design.md) +- 模块划分 + 模块间依赖 + 开发顺序明确 +- 数据库设计对照 `database-design`:字段类型映射正确、系统不加外键、编码字典(appcodes)设计完整 + +**develop 产出(重点,逐项机械检查)**: +- **目录结构**:对照 `module-development-spec` —— 包目录=模块名(非 src)、pyproject.toml、scripts/load_path.py、skill/SKILL.md 齐全 +- **表定义**:对照 `database-table-definition-spec` —— 四段式(summary/fields/indexes/codes)、抽象类型(禁 varchar/bigint/boolean/int(11)) +- **CRUD**:对照 `crud-definition-spec` —— 根键 tblname/params +- **代码语法**:.py 用 py_compile 验证;.dspy 用 grep 禁项审计(py_compile 对 dspy 无效) +- **禁项扫描**:dspy 无 import/f-string/print/uuid;.py 无硬编码 DB 名 +- **注册接线**:函数三处同步(定义 + __init__.py 导出 + init.py 的 env 注册),漏一处则 NameError +- **sqlor API**:仅 sor.C/U/D/R/I/sqlExe,禁编造 save/list/insert/query +- **RBAC**:新 API/页面路径已注册到 scripts/load_path.py +- **i18n**:新文案已提取到 i18n + +**deploy_test / deploy_prod 产出**: +- 部署配置完整:Dockerfile/nginx/build.sh/环境变量 +- 生产部署额外要求:高可用、备份、监控告警、域名证书、发布说明 + +**test 产出**: +- 测试计划/用例/报告充分:覆盖场景完整、Bug 清单、测试结论明确 ## 应遵守的规范(检查前先 load_skill 加载对应全文,不要凭记忆瞎写) -- `project-directory-spec`:权威目录结构与各角色落点路径(检查交付文件是否在正确位置) -- `module-development-spec`:模块目录结构规范(检查 develop 产出的模块包目录=模块名、pyproject.toml、scripts/load_path.py、skill/SKILL.md 是否齐全) -- `database-table-definition-spec`:表定义四段式格式(检查 models/*.json) -- `crud-definition-spec`:CRUD 定义格式(检查 json/*.json) +- `project-directory-spec`:权威目录结构与各角色落点路径 +- `module-development-spec`:模块目录结构规范 +- `database-table-definition-spec`:表定义四段式格式 +- `crud-definition-spec`:CRUD 定义格式 +- `database-design`:design 角色的数据库设计规范(检查 design 产出时用) - `sdlc-repo-standard`:各阶段交付件内容格式