(Experiment) Colocating agent instructions with eng docs
a year ago
- #AI agents
- #documentation
- #software development
- 作者尝试将AI智能体指令嵌入内部工程文档中，而非单独维护智能体文档。
- AI智能体指令以注释形式嵌入文档文件，这些注释对人类读者不可见，但对智能体可读。
- 实验内容包括：利用嵌入指令将代码示例转换为可构建、可测试的实例。
- Gemini CLI成功遵循了指令流程，包括先创建失败测试再修复它。
- 实验过程中发现了指令中的错误，证实了智能体在严格遵循指令。
- 作者指出这是非正式实验，建议同时保留智能体文档和针对性指令可能效果最佳。
- 整个流程包括更新Bazel、GN和CMake的构建文件，并验证文档构建仍可正常工作。