devlab-web-context

devlab-web-context — 前端项目上下文理解规则资产

<domain>-context 家族（web/srv/infra/tool）首个成员。只提供 Understand Capability： 规定"什么时候理解、理解什么、理解到什么程度"，产出前端 context 画像，不生产五件套台账。

定位与边界

• 本技能是什么：web 域前端项目上下文理解规则（信号表 + 特有条目 + 渐进式理解工作流）。
• 本技能不是什么：不生产 .harness/devlab/ 五件套台账（那是 devlab-context-bootstrap 的职责）；不是工程化能力层（那是 devlab-web-engineering）；不自建 CLI（社区 CLI/MCP/Skill 引用策略见 bootstrap 通用层）。
• 家族化：与未来的 devlab-srv-context / devlab-infra-context / devlab-tool-context 同构——共享 bootstrap 通用层（四原则全文 + 社区引用 + 五件套骨架），本技能只承载 web 领域规则。

四原则（一句话摘要）

完整原则全文在 devlab-context-bootstrap（缺失时本摘要可独立指导行为）。

1. context-before-change：改动任何代码前先建立最小上下文，禁止在未知项目状态下动手。
2. evidence-before-assumption：画像条目只写实证（读到的配置/跑通的命令）；推断必须标注依据；未验证标 todo。
3. progressive-understanding：按需加深，最小上下文起步，置信度不达标才 Deepen，不做一次性全量理解。
4. re-understand：执行中发现认知偏差（命令跑不通/现象与画像不符）立即回退重理解，不将错就错。

双模式入口

模式 A：规则包模式（被 bootstrap 委托）

触发方：devlab-context-bootstrap Phase 0 判定 frontend-web 后。

执行：

1. 判定前端子类型（信号文件）：有 qiankun/micro-app/自研 shell 注册配置 → vue-microfrontend；有 react + SPA 结构 → react-spa；默认 vue-microfrontend（当前实证最全）。
2. 读取 profiles/<profile_type>.md（子类型特有信号与条目）+ references/REFERENCE-WEB-RULES.md（跨子类型通用信号）。
3. 按信号表扫描项目，逐条产出画像维度（key/value/confidence/evidence/note）。
4. 画像写入 .harness/devlab/context/<project>-web-context.yaml（契约见下文）。
5. 返回给 bootstrap：画像路径 + 概要（profile_type / overall_confidence / 主要发现）。

模式 B：完整工作流模式（独立自编排）

触发：用户直接要求"理解这个前端项目 / 生成前端 context 画像"。

工作流（四步循环）：

Task
 ↓
Identify Scope        # 项目根、子应用清单（monorepo 逐个）、理解目的（改代码/排障/验收）
 ↓
Build Minimal Context # 读 profiles/<type>.md + REFERENCE-WEB-RULES → 最小信号扫描
 ↓
Confidence Check      # 每条目标 confidence：confirmed 需 evidence；不足 → Deepen
 ↓
足够理解 → 产出画像并结束
不足 → Deepen Context  # 读更多配置/跑命令/查注册配置
认知偏差 → Re-understand  # 回退重扫，更新画像

结束条件：所有关键键达到 confirmed 或 inferred（无未解释的 todo 阻塞），或资源上限（扫描轮次/时间）。

产出：前端 context 画像（契约见下）。需落台账时 → 委托 devlab-context-bootstrap（镜像衔接：bootstrap 消费画像填五件套）。