阅读指南

定义 Hermes Engineering 的目标、原则、术语、阅读方式和维护规则,让知识库长期保持一致。

本文用于沉淀「阅读指南」相关的知识、方法和交付标准。它服务于工程团队的日常设计、评审、交付、复盘和 AI Agent 协作,不追求一次性覆盖所有细节,而追求可维护、可扩展、可继续补充。

适用场景

当团队需要讨论、评审或执行「阅读指南」相关工作时,可以先从本文建立共同语境。它适合用于方案准备、评审前自检、经验沉淀、模板编写和新人学习。

核心问题

问题说明
目标这项工作希望改善什么工程结果
边界哪些内容属于当前主题,哪些不属于
证据需要哪些代码、指标、日志、案例或用户反馈支撑判断
取舍引入了哪些成本、风险和维护责任
验证如何判断方案、模板或实践真正有效

建设要点

  1. 先描述场景和约束,再给出原则或做法。
  2. 把强判断绑定到证据、案例或可验证的观察。
  3. 对稳定流程沉淀模板,对重复风险沉淀检查清单。
  4. 对高风险经验补充案例,保留背景、决策和后果。
  5. 对适合自动化的任务沉淀为 Prompt、Skill 或工具规则。
  6. 定期复审内容,删除过期假设,补充新的失败模式。

维护建议

这篇文章是 第零篇:知识库元信息 的第 5 个主题。后续补充时,应优先加入真实项目观察、评审问题、事故复盘、指标变化或可复制模板,避免只追加抽象概念。