📖 指令字典
不知道该说什么？查这张表。 在 AI 编程工具中说 "帮助" 或 "有哪些指令" 可随时调出本字典。
🚀 快速查询
项目初始化
| 你想做什么 | 说什么 | 调用的 Skill | 产出物 |
|---|---|---|---|
| 初始化项目 AI 配置 | "初始化 AGENTS.md" / "生成 AI 配置" | fe-agent-init | AGENTS.md + AGENTS.local.md + DESIGN.md |
| 生成设计规范 | "生成 DESIGN.md" / "初始化设计规范" | fe-agent-init | DESIGN.md |
| 生成项目 Skill | "初始化项目 Skill" / "生成项目 Skill" | fe-base-skill | 项目层 Skill 目录 |
| 蒸馏项目规范 | "蒸馏项目规范" / "整理最佳实践" | fe-base-skill | knowledge/best-practices.md |
| 团队 Skill 分发 | "初始化项目 Skill 体系" / "帮项目配置 AI Skill" | fe-template-skill | .agents/manifest.json + 成员指南 |
前端工程（fe-engineer-pack）
| 你想做什么 | 说什么 | 子 Skill | 产出物 |
|---|---|---|---|
| 写技术方案 | "帮我写技术方案" / "方案设计" / "架构设计" | S1 tech-design | 技术方案文档 |
| 生成组件 | "帮我写个 xx 组件" / "生成组件" | S2 component-builder | 组件代码 + 样式 + 类型 |
| Code Review | "帮我 CR" / "代码审查" / "review 这段代码" | S3 code-review | 审查报告 + 改进建议 |
| 接口联调 | "帮我对接口" / "接口联调" / "生成 mock" | S4 api-contract | Service 层 + 类型定义 |
| 排查 Bug | "帮我排查这个 bug" / "定位问题" | S5 bug-diagnosis | 根因分析 + 修复方案 |
| 性能优化 | "页面卡顿" / "性能优化" / "Lighthouse 分数低" | S6 perf-audit | 性能报告 + 优化建议 |
| 写技术文档 | "帮我出个技术文档" / "项目文档" | S7 tech-doc | Markdown 技术文档 |
日常编码（fe-base-skill）
| 你想做什么 | 说什么 | 模式 | 产出物 |
|---|---|---|---|
| 写代码 / 加功能 | "帮我写 xx" / "加个 xx 功能" | 标准模式 | 代码 + 5 步检测 + Commit |
| 改 Bug | "修复 xx" / "这里报错了" | ⚡ 轻量模式 | 修复代码 + Commit |
| 重构代码 | "重构 xx" / "优化这段代码" | 标准模式 | 重构代码 + 检测报告 |
前端测试（fe-test-pack）
| 你想做什么 | 说什么 | 子 Skill | 产出物 |
|---|---|---|---|
| 设计测试场景 | "设计测试场景" / "测试方案" | T1 scenario-designer | 测试场景方案 |
| 写单元测试 | "写测试" / "单元测试" / "Vitest" | T2 unit-test-gen | 单元测试代码 |
| 写 E2E 测试 | "E2E 测试" / "Playwright" | T3 e2e-test-gen | E2E 测试代码 |
| 回归验证 | "回归测试" / "防回归" | T4 regression-guard | 回归测试代码 |
产品经理（pm-engineer-pack）
| 你想做什么 | 说什么 | 子 Skill | 产出物 |
|---|---|---|---|
| 写 PRD | "帮我写 PRD" / "产品需求文档" | P1 write-prd | 结构化 PRD |
| 竞品分析 | "竞品分析" / "对比 xx 和 yy" | P2 competitor-analysis | 竞品对比矩阵 |
| 功能排优先级 | "功能排优先级" / "RICE 评分" | P3 feature-priority | 优先级矩阵 |
| 用户故事 | "写用户故事" / "用户旅程" | P4 user-story | INVEST 用户故事列表 |
| 上线规划 | "上线规划" / "版本规划" / "排期" | P5 launch-plan | 排期计划 |
| 干系人汇报 | "写周报给老板" / "干系人同步" | P6 stakeholder-update | 汇报文档 |
| 数据看板 | "定义指标看板" / "数据看板" | P7 metrics-dashboard | 指标体系 + 看板方案 |
| 原型构建 | "做个原型" / "画原型" | P8 prototype-builder | 原型方案 |
| 需求拆解 | "拆需求" / "需求拆解" | P9 requirement-breakdown | 任务拆解列表 |
| PRD 审查 | "审查 PRD" / "PRD 检查" | P10 prd-reviewer | PRD 审查报告 |
设计师（designer-pack）
| 你想做什么 | 说什么 | 子 Skill | 产出物 |
|---|---|---|---|
| 制定设计规范 | "制定设计规范" / "色彩体系" / "字体规范" | D1 style-guide | 设计规范文档 |
| 组件规格定义 | "写组件设计说明" / "间距规范" | D2 component-spec | 组件规格文档 |
| 设计走查 | "设计走查" / "还原度检查" | D3 design-review | 走查报告 |
| 无障碍审计 | "无障碍审计" / "a11y 检查" / "WCAG" | D4 accessibility | 无障碍报告 |
| 响应式适配 | "多端适配方案" / "响应式" | D5 responsive-spec | 适配方案 |
| 设计交付 | "设计交付给开发" / "标注文档" | D6 design-handoff | 交付文档 |
开发者蒸馏（fe-developer-distill）
| 你想做什么 | 说什么 | 产出物 |
|---|---|---|
| 蒸馏编码风格 | "蒸馏 xx 的编码风格" / "分析编码习惯" | 开发者 Skill Profile |
| 生成开发者画像 | "开发者画像" / "提取编码风格" | 编码风格报告 |
体系管理
| 你想做什么 | 说什么 | 调用的 Skill | 产出物 |
|---|---|---|---|
| 查看可用指令 | "帮助" / "有哪些指令" / "指令列表" | fe-hub（内置） | 本字典 |
| 检查 Skill 状态 | "Skill 健康检查" / "检查 Skill 状态" | fe-hub（内置） | 状态报告 |
| 创建/修改 Skill | "创建 Skill" / "修改 Skill" | skill-creator | Skill 文件 |
| 搜索社区 Skill | "找 Skill" / "搜索能力" | find-skills | 可用 Skill 列表 |
| 批量更新仓库 | bash ~/.agents/skills/bin/skill-sync.sh pull | Shell 脚本 | 所有子仓库更新到最新 |
🏗️ 模块职责划分
| 模块 | 层级 | 职责 | 不负责 |
|---|---|---|---|
| fe-hub | 编排层 | 路由调度、链式编排、Token 管理、错误恢复、会话记录 | 不写代码、不做检测、不做具体业务 |
| fe-base-skill | 规范层 | 5 步代码检测、Commit 生成、护栏规则、偏好管理、经验学习 | 不做高级功能（方案/组件/CR/文档） |
| fe-agent-init | 配置层 | 项目扫描、AGENTS.md 生成、DESIGN.md 生成 | 不做代码变更、不做检测 |
| fe-engineer-pack | 能力层 | S1-S7 高级前端工程能力 | 不做产品/设计、不管护栏规则 |
| fe-template-skill | 分发层 | 团队级 Skill 一键分发、版本锁定 | 不做具体开发任务 |
| fe-developer-distill | 蒸馏层 | 开发者编码风格分析、Profile 生成 | 不做代码变更 |
| fe-test-pack | 能力层 | T1-T4 前端测试全流程 | 不做开发、不管护栏规则 |
| pm-engineer-pack | 能力层 | P1-P10 产品经理工作流 | 不做技术实现、不写代码 |
| designer-pack | 能力层 | D1-D6 设计体系和流程 | 不写代码、不做产品 |
易混淆指令区分
| 你说的话 | 路由到 | 为什么 |
|---|---|---|
| "技术方案" / "架构设计" | fe-engineer-pack → S1 | 技术视角的方案 |
| "PRD" / "需求文档" | pm-engineer-pack → P1 | 产品视角的文档 |
| "需求分析"（涉及代码/组件） | fe-engineer-pack → S1 | 上下文偏技术 |
| "需求分析"（涉及用户/市场） | pm-engineer-pack → P2/P3 | 上下文偏产品 |
| "帮我做设计"（UI 代码） | frontend-design | 生成界面代码 |
| "帮我做设计"（设计规范） | designer-pack | 管设计出规范 |
| "性能优化"（代码级） | fe-engineer-pack → S6 | 性能审计 |
| "性能优化"（动画专项） | fixing-motion-performance | 动画性能诊断 |
🔗 常用链式调用
| 场景 | 触发方式 | 执行链路 |
|---|---|---|
| PRD 到代码 | "帮我从 PRD 到代码实现" | S1 → S2 → S4 |
| 写组件 + CR | "帮我写个组件，写完帮我 CR" | S2 → S3 |
| 排查 Bug + 性能 | "排查这个 bug，顺便看性能" | S5 → S6 |
| 全流程 | "把这个需求做完，最后出文档" | S1 → S2 → S4 → S7 |
| 新功能从 0 到 1 | "做竞品分析 → 写 PRD → 拆需求" | P2 → P3 → P1 → P4 → P5 |
| 设计到开发 | "出设计规范 → 设计交付" | D1 → D2 → D6 |
⚙️ Shell 命令
bash
# 项目初始化（一键生成 AI 配置）
bash ~/.agents/skills/fe-hub/bin/fe-skill-init.sh
# Skill 体系管理
bash ~/.agents/skills/bin/skill-sync.sh pull # 批量拉取最新
bash ~/.agents/skills/bin/skill-sync.sh push # 批量提交推送
bash ~/.agents/skills/bin/skill-sync.sh status # 查看所有状态
bash ~/.agents/skills/bin/skill-sync.sh diff # 查看所有变更
# Skill 检测 / 安装 / 更新
bash ~/.agents/skills/bin/skill-check.sh check <name> # 检测单个 Skill 是否有更新
bash ~/.agents/skills/bin/skill-check.sh check-all # 批量检测所有自研 Skill
bash ~/.agents/skills/bin/skill-check.sh update <name> # 更新单个 Skill 到最新版本
bash ~/.agents/skills/bin/skill-check.sh install <name> # 安装缺失的 Skill
bash ~/.agents/skills/bin/skill-check.sh help # 查看帮助信息