devlab-web-contextlisted
Install: claude install-skill seed-forge/harness-ai-kit
# 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 画像"。
*