# AGF 培训 deck · 术语表（v1.4 草稿 · 2026-05-17）

> **定位**：本文件是 **128 张培训 deck 的术语索引**，只收录培训中出现 + `docs/product-workflow.md §4` **没覆盖的**术语。
> PM / Agile / 测试 / Release 等通用术语请直接查 [`docs/product-workflow.md §4 术语词典`](../product-workflow.md#4-术语词典)。
> **去重原则**：本表与 product-workflow §4 互不重复 · 同一术语只在一处定义。

---

## 1. AI 编程工具 / 概念（v1.2 引入）

| 术语 | 解释 | 出处 / 引用 | 出现 slide |
|---|---|---|---|
| **Vibe Coding** | "完全交给 AI 的氛围编程" · 接受所有 AI 输出 · 不审 diff · 不写测试 · 让代码 organically 生长 | Andrej Karpathy · X · 2025-02-02 · Collins 2025 Word of the Year | p-014 |
| **"fully give in to the vibes"** | Karpathy 原文金句 · 完整版："fully give in to the vibes, embrace exponentials, and forget that the code even exists" | 同上 | p-014 |
| **Claude Code** | Anthropic 官方 agentic CLI · 2025-02 preview / 2025-05 GA · 终端原生 · 读整个 codebase · 执行 git workflow | Anthropic 官方 · docs.anthropic.com/en/release-notes/claude-code | p-015, p-016 |
| **OpenAI Codex** | OpenAI 云 agent · 集成 ChatGPT · 沙箱容器 · Terminal-Bench 2.0 第 1（77.3%） | builtin.com 2026 综评 | p-016 |
| **Cursor** | VS Code Fork 实时 IDE · GUI 集成 AI · 适合日常编辑 / autocomplete | cursor.com | p-016 |
| **GitHub Copilot** | GitHub + OpenAI 合作 · IDE 内联补全 · 历史最早消费级 AI 编程工具 | github.com/features/copilot | p-016 |
| **SWE-bench Verified** | 软件工程任务基准测试 · 验证模型独立完成真实 issue 的能力 · Claude Opus 4.6 第 1 (80.9%) | swebench.com | p-016 |
| **Terminal-Bench 2.0** | 终端任务基准 · Codex 第 1 (77.3%) | terminalbench.com | p-016 |
| **SuperWhisper** | 语音转文字工具 · Karpathy 用于 Vibe Coding 时减少键盘输入 | superwhisper.com | p-014 |
| **Agentic CLI** | 不是只回答问题 · 能自主执行操作（写文件 / 跑命令 / 提交 git）的命令行工具 | Anthropic 定义 | p-015 |

---

## 2. AGF 团队模板特有术语

> AGF = "AppGenesisForge" 项目名 · 也是本团队模板缩写。

### 2.1 14 角色（详见 [`.claude/agents/*.md`](../../.claude/agents/)）

| 角色 | 简称 | 主要输出 | 出现 slide |
|---|---|---|---|
| **product-lead** | PL | PRD / 派单 / UAT 业务签字 · **唯一流程编排者** | 全 deck |
| **tech-lead** | TL | ADR · 仅在缺基线 / 新选型 / 架构升级时介入 | p-038 |
| **frontend-dev** | FE | 前端代码 + Unit + SIT 自跑 | p-039 |
| **backend-dev** | BE | 后端代码 + Unit + SIT 自跑 + Plan Mode 触发（schema/auth） | p-039 |
| **ai-agent-dev** | AI-Agent | LLM 链路代码 · prompt 是代码 · 高风险变更必先 Plan Mode | p-039, p-040 |
| **ml-engineer** | ML-Eng | 模型选型 ADR · 多模态评测 | p-044 |
| **code-reviewer** | — | review-only · `docs/reviews/` · 双 verdict（代码 + SIT Audit） | p-065-068 |
| **qa-engineer** | qa | E2E + UAT 报告 · `docs/qa/` · 默认 verdict = ❌ Fail | p-072-073 |
| **uiux-designer** | — | 设计规范 + 静态原型（含 MiniApp Mode 覆盖） | p-031 |
| **content-writer** | — | Release Notes / Blog / Case · ≤200/800/1500 字 | p-031 |
| **miniapp-dev** | — | 微信小程序版变体 | p-066 |
| **miniapp-code-reviewer** | — | 小程序独立 review | p-066 |
| **miniapp-qa-engineer** | — | 小程序真机抽测 | p-066 |
| **post-launch-***（2 个）| — | 上线后 growth-analyst + 增长复盘 | p-031 |

### 2.2 流程 / 阶段门特有词

| 术语 | 解释 | 出现 slide |
|---|---|---|
| **AC 摘录派单** | PRD AC 必进派单消息 · `validate-task-schema.sh` hook 校验缺段 | p-036 |
| **SIT Audit** | code-reviewer 对 progress 里 SIT 证据段的独立性 audit · verdict 三档 | p-065-067 |
| **双 verdict** | code-reviewer 同时输出"代码 verdict + SIT Audit verdict" · 独立判定 | p-065 |
| **Plan Mode** | ai-agent-dev / backend-dev 在高风险变更（prompt 重构 / 模型切换 / schema 改 / token 预算变 / 工具调用变 / 数据结构变）必先进入 + 拿 PL 授权 · 6 触发点 | p-074 |
| **brainstorming** | product-lead 用 `superpowers:brainstorming` skill 4 轮澄清需求（风格 / cost / 分享形态等）| p-033 |
| **Self-Reporting Pattern** | dev 跑完写 `progress/<role>.md` · UAT 签字后归档 `docs/qa/<feature>-process-log.md` | p-042, p-083 |
| **6 阶段门** | PRD → 派单 → 实现+Unit+SIT → Review+SIT Audit → E2E → UAT 签字 · 任一失败回 ③ 实现 · 不跳级 | p-064 |
| **失败回路** | 同 "6 阶段门"语义 · 强调"永不跳级回 ③ 实现层重新走" | p-064 |
| **No Equivalent Bypass** | 撞硬阻断时不寻找等价绕路 · 必须找 PL 授权或换方案 | p-059 |
| **push back** | dev 收 review 时基于实测数据有理据反对 reviewer · 例：A/B 数据反驳风格评分 | p-069 |
| **章末金句** | 每章末 1 张"本章你已学会 3 件事" · v1.1 引入 | 全章 |
| **章首预测** | 每章首 1 张"现在请你猜：X 选 A/B/C" · 30 秒思考 + 邻座对答案 · v1.1 引入 | 全章 |
| **Lab check-in** | Lab 33% / 66% 中场 · 举手 + 救火 box · v1.1 引入 | p-096, p-100 |

### 2.3 4 层 Hook（详见 [`.claude/standards/security.md`](../../.claude/standards/security.md)）

| 术语 | 触发时机 | hook 脚本 | 拦截目标 |
|---|---|---|---|
| **Layer 1 · UserPromptSubmit** | 用户提 prompt 时 | `scan-secrets.sh` | 8 类密钥泄漏（AWS / GitHub / OpenAI / Anthropic / DeepSeek / Doubao / Qwen / MiniMax + PEM/SSH/BIP39） |
| **Layer 2 · PreToolUse (Bash)** | LLM 即将调 Bash 工具时 | `block-dangerous-bash.sh` | rm -rf / DROP TABLE / git push --force / git reset --hard / curl \| sh / eval |
| **Layer 3 · PostToolUse** | 工具返外部内容时 | `sanitize-tool-output.sh` | prompt-injection 软告警（"ignore previous" 类指令） |
| **Layer 4 · git pre-commit** | git commit 时 | `scan-commit.sh` | commit 前再扫 staged diff · 防 Edit/Write 绕过 prompt scan |
| **workflow hooks**（不属于防御） | — | `teammate-keepalive.sh` / `skill-suggester.sh` / `check-progress-file.sh` / `validate-task-schema.sh` | 维护团队工作流 |

### 2.4 Skill 强制 vs 推荐

| 强制 skill | 推荐 skill |
|---|---|
| `agf-running-sit-tests`（dev 自跑 SIT） | `superpowers:systematic-debugging`（bug 出现时） |
| `superpowers:test-driven-development`（TDD red-green-refactor） | `superpowers:verification-before-completion`（claim done 前） |
| `agf-wiring-multi-llm-sdk`（多 LLM SDK 接入） | `superpowers:brainstorming`（创意工作前） |
| `agf-writing-qa-report`（qa 写 E2E/UAT） | `superpowers:writing-plans`（多步任务前） |
| `agf-writing-prd`（PL 写 PRD） | `superpowers:receiving-code-review`（dev 收 review 时） |
| `agf-writing-adr`（TL 写 ADR） | `agf-running-release-retro`（MAJOR/MINOR release 后） |

### 2.5 项目级 slash command

| 命令 | 作用 |
|---|---|
| `/agf-team-start "<目标>"` | 启动 Team Mode · 自动 spawn product-lead · 进入 brainstorming 4 轮澄清 |
| `/agf-tasks` | task list 表格视图 |
| `/agf-uat <feature>` | 触发 UAT 流程 |
| `/agf-release-retro vX.Y.Z` | MAJOR/MINOR release 后强制走 7 步 retro |

### 2.6 反模式 / 坑

| 反模式 | 触发场景 | 后果 |
|---|---|---|
| **tag-orphan** | commit 后未同会话 `git tag -a` | release 流程不可追溯 · PL 必须当次会话补打或解释延期 |
| **"既当裁判又当球员"** | reviewer / qa 改源码 | 同人盲点 · review 失效 → AGF 红线：永远不动 source code |
| **"为复盘而复盘"** | PATCH 也做 retro | 浪费 ~2h 协调 · AGF 取舍：PATCH 跳过 retro · 只 MAJOR/MINOR 做 |
| **"讲不清楚做对了"** | dev 跑了 SIT 但没写证据 | 比代码烂更严重 · code-reviewer SIT Audit 拒收 |
| **Vibe Coding 极致** | 接受所有 AI 输出 · 不审 diff · 不写测试 | 15 小时清理（参考 @nijho.lt 实测） · AGF 取舍：享速度 + 4 层 hook 兜底 |

---

## 3. LLM 厂商 / 模型 / 集成（详见 ADR-000 + `docs/training/diagrams/src/C2-llm-matrix.drawio`）

| 厂商 / 模型 | 类型 | 定价（2026-05 · $/M token in/out）| AGF 用途 |
|---|---|---|---|
| **DeepSeek V4-Pro** | 纯文本 SOTA | $0.14 / $0.28 · 最便宜 | 纯文本任务首选 |
| **Doubao-Seed-2.0-Pro**（豆包）| 原生多模态 | $0.47 / $2.37 · 全栈友好 ⭐ | **AGF 主栈** |
| **Doubao Vision** | 图像识别 API | — | 旅游明信片识别照片主体 |
| **Doubao Seedream** | 文生图 API | — | 明信片卡片图生成 |
| **Qwen3.6-Max** | 阿里生态 · VL 强 | $0.50 / $2.00 | fallback / VL 任务 |
| **MiniMax M2.7** | 长上下文 · 角色扮演 | $0.50 / $2.50 | 长 context fallback |
| **OpenAI-compatible adapter** | 统一接口 · 切厂商只改 1 处 | — | `backend/app/config/llm_routing.py` |
| **env-var 契约** | `DEEPSEEK_API_KEY` / `DOUBAO_API_KEY` 等命名固定 · 不混 hardcoded | — | `.env` |
| **fallback 链** | Pro → Lite → Mini 同厂商 · 跨厂商演练单独写故障注入 | — | `skill agf-wiring-multi-llm-sdk` |
| **cost guardrail** | 调用前估算 cost · 超 AC 预算自动 fail + 通知 PL | — | 同上 skill 强制点 ④ |

---

## 4. 学员画像 / 培训角色

| 简称 | 全称 | 适合做什么 |
|---|---|---|
| **P1** | 业务型 | 跟读 · 把 `/agf-team-start` 加入工作流 · 学"看产物"而非"看代码" |
| **P2** | 入门工程型 | 自装环境 · 独立跑一个 AI feature 6 阶段门 · 写第一份 ADR |
| **P3** | 资深观察型 | 另跑复杂场景 · 评估迁移到自己栈 · 4 件保留 / 3 件可替换 |
| **讲师** | content-writer + product-lead | 共 5 道盲测题 + 8 份样例素材 + 41 张 draw.io 图 |

---

## 5. 理论 / 历史人物 + 中文书目（v1.2 引入 · 详见 p-013）

| 年 | 人物 / 团体 | 事件 / 著作 | 中文版书目 |
|---|---|---|---|
| **1986** | Takeuchi & Nonaka | HBR《The New New Product Development Game》 | — |
| **1993** | Jeff Sutherland @ Easel | 首次实施 Scrum（与 Scumniotales / McKenna） | — |
| **1995** | Ken Schwaber @ OOPSLA · Austin TX | 公开 Scrum 论文 | — |
| **2001-02** | Snowbird Utah · 17 人 | Agile Manifesto 签署（Kent Beck / Martin Fowler / Sutherland / Schwaber / Uncle Bob 等） | — |
| **2002** | Kent Beck | 《Test-Driven Development: By Example》Addison-Wesley · ISBN 0321146530 | **《测试驱动开发》** 中国电力出版社 2004 · 9787508321738 · 孙平平 / 张小龙 译 |
| **2008** | Robert C. Martin（Uncle Bob）| 《Clean Code》Prentice Hall | **《代码整洁之道》** 人民邮电出版社 2010 · 9787115216878 · 韩磊 译 |
| **2010** | Schwaber + Sutherland | 首版《Scrum Guide》 | — |
| **2014** | Jeff Sutherland | 《Scrum: The Art of Doing Twice the Work in Half the Time》Crown Business | **《敏捷革命》** 中信出版社 2017 · 9787508671437 · 蒋宗强 译 |
| **2019** | Martin Fowler | 《Refactoring (2nd Ed.)》Addison-Wesley | **《重构 改善既有代码的设计（第 2 版）》** 人民邮电出版社 2019 · 9787115508652 · 熊节 / 林从羽 译 |
| **2020-07** | Robert C. Martin | 《Clean Agile: Back to Basics》Prentice Hall | **《敏捷整洁之道：回归本源》** 人民邮电出版社 2020 · 9787115537157 |
| **2020-11** | Schwaber + Sutherland | 《Scrum Guide》latest 修订 | **中文版免费 PDF** · scrumguides.org/download |

---

## 6. Agile / AI-Native 转型术语（v1.4 引入 · 业界对标）

> 来源：2025 业界 AI-Native 转型研究综述（多源公开报告 / 顶级咨询 / 学术分析整合）
> AGF 设计独立但与「AI-Native 转型」业界研究思路高度重合 · 本节术语用于对标业界 + 解释 AGF 取舍

| 术语 | 解释 | 备注 |
|---|---|---|
| **AI-Native operating model** | 不是把 AI 工具粘在旧 Agile 流程，而是重新设计组织 / 角色 / 节奏适配 AI · 业界共识 | 与 AGF 14 角色重定义思路一致 |
| **3-5 人 pod**（业界又称 "1-pizza pod"）| AI-Native 团队规模 · 替代传统 8-10 人 two-pizza team · 含 1 lead architect + 1-2 senior dev + 1 QA/data | AGF 取舍不同（见对照表）|
| **Spec-driven development** | 用精确技术规约（spec）派工 · 替代模糊 user stories · AI agent 直接执行 spec 不需要二次澄清 | AGF PRD §4 AC + 6 段派单 schema 实现这点 |
| **Continuous planning** | 连续滚动规划 · 替代 quarterly / 2-week sprint | AGF feature 流（每 feature 独立迭代单元）等价 |
| **Agent-orchestrated workflow** | engineer 从"写每行代码" → "编排 agents"（orchestrator role）· PM 从"写文字 PRD" → "prototype in code" | AGF product-lead SendMessage 编排实现 |
| **Review bottleneck** | AI 让 coding 快 → review / 工作分配 / merge 变瓶颈 · "fix review BEFORE acceleration" | AGF 解法：code-reviewer 双 verdict + SIT Audit + 自动 quality gate |
| **3 层度量框架** | Output（velocity / quality / dev satisfaction）+ Economic（time-to-revenue / cost-per-pod）+ Resilience（mean time to resolve P0 · "fast code that breaks fast isn't fast"）| AGF v1.4 培训补引用 |
| **"70% 公司"反例** | 70% 公司部署 AI 工具但**完全没改角色** · 只 5-15% 产能提升 · vs 头部企业 5-7× | AGF 直接重定义 14 角色 = 业界领先实践 |
| **金融案例**（行业研究公开数据）| 重组织后实测：**51% code merges 增加 + 60× agent consumption** · 实现需 sprint redesign + role clarity | 引用为佐证 |
| **3-5 年转型 timeline**（诚实预期）| 不是营销话术的 12 个月 · enterprise 转型实际 3-5 年 | 业界共识 |

### AGF 与 AI-Native 业界研究 10 项对照

| AI-Native 价值点 | AGF 命中度 | 取舍备注 |
|---|---|---|
| 重定义角色（70% 公司不改）| ✅ **强命中** | 14 角色定义 + .claude/agents/*.md |
| Spec-driven 派单 | ✅ **强命中** | PRD §4 AC + 6 段 schema |
| Review bottleneck 先修 | ✅ **强命中** | 双 verdict + SIT Audit |
| Agent orchestration | ✅ **命中** | product-lead SendMessage 编排 |
| Living systems · model drift | ✅ **命中** | evals/ 季度漂移检测 |
| Data-centric · 数据 > 代码 | ✅ **命中** | F1 多模态雷达 + AC 量化 |
| 3-5 人小 pod | ⚠ **不同取舍** | AGF 14 同事 + worktree 异步 = 异步并行 ≈ 小 pod 效果 + 角色专业化 |
| PM 直接 prototype code | ❌ **不命中** | AGF PRD 仍是 markdown · 文字 spec 更可审 |
| QA merge into pod | ❌ **不命中** | AGF qa-engineer 独立 · 避免"既当裁判又当球员" |
| **3 层度量框架** | ❌ **缺** | v1.4 培训 §1 + §4 takeaway 补充引用 |

---

## 7. PPT 培训 deck 自有版式术语

| 术语 | 含义 | 出现 slide |
|---|---|---|
| **CONTENTS 主目录** | 第 1 张目录（菱形 5 行 · 01 高亮）| p-002 |
| **CONTENTS chapter divider** | 章节分隔 · 复用 CONTENTS 模板 · 高亮当前章节 | p-033 / p-096 / p-111 / p-123 |
| **chapter intro** | 章节扉页（大字 + 副标题）· 用 layout[4] 空白 | p-003 / p-018 / p-095 / p-120 |
| **section header** | 节标题 · v1.2 改大字版（避免 TEAM 图遮挡）· 5 章节差异化 emoji 🎯🛡🔁✅🧭 | p-033 / p-050 / p-067 / p-082 / p-111 |
| **prediction page** | 章首预测页 · "现在请你猜：X 选 A/B/C" · v1.1 引入 | p-034 / p-051 / p-068 / p-083 |
| **takeaway page** | 章末金句页 · "本章你已学会 3 件事" · v1.1 引入 | p-017 / p-031 / p-049 / p-064 / p-080 / p-092 / p-118 |
| **break page** | 休息过渡（咖啡 / 便当 / 倒计时）· 嵌入 drawio | p-032 / p-065 / p-094 |
| **Lab check-in** | Lab 33%/66% 进度提示 + 救火 box · v1.1 引入 | p-099 / p-103 |
| **footer chip** | 左下章节 chip（4px 色竖线 + 章节文字）+ 右下页码 · 跳过封面 + Thanks | 全 deck |
| **rotate4 / rotate5** | 卡片按索引轮换 4/5 主色（NAVY / CORAL / GOLD / GREEN / BLUE_ACCENT）避免单调 | 多张 |

---

## 维护说明

- **基线来源**：`docs/product-workflow.md §4` 团队级通用词典 + 本文 6 类培训扩展
- **更新触发**：deck 新增章节 / 新增工具 / 新版本（v1.4 / v1.5 ...）必同步本文
- **维护人**：`content-writer`
- **路径约定**：术语首次出现的 slide 编号（如 p-014）用最新 v1.3 编号 · 后续版本编号变动需更新
