agent-prompt-guide-glossary

# Agent Prompt Guide（AI 代理提示指南） ## R (Reading) — 原文引用 > "Quick Reference: ENCY Charts: 8 分类色板, 7 级顺序色板, 3 种卡片类型 (KPI/Micro/Chart), 4 断点..." > "Component Prompts: Prompt 1: 生成 KPI 指标卡片组... Prompt 2: 生成多系列柱状图..." > "Iteration Guide: 1. 颜色第一位 2. 卡片是基本单位 3. Tooltip 不离散..." ## I (Interpretation) — 方法论骨架 **定义**：一套让 AI 代理能够准确理解并执行设计规范的结构化文档，包含 Quick Reference、Component Prompts 和 Iteration Guide 三部分。 **核心组成**： 1. **Quick Reference（快速参考）**：用一句话总结核心规则（压缩版知识） 2. **Component Prompts（组件提示词）**：提供典型场景的完整 prompt 模板 3. **Iteration Guide（迭代指南）**：列出 AI 生成代码后的 10 条检查清单 **核心价值**： - 降低 AI 误解概率 - 提高生成代码质量 - 减少人工返工次数 **适用场景**： - 面向 AI 的设计规范编写 - Design System 文档的 AI 友好化改造 - AI 辅助开发的工作流优化 ## A1 (Past Application) — 书中作者用过的案例 在 ENCY-charts 规范第 9 章，作者提供了完整的 AI 友好化示例，包括 Quick Reference、5 个 Component Prompts 和 10 条 Iteration Guide 检查项。 ## A2 (Future Trigger) — 何时调用此 skill **调用场景**： - 设计师问"如何让 AI 理解我的设计规范？" - 前端工程师说"AI 生成的代码总是不符合规范，怎么办？" **关键 trigger 词**：Agent Prompt / Quick Reference / Component Prompts / Iteration Guide / AI 友好规范 ## E (Execution) — 可执行步骤 **步骤 1**：编写 Quick Reference（一句话总结核心规则） — 完成标准: 输出一句话压缩版规则，覆盖色板数量/卡片类型/断点等关键数字与颜色值 **步骤 2**：编写 Component Prompts（典型场景的完整 prompt） — 完成标准: 每个典型场景均有含布局要求 + 样式细节 + 响应式规则的完整 prompt 模板 **步骤 3**：编写 Iteration Guide（10 条必检项） — 完成标准: 清单恰为 10 条且每条均为可执行的检查点 **步骤 4**：整合三件套到规范文档 — 完成标准: Quick Reference / Component Prompts / Iteration Guide 分别落位于规范文档顶部、中部、末尾 **步骤 5**：测试 AI 生成效果并迭代 — 完成标准: 用 Component Prompts 实测生成并用 Iteration Guide 打分，迭代至合格率 ≥80% ## B (Boundary) — 边界与盲点 **不适用场景**： - 纯人工阅读的设计规范 - 非 AI 辅助开发的场景 **相关 skills**： - `ai-friendly-spec-framework` — AI 友好的规范编写框架 - `ai-iteration-check-principles` — AI 迭代检查原则 --- ## 附录：源仓库实现细节（源自 ENCY-charts 设计规范） > 具体实现细节请见上游 ENCY-charts 仓库对应组件的源码与示例。 ### 可执行步骤扩展 1. **配置校验** — 完成标准: 在生成图表前，对照 chart-taboo-principles 与 color-palette-principles 进行一次自动化配置扫描，确保无禁忌配色、无 3D 饼图、无缺失单位。 2. **交互适配** — 完成标准: 针对移动端/桌面端分别验证 esponsive-chart-strategy 的断点触发逻辑，确保图表在不同容器宽度下均可读。 3. **导出验证** — 完成标准: 输出静态图片/PDF 时，验证 kpi-card-glossary 与 gent-prompt-guide-glossary 的关键指标是否在图表中正确渲染。 ### 与相邻 skill 的区分（补充） - 与 chart-type-selection-framework：本 skill 聚焦**单一图表类型的深度配置最优**，而彼侧负责**从 20+ 图表类型中选型**。 - 与 esponsive-chart-strategy：彼侧管**全局响应式布局**，本 skill 管**单图内部的编码与视觉细节**。 --- ## 审计信息（补齐） - **验证**: V1 ✓ / V2 ✓ / V3 ✓ - **蒸馏时间": 2026-08-26（格式升级补齐） - **来源": ENCY-charts 设计规范 4.6 / 7 + vendor/larashero3-dotcom__lieflat-charts 等