用途
Prime Frontend 的目标是让 AI 智能体在复杂全栈代码库中,只针对前端部分建立精准理解。它通过分析前端代码库的结构、组件和约定,加载前端上下文,从而保持上下文窗口轻量。如果提供了外部任务引用,会先加载这些引用,使分析锚定到实际工作。
主要能力
- 加载外部上下文:支持可选的 Jira 工单键和 Confluence 页面 ID 参数。Jira 键可以是单个(如 ACC-2)或逗号分隔(如 ACC-2,ACC-3);Confluence 页面 ID 为数字。若提供 Jira 工单键,会调用 mcp__atlassian__getAccessibleAtlassianResources 获取 cloudId,再对每个键调用 mcp__atlassian__getJiraIssue,使用 responseContentFormat: "markdown",并将返回的摘要、描述和验收标准作为后续任务上下文。若提供 Confluence 页面 ID,会调用 mcp__atlassian__getConfluencePage,使用 contentFormat: "markdown",将返回内容作为支持性上下文(规格、设计文档、需求)。若无参数,则跳过此步骤。
- 定位前端:通过
!git ls-files列出所有跟踪文件,找到前端根目录。常见前端根目录包括 frontend/、client/、web/、src/(项目仅为前端时)、app/(Next.js)。 - 阅读前端文档:读取 CLAUDE.md 或类似全局规则文件、前端根目录内的 README,以及 .claude/references/frontend-component-best-practices.md(如果存在)。
- 识别关键前端文件:读取主入口点(main.tsx、index.tsx、app/layout.tsx、pages/_app.tsx 等)、路由配置(router.tsx、routes.ts、Next.js 的 app/ 目录)、全局状态设置(store、context providers)、共享组件库根目录(components/、ui/)、核心配置(package.json、tsconfig.json、vite.config.ts、next.config.ts),以及一两个代表性功能组件。除非前端依赖的共享类型或契约,否则跳过前端根目录之外的文件。
- 了解当前前端状态:检查最近前端相关活动,运行
!git log -10 --oneline和!git status,注意前端目录中的未提交更改。
使用方式
该技能以步骤化流程执行:先加载外部上下文(可选),然后定位前端、阅读文档、识别关键文件、了解当前状态,最后输出报告。报告包含外部任务上下文(若已加载)、前端概览(框架和主要库、组件模式、状态管理方式)、目录映射、约定(命名、文件共置规则、样式方法、测试框架和约定)、当前状态(活动分支、最近前端更改、即时关注点)。报告使用项目符号和清晰标题,便于快速浏览。
适用场景
适用于需要 AI 智能体在复杂全栈代码库中专注于前端部分的任务,例如前端功能开发、组件修改、路由调整、状态管理变更或样式更新。通过只加载前端上下文,避免上下文窗口被后端代码占满。
限制
该技能依赖 git 仓库和文件结构,需要项目已使用 git 跟踪文件。外部上下文加载依赖 Atlassian MCP 工具(mcp__atlassian__getAccessibleAtlassianResources、mcp__atlassian__getJiraIssue、mcp__atlassian__getConfluencePage)。若未提供参数,则跳过外部上下文步骤。具体支持的框架和库取决于项目实际使用的技术栈,技能本身不限定框架。