From 8164444ab3bcfc11a38920c7c17c3c8ad14f2967 Mon Sep 17 00:00:00 2001 From: yumoqing Date: Mon, 24 Aug 2026 15:53:49 +0800 Subject: [PATCH] =?UTF-8?q?feat(skills):=20web-application-spec=20?= =?UTF-8?q?=E5=8A=A0=E6=A1=86=E6=9E=B6=E9=93=81=E5=BE=8B(=E5=85=A5?= =?UTF-8?q?=E5=8F=A3=E5=BF=85=E9=A1=BBahserver=E7=A6=81=E6=AD=A2Flask/http?= =?UTF-8?q?.server=20+=20=E4=B8=BB=E9=A1=B5=E5=BF=85=E9=A1=BB=E6=9C=89?= =?UTF-8?q?=E5=AE=8C=E6=95=B4index.ui)=20+=20bug=20=E5=8A=A0fixed=E2=86=92?= =?UTF-8?q?=E5=A4=8D=E6=B5=8B=E9=83=A8=E7=BD=B2=E9=97=A8=E7=A6=81(?= =?UTF-8?q?=E5=BF=85=E9=A1=BB=E5=85=88=E9=83=A8=E7=BD=B2=E6=B5=8B=E8=AF=95?= =?UTF-8?q?=E7=8E=AF=E5=A2=83+QC=E9=AA=8C=E8=AF=81)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills_library/all/bug/SKILL.md | 1 + skills_library/all/web-application-spec/SKILL.md | 6 ++++++ 2 files changed, 7 insertions(+) diff --git a/skills_library/all/bug/SKILL.md b/skills_library/all/bug/SKILL.md index cf3e915..f760bc2 100644 --- a/skills_library/all/bug/SKILL.md +++ b/skills_library/all/bug/SKILL.md @@ -37,6 +37,7 @@ Bug 由人工或 agent（reporter_type）提交，指派处理人（assignee_id - `close` 前：Bug 已 verified（修复生效）。 - 迭代准出：未关闭 Bug 清零（或明确豁免）。 - `fix` 附修复说明（fix_description）+ 修复提交（fix_commit）。 +- **`fixed` → `verified`（复测）之间必须经过部署 + QC 验证（铁律，2026-08-24 用户定）**：Bug 修复（fix_bug → fixed）后，修复代码**必须先部署到测试环境**（deploy_test 重新部署应用），QC 按 review-deploy 标准验证 `/healthz` 200 真实通过、新代码已生效，**部署验证通过后才派发复测任务给 test**（verify_bug）。禁止「fixed 直接复测」跳过部署——否则 test 对着测试环境的旧代码复测，verify_bug 结果无效。部署未通过 → 回退 develop 修部署问题，不进入复测。 ## 五、配套能力（工具） diff --git a/skills_library/all/web-application-spec/SKILL.md b/skills_library/all/web-application-spec/SKILL.md index 850c9c1..5b14519 100644 --- a/skills_library/all/web-application-spec/SKILL.md +++ b/skills_library/all/web-application-spec/SKILL.md @@ -19,6 +19,12 @@ This specification defines the standard architecture for web applications built All web applications must follow this exact structure and configuration pattern. +## 框架铁律（不可违反，禁止让 LLM 猜） + +1. **应用入口必须用 ahserver**：`app/{应用名}.py` 必须 `from ahserver.webapp import webapp`，末尾 `webapp(init)` 启动。**绝对禁止** Flask / http.server / Django / FastAPI 等任何其它 Web 框架。原因：bricks 的 `.ui` 界面只有 ahserver 的 BricksUIProcessor 能渲染，用 Flask/http.server 会导致模块 `.ui` 界面（DataViewer CRUD 等）无法渲染，根路径 `/` 只剩一段 JSON 元信息——「测试环境界面显示 JSON 就停」的直接根因（2026-08-24 人事项目6 hrs6 实测：develop 用 Flask 写 app/hrs6.py，design 在 architecture.md 写「基础模块 ahserver 直接复用」，实现偏离设计）。 + +2. **应用必须有主页 UI**：`wwwroot/index.ui` 必须是**完整 bricks widget 树**（顶栏 + 导航菜单 + 主内容区），访问 `/` 渲染出可交互界面。**绝对禁止**占位敷衍（如 index.ui 只写「卡片导航」4 个字）。主页是应用门面，不是 JSON 元信息接口。 + ## Required Dependencies ### Core Dependencies (Mandatory)