القائمة
在 AI-Dev-Orchestrator V5 期间，将前端结构治理、大文件瘦身、拆分边界、联调影响控制和测试锚点规范收敛成中文 owner 型 skill。用于在不打断当前 V5 功能推进的前提下，持续治理 `apps/web` 中的聚合页、超大文件和失控入口；不负责视觉重做或整站改版。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | govern-v5-web-structure |
| description | 在 AI-Dev-Orchestrator V5 期间，将前端结构治理、大文件瘦身、拆分边界、联调影响控制和测试锚点规范收敛成中文 owner 型 skill。用于在不打断当前 V5 功能推进的前提下，持续治理 `apps/web` 中的聚合页、超大文件和失控入口；不负责视觉重做或整站改版。 |
把 V5 期间前端“越写越胖、入口越来越乱、联调越来越脆”的问题，收敛成 可持续推进、风险可控、可逐步减债、可交接 的结构治理工作流。
这个 skill 的 owner 职责只有一个：
负责 V5 期间的前端结构治理：大文件瘦身、拆分边界、联调影响控制和测试锚点规范；不负责视觉重做、整站导航重构或最终美化。
它重点负责：
apps/web 里的聚合页进行低风险瘦身App.tsx、ProjectOverviewPage.tsx 等入口页继续做胖features/*、sections/*、components/*、hooks.ts、types.ts、api.tsdata-testid 等稳定锚点，减少测试对中文文案和页面排版的耦合它不应该把线程带偏成：
优先级从高到低如下：
docs/01-版本冻结计划/V5/00-V5正式冻结执行计划.mddocs/01-版本冻结计划/V5/ 下与当前 Day / 工作包直接相关的 README 与模板apps/web/package.jsonapps/web/src/app/App.tsxapps/web/src/features/projects/ProjectOverviewPage.tsxreferences/real-front-end-governance-surface.mdreferences/large-file-slimming-rules.mdreferences/page-owner-boundaries.mdreferences/refactor-vs-redesign-rules.mdreferences/frontend-test-anchor-rules.mdreferences/web-structure-thread-checklist.md如果这些输入之间冲突，以 V5 正式执行计划 + 仓库真实前端代码现状 + 已有联调/验证脚本为准，不要让空泛的“前端应该更漂亮”覆盖当前交付现实。
这个 skill 必须明确绑定到 V5 期间的结构治理，不允许脱离当前阶段去做泛化前端改版。
默认优先处理下列问题：
App.tsx 过胖、区块堆积、顶层逻辑失控ProjectOverviewPage.tsx 聚合过重、跨 feature 职责不清一句话：本 skill 解决的是“结构失控”，不是“页面不好看”。
在下列场景使用本 skill：
App.tsx / ProjectOverviewPage.tsx 做胖”出现下列主任务时，不要继续停留在本 skill：
write-v5-web-control-surfacewrite-v5-runtime-backenddrive-v5-orchestrator-deliveryverify-v5-runtime-and-regressionmanage-v5-plan-and-freeze-docs一句话：本 skill 管结构治理，不接管功能实现、验收裁定或视觉翻修。
apps/web/src/app/apps/web/src/features/apps/web/src/components/apps/web/src/lib/write-v5-web-control-surface 完整接管业务控制面新增verify-v5-runtime-and-regression 假装完成验证结论accept-v5-milestone-gate 做阶段裁定每次接手 V5 前端结构治理任务时，先按下面顺序读取，且只读最小集合：
docs/01-版本冻结计划/V5/00-V5正式冻结执行计划.mdreferences/real-front-end-governance-surface.mdreferences/large-file-slimming-rules.mdreferences/page-owner-boundaries.mdreferences/refactor-vs-redesign-rules.mdreferences/frontend-test-anchor-rules.mdreferences/web-structure-thread-checklist.mdapps/web/package.jsonapps/web/src/app/App.tsxapps/web/src/features/projects/ProjectOverviewPage.tsxapps/web/src/app/App.tsxapps/web/src/app/main.tsxapps/web/src/features/projects/ProjectOverviewPage.tsxapps/web/src/lib/http.tshooks.ts / types.ts / api.ts / Panel.tsx / Section.tsx遇到“前端太乱了，帮我整理”“先把这些大文件瘦下来”“这块别再长歪了”这类模糊请求时：
write-v5-web-control-surface；如果真正缺的是 build / smoke / 页面事实，就交回 verify-v5-runtime-and-regression。必须先回答：
data-testid、收口状态逻辑、拆 section如果答案偏向前者，就是结构减债；如果偏向后者，就是整站翻修，应当延后。
优先选择如下切片：
App.tsx 抽成 SectionProjectOverviewPage.tsx 某个大块抽成 Sectionhooks.tslib/*data-testid切片必须满足：小到不会打断 V5 节奏，大到能明显降低继续失控的风险。
默认按下列规则治理：
App.tsx只允许：
不允许：
ProjectOverviewPage.tsx只允许：
不允许：
满足任意一条，应优先拆分而不是继续往原文件里堆：
App.tsx 或 ProjectOverviewPage.tsx 继续明显变胖优先按下面方式落位：
features/<domain>/sections/ 或 app/sections/features/<domain>/components/features/<domain>/hooks.tsfeatures/<domain>/types.tsfeatures/<domain>/api.tssrc/lib/默认禁止：
每次结构治理都要明确：
凡是下列改动，默认补 data-testid：
优先让测试依赖：
data-testid每次结构治理线程结束时，至少要说明：
npm run buildwrite-v5-web-control-surface 负责：前端业务控制面和真实功能入口交付write-v5-runtime-backend 负责：后端实现drive-v5-orchestrator-delivery 负责：跨层整链推进verify-v5-runtime-and-regression 负责：运行事实、build、API、页面验证manage-v5-plan-and-freeze-docs 负责：计划冻结、状态回填、交接治理accept-v5-milestone-gate 负责：最终裁定本 skill 不能替这些兄弟 skill 越权宣布“功能已完成”“整条链已打通”“阶段已通过”。
优先使用下面骨架汇报本轮结构治理：
# 本轮前端结构治理切片
## 背景归属
- Phase：
- 工作包：
- 当前属于：结构治理 / 低风险瘦身
- 明确不属于：视觉改版 / 整站翻修
## 本轮目标
- 主要瘦身对象：
- 本轮纳入的文件：
- 本轮明确不做：
## 文件级动作
- 抽出的 section / panel：
- 下沉的 hooks / types / api / lib：
- 新增的 testid：
- 保持不变的行为：
## 联调与测试影响
- 接口合同是否变化：
- 关键文案是否变化：
- 现有脚本是否需要同步关注：
- 风险点：
## 验证
- 已执行：
- 结果：
- 未执行：
## 交接路线
- 下一线程建议：
- 如需功能交付：
- 如需 verify：
- 如需 docs：
出现以下情况时，不能算本 skill 工作合格完成：
App.tsx / ProjectOverviewPage.tsx 等真实入口文件。references/real-front-end-governance-surface.md
references/large-file-slimming-rules.md
references/page-owner-boundaries.md
references/refactor-vs-redesign-rules.md
references/frontend-test-anchor-rules.md
references/web-structure-thread-checklist.md
playbooks/web-structure-governance-playbook.md
templates/web-structure-handoff-template.md
Use when continuing AI-Dev-Orchestrator AI Project Director P10 work that must move from readonly repository evidence to evidence-grounded task composition, executor-backed programmer/reviewer agent binding, and dry-run orchestration without product runtime Git writes or premature total-loop Pass claims.
将 AI-Dev-Orchestrator V5 的 skill-pack 体检、修复、补强、正式化包装与联动治理收敛成中文维护型 skill。用于当主任务是维护 `.codex/skills/` 里的 V5 skills 本身，而不是直接推进 `apps/web`、`runtime/orchestrator`、冻结文档或运行验证时，持续修复乱码、结构缺口、边界混乱、路由失真与配套缺失，让后续线程能稳定调用正确的 owner skill。
将 AI-Dev-Orchestrator V5 母本中的跨 backend / web / docs / verify 整链推进任务收敛成中文总控交付型 skill。用于当单一实现 skill 已经不够时，识别工作包归属、锁定最小跨层交付切片、编排后端/前端/文档/验证动作，并把线程推进到真实可交接状态。
将 AI-Dev-Orchestrator V5 母本中的运行验证、构建验证、接口核对、页面验证与最小回归检查收敛成中文事实确认型 skill。用于确认后端是否可启动、worker/API 是否真的通、前端是否真的能 build 和打开，以及当前线程宣称的“已接入 / 已完成 / 已可用”是否有运行证据支撑。
将 AI-Dev-Orchestrator V5 母本中的前端控制面工作包真正落到 `apps/web` 的中文实现型 skill。它负责把项目总览、角色策略、技能绑定、团队控制、记忆治理、成本可视化、运行观测等能力做成真实控制面，同时在落地过程中主动防止前端结构继续长歪；一旦主问题转为结构治理，必须让位给 `govern-v5-web-structure`。
将 AI-Dev-Orchestrator V5 母本中的工作包 / 阶段裁定、Pass / Partial / Blocked 分级、无法裁定判定、缺证识别与遗留项收口规则收敛成中文验收型 skill。用于在实现、review、verify 之后，对某个 V5 切片、工作包或阶段给出正式 gate 结论，并明确可放行边界、不可放行边界、阻塞原因、缺失证据与下一线程接力方向。