写作风格规范(fde-course)
所有子代理写课程内容时必须遵守。
文件与标题
- 文件名:
NN-MM-节名.md(NN=章号两位,MM=节号两位),如01-01-FDE是什么.md - 每个文件开头:
## 第一章 章名 ### 1.1 节名 > *承前:……(斜体,100-200字,衔接上一节/章,或本章开篇引入)* - 小节用
#### 1.1.1 标题,每个三级小节 500-1000 字。
文风(参照 ~/.hermes/ai-agent-course/01-基础认知/01-01-大模型全景图谱.md)
- 口语化、有画面感的比喻(如"FDE 像私人医生,普通工程师像药厂")
- 先讲"为什么"再讲"怎么做",用沙盘剧情(青禾优选)做贯穿例子
- 数字与事实要具体("ChatGPT 两个月月活过亿"级别),不得编造
- ASCII 图 / markdown 表格适度使用(每节 1-3 个),图要有讲解文字
固定收尾结构
每个文件(=每一节)结尾:
#### N.M.k 要点总结
- 3-6 条 bullet
## 参考资料
- [标题](真实URL) — 一句话说明- 参考链接必须真实:写之前用 web_search 核实,找不到的不写链接只写出处名称
- 至少 3 个参考链接,优先官方/一手来源(公司博客、官方新闻稿、论文、官方文档)
事实核查红线
- 公司案例(Palantir/Airbus/OpenAI/Morgan Stanley/Klarna/Anthropic/神策等):数字须与公开报道一致,注明"据XX披露"
- 不确定的事件/数字:写"据公开报道"或删掉,绝不编造
- 大纲 PDF 中的沙盘剧情(青禾优选)是虚构教学场景,可自由展开,但不得与现实公司混淆
- 大纲中已给的案例数字(如 OpenAI 40 亿美元 Deployment Company、AIG 审查周期压缩 5 倍、Klarna 首月 230 万次对话、Morgan Stanley 98% 理财顾问使用)可以沿用并在参考资料中给出链接
每节长度
3000-5000 中文字(约 15-20 分钟阅读)。
沙盘贯穿设定(写案例时保持一致)
- 客户:青禾优选(虚构连锁零售企业,会员制超市,门店+线上)
- 你:标准 Agent 产品厂商的 FDE
- 产品:标准 Agent 底座(模型调用/会话/工具注册/日志/trace/评估接口已有)
- 干系人:增长副总裁(发起人)、数字化总监(W7 空降接管)、IT 负责人、一线运营经理、门店店长、财务经理
- 指标主线:会员复购率(北极星)
- 数据坑:会员标签塞备注、新旧系统双轨会员 ID、三个部门三个会员数(80万/120万/76万)