Skip to content

写作风格规范(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万)