From aa756e5b4c34d9d3e7c553d9f21690a1cbfe0fba Mon Sep 17 00:00:00 2001 From: yumoqing Date: Sat, 22 Aug 2026 23:13:28 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20=E6=8A=80=E8=83=BD=20description=20?= =?UTF-8?q?=E6=94=B9=E4=B8=BA=E3=80=8C=E8=A7=A6=E5=8F=91=E5=9C=BA=E6=99=AF?= =?UTF-8?q?+=E8=AF=A5=E5=8A=A0=E8=BD=BD=E5=93=AA=E4=B8=AA=E8=A7=84?= =?UTF-8?q?=E8=8C=83+=E4=B8=8D=E5=8A=A0=E8=BD=BD=E5=90=8E=E6=9E=9C?= =?UTF-8?q?=E3=80=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 根因：develop 从不 load_skill module-development-spec，是因为 description 只写「是什么」 （英文的 Standardized workflow...），没写「什么场景必须加载我、不加载会怎样、什么场景别用我」。 目录层只注入 name+description，description 是 agent 决定是否 load_skill 的唯一触发依据， 写不清触发条件 → agent 不加载 → 规范静默失效。 改为：每个角色技能 + 关键规范技能的 description 都写清 ① 触发场景（开发模块/应用脚手架/部署/测试/审查时必读）② 该加载哪个规范 ③ 不加载的后果（模块带 app.py 等）。 --- skills_library/all/module-development-spec/SKILL.md | 4 ++-- skills_library/all/web-application-spec/SKILL.md | 2 +- .../sdlc_general/roles/agent.deploy_prod/role/SKILL.md | 2 +- .../sdlc_general/roles/agent.deploy_test/role/SKILL.md | 2 +- .../pipelines/sdlc_general/roles/agent.design/role/SKILL.md | 2 +- .../pipelines/sdlc_general/roles/agent.develop/role/SKILL.md | 2 +- .../pipelines/sdlc_general/roles/agent.pm/role/SKILL.md | 2 +- .../pipelines/sdlc_general/roles/agent.qc/role/SKILL.md | 2 +- .../sdlc_general/roles/agent.requirement/role/SKILL.md | 2 +- .../pipelines/sdlc_general/roles/agent.test/role/SKILL.md | 2 +- 10 files changed, 11 insertions(+), 11 deletions(-) diff --git a/skills_library/all/module-development-spec/SKILL.md b/skills_library/all/module-development-spec/SKILL.md index fac9cdb..6163f80 100644 --- a/skills_library/all/module-development-spec/SKILL.md +++ b/skills_library/all/module-development-spec/SKILL.md @@ -1,9 +1,9 @@ --- name: module-development-spec version: 1.0.0 -description: Standardized development workflow for creating modular components following the specified directory structure, frontend/backend conventions, and database integration patterns. +description: 开发「业务模块」（Python 包）时必读——模块目录结构（包目录=模块名，非 src）、模块无独立 app.py/端口/Dockerfile/build.sh（那些是应用级的，模块带 app.py 就是错的）、取库名用 get_module_dbname 禁止硬编码 DBNAME、models/json/dspy 四段式。开发「应用脚手架」（app/{应用名}.py + conf/config.json + build.sh）时不要用本技能，改用 web-application-spec。 trigger_conditions: - - User requests to create a new module named "mymodule" or similar + - 开发业务模块（Python 包）时加载我，否则会产出带 app.py 的错误模块结构 - Task involves implementing a component with bricks-framework frontend and sqlor database backend - Development follows the documented directory structure with wwwroot, models, json, and init directories - Task involves creating read-only/dashboard modules that display data without CRUD (no models/json needed) diff --git a/skills_library/all/web-application-spec/SKILL.md b/skills_library/all/web-application-spec/SKILL.md index 2f0d2ae..850c9c1 100644 --- a/skills_library/all/web-application-spec/SKILL.md +++ b/skills_library/all/web-application-spec/SKILL.md @@ -1,7 +1,7 @@ --- name: web-application-spec version: 1.0.0 -description: Standardized specification for web applications built with bricks frontend, ahserver backend framework, and apppublic/sqlor foundation modules. +description: 开发「应用脚手架」时必读——应用是唯一部署单元（一个入口 app/{应用名}.py + 一个端口），init() 里定义 get_module_dbname 挂 ServerEnv 再逐个 load_{模块}() 挂载业务模块，含 conf/config.json、build.sh 一键部署。开发「业务模块」（Python 包）时不要用本技能，改用 module-development-spec。 trigger_conditions: - User requests to create a new web application following the specified architecture - Task involves setting up application structure with ahserver, bricks, apppublic, sqlor diff --git a/skills_library/pipelines/sdlc_general/roles/agent.deploy_prod/role/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.deploy_prod/role/SKILL.md index ec91d1d..6926b7d 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.deploy_prod/role/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.deploy_prod/role/SKILL.md @@ -1,6 +1,6 @@ --- name: role -description: 生产环境部署工程师角色定义——职责（部署前检查条件→条件缺失冒泡问题暂停→真实部署→部署后验证进程/外网URL/DB）+ 规范列表（project-directory-spec/webapp-deploy/team-communication，需时 load_skill）。 +description: 生产环境部署工程师角色定义。生产部署需人工指令、不得自动执行。接到部署任务时先 load_skill 加载本技能——本技能规定：环境从 env/prod.json 读（不写死）、应用唯一入口一进程。未收到用户明确指令时 ask_question 等待。 capability: deploy_capability --- diff --git a/skills_library/pipelines/sdlc_general/roles/agent.deploy_test/role/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.deploy_test/role/SKILL.md index 9b17284..851364c 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.deploy_test/role/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.deploy_test/role/SKILL.md @@ -1,6 +1,6 @@ --- name: role -description: 测试环境部署工程师角色定义——职责（从 apps/{应用名}.md 读部署环境→部署前检查条件→条件缺失冒泡暂停→SSH 到测试机 Python 直跑真实部署→清理旧进程只留1应用→部署后验证）+ 规范列表（project-directory-spec/webapp-deploy/team-communication/sdlc-repo-standard，需时 load_skill）。 +description: 测试环境部署工程师角色定义。接到部署任务时先 load_skill 加载本技能——本技能规定：部署环境从 env/test.json 读（不写死）、部署前清理旧进程只留 1 个应用进程、应用唯一入口一端口（模块不独立起服务）。不先加载会按写死环境或按模块多进程部署出错。 capability: deploy_capability --- 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 6c43f57..f600842 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 @@ -1,6 +1,6 @@ --- name: role -description: 系统设计师角色定义——职责 + 应遵守的设计规范列表（project-directory-spec/sdlc-repo-standard/database-design/database-table-definition-spec，需时 load_skill 加载全文）。 +description: 系统设计师角色定义。接到「应用架构」或「模块级设计」任务时先 load_skill 加载本技能——本技能规定该加载哪个规范：project-directory-spec（目录落点）、web-application-spec（应用=唯一部署单元一入口一端口）、module-development-spec（模块不独立部署）、database-design/database-table-definition-spec（库设计）。不先加载会把单体设计成多服务、把模块设计成带 app.py 的应用。 capability: task_capability --- diff --git a/skills_library/pipelines/sdlc_general/roles/agent.develop/role/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.develop/role/SKILL.md index 4d8269c..7ef0375 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.develop/role/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.develop/role/SKILL.md @@ -1,6 +1,6 @@ --- name: role -description: 开发工程师角色定义——职责 + 应遵守的开发规范列表（module-development-spec/database-table-definition-spec/crud-definition-spec/web-application-spec/sqlor-database-module，需时 load_skill 加载全文）。 +description: 开发工程师角色定义。接到「应用脚手架」或「业务模块」开发任务时先 load_skill 加载本技能——本技能规定该加载哪个规范：应用脚手架→web-application-spec（应用=唯一入口一端口），业务模块→module-development-spec（模块=Python 包，无 app.py）。不先加载会产出错误结构（模块带 app.py、应用不挂载模块）。 capability: feature_dev_capability, bug_fix_capability --- diff --git a/skills_library/pipelines/sdlc_general/roles/agent.pm/role/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.pm/role/SKILL.md index 1ce6d3d..e3888b1 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.pm/role/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.pm/role/SKILL.md @@ -1,6 +1,6 @@ --- name: role -description: 项目经理角色定义——职责 + 应遵守的规范列表（project-directory-spec/sdlc-repo-standard，需时 load_skill 加载全文）。 +description: 项目经理角色定义。审核/派发任务时先 load_skill 加载本技能——本技能规定该加载：project-directory-spec（交付件落点路径）、sdlc-repo-standard（交付件格式与审核要点）。不先加载会按错误路径检查交付件、漏检实际产出。 capability: task_capability --- 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 d97daee..8110884 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,6 +1,6 @@ --- name: role -description: 质量控制工程师角色定义——职责 + 按被查对象分技能审查（review-requirement/design/develop/test/deploy，需时 load_skill 加载对应审查清单）。 +description: 质量控制工程师角色定义。接到审查任务时先 load_skill 加载本技能——本技能规定按被查对象加载对应审查清单：审查 design→review-design、审查 develop→review-develop、审查 deploy→review-deploy、审查 test→review-test、审查 requirement→review-requirement。不先加载会漏检（如漏查模块是否带 app.py、应用是否唯一部署单元）。 capability: task_capability --- diff --git a/skills_library/pipelines/sdlc_general/roles/agent.requirement/role/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.requirement/role/SKILL.md index c7e1b3c..f1c00b7 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.requirement/role/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.requirement/role/SKILL.md @@ -1,6 +1,6 @@ --- name: role -description: 需求分析师角色定义——职责（拆解需求提功能落库 sd_features、需求文档、识别应用）+ 应遵守的规范列表（project-directory-spec/sdlc-repo-standard，需时 load_skill）。 +description: 需求分析师角色定义。接到需求分析任务时先 load_skill 加载本技能——本技能规定：拆需求提功能落库 sd_features、识别应用（部署单元）、落成 env/test.json+env/prod.json（部署信息单一事实源）、需求不明确的端口/主机/账号禁止编造（标注待明确或 ask_question 冒泡问）。不先加载会编造端口/子域名等具体值。 capability: feature_propose_capability --- diff --git a/skills_library/pipelines/sdlc_general/roles/agent.test/role/SKILL.md b/skills_library/pipelines/sdlc_general/roles/agent.test/role/SKILL.md index 0967b23..5fd5b44 100644 --- a/skills_library/pipelines/sdlc_general/roles/agent.test/role/SKILL.md +++ b/skills_library/pipelines/sdlc_general/roles/agent.test/role/SKILL.md @@ -1,6 +1,6 @@ --- name: role -description: 测试工程师角色定义——职责（冒烟测试检查环境可用性→建测试计划/用例落库→真实执行→失败建 Bug）+ 应遵守的规范列表（需时 load_skill）。 +description: 测试工程师角色定义。接到测试任务时先 load_skill 加载本技能——本技能规定：冒烟测试先查环境可用性（环境不可用则退出测试，不伪造通过）、建测试计划/用例落库 sd_test_plans/sd_test_cases、真实执行用例、失败建 Bug 闭环。不先加载会凭空写「通过」、不落库。 capability: test_plan_capability, test_case_capability, bug_test_capability ---