fix: 技能 description 改为「触发场景+该加载哪个规范+不加载后果」
根因：develop 从不 load_skill module-development-spec，是因为 description 只写「是什么」 （英文的 Standardized workflow...），没写「什么场景必须加载我、不加载会怎样、什么场景别用我」。 目录层只注入 name+description，description 是 agent 决定是否 load_skill 的唯一触发依据， 写不清触发条件 → agent 不加载 → 规范静默失效。 改为：每个角色技能 + 关键规范技能的 description 都写清 ① 触发场景（开发模块/应用脚手架/部署/测试/审查时必读）② 该加载哪个规范 ③ 不加载的后果（模块带 app.py 等）。
This commit is contained in:
parent
054dc6dd1f
commit
aa756e5b4c
@ -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)
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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
|
||||
---
|
||||
|
||||
|
||||
@ -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
|
||||
---
|
||||
|
||||
|
||||
@ -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
|
||||
---
|
||||
|
||||
|
||||
@ -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
|
||||
---
|
||||
|
||||
|
||||
@ -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
|
||||
---
|
||||
|
||||
|
||||
@ -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
|
||||
---
|
||||
|
||||
|
||||
@ -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
|
||||
---
|
||||
|
||||
|
||||
@ -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
|
||||
---
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user