前端团队的 AI 工程资产

前端团队可沉淀的 AI 工程资产地图：规则、Skills、测试/评估、知识上下文、代码组件与场景物料怎样共同把个人 AI 使用经验变成稳定团队能力。

#frontend #synthesis #growing

[!info] related notes

所属 MOC: 前端工程化 MOC

执行工作流: AI 辅助前端开发工作流

Skills: AI Skills

组件/物料: 组件库 vs 物料库

TDD: AI 编码时代的 TDD

Review: AI Code Review 与重构

前端团队的 AI 工程资产

一句话定义

AI 工程资产是：

把一次次人工提示、纠错和项目知识，沉淀成 Agent 可以稳定复用、可以验证、可以维护的工程结构。

它的目标不是“保存 Prompt”，而是降低下一次相似任务的搜索空间和出错概率。

六类核心资产

1. Instructions / Rules

例如：

AGENTS.md；
coding conventions；
architecture boundaries；
test commands；
generated-file rules。

适合 always-on、范围明确、所有任务都需要的约束。

2. Skills / Workflow

适合复杂但不是每次都需要的流程：

release；
migration；
design review；
UI audit；
incident triage。

把长期规则和按需流程分开，可以减少常驻上下文噪声。

3. Tests / Evals / Linters

这是最重要的一类，因为它把：

“应该这样做”

变成：

“系统可以自动判定有没有这样做”

例如：

unit/integration/e2e；
visual regression；
typecheck；
ESLint rule；
architecture test；
Agent eval dataset。

4. Knowledge / Context

例如：

ADR；
API contract；
domain glossary；
design system docs；
component examples；
debugging notes。

它们让 Agent 少猜项目事实。

5. 可运行代码资产

例如：

component library；
hooks/utilities；
API client；
shared types；
scaffold/template。

AI 最稳定的复用方式之一，就是直接调用已有正确代码，而不是重新生成相同能力。

6. 场景物料 / Patterns

更接近业务结构：

FilterHeader；
CRUD table pattern；
settings panel；
dashboard card group；
standard form section。

组件库与物料库的边界见组件库 vs 物料库。

资产成熟度

可以粗略理解成：

临时 Prompt
→ 文档规则
→ 可复用 Skill
→ 可执行模板/组件
→ 自动 Test/Eval
→ 可持续反馈闭环

越往后，越少依赖“模型恰好理解对了”。

一个资产什么时候值得沉淀

出现这些信号：

同类任务反复发生；
同一个错误反复 review；
每次都需要重新解释项目结构；
有稳定输入输出 contract；
验证方法已经明确。

如果只发生一次、边界还没稳定，先不要急着抽象。

怎么判断资产有效

不要只统计“有多少 Prompt/Skill”。

更有意义：

首次通过率；
review comment 数量；
rework；
lead time；
regression；
context token / 操作成本；
资产维护成本。

一个复杂 Skill 如果几个月只用一次，且每次都要先修 Skill，本身可能就是负资产。

Human-in-the-loop 仍然需要什么

AI 工程资产可以降低随机性，但不会替代：

产品判断；
架构 tradeoff；
权限审批；
高风险发布；
UX 质量判断。

它做的是把已知可固化部分尽量工程化。

常见失败模式

Prompt 仓库无限增长

没有 owner、trigger、test、deprecated policy，就只是文档垃圾场。

Rules 过重

所有细节都塞 always-on instructions，导致任务上下文越来越噪。

只有生成资产，没有验证资产

生成速度更快，但 regression 也更快。

组件/物料边界混乱

业务特例塞进基础组件，或每个页面都重新拼同一种业务结构。

学习检查

为什么 Prompt 本身不一定算成熟工程资产？
Instructions 与 Skill 的触发范围有什么差异？
为什么 Tests/Evals 是比“更多提示词”更强的资产？
代码组件与场景物料各自降低哪类生成成本？
哪些信号说明一个重复工作值得沉淀成资产？
如何判断一个 Skill 已经成为维护负担？
给一个前端团队反复出现的 UI 任务，设计 rule、material、test、skill 四层资产。