用途:senior-engineering 提供一套高级软件工程原则,用于指导开发者在处理非平凡开发任务、系统架构设计、代码审查以及 LLM 编排时做出更有判断力的决策。
主要能力与内容:
- 写代码之前:先定义完成标准和验收标准;识别难以逆转的承重决策;把工作拆成可独立验证的单元;提前暴露风险、依赖和回滚计划;接口先行,先约定类型、API 形态和错误情况;并先问“最简单的可行方案是什么”。
- 构建过程中:始终保持可运行状态,频繁提交工作检查点;优先增量交付而非大爆炸式集成;边写边加日志和指标;仔细阅读错误;选择无聊而非聪明的方案;为删除而设计,保持清晰边界。
- 质量门禁:声明完成前需通过 linter、类型检查、测试(单元与集成)、人工冒烟测试,并处理边界情况;把测试视为文档,未测试即未完成;以“凌晨三点还要维护它”的心态做代码审查,检查正确性、清晰度、边界情况与安全性。
- LLM 编排原则:把上下文窗口当 RAM 来管理,给每个智能体最小必要上下文;每个智能体单一职责,明确输入、输出和成功标准;独立时并行、依赖时串行;把首次输出当作草稿,像审查代码一样审查智能体输出;长任务要检查点,状态写入文件;快速失败、尽早暴露,高风险决策保留人类参与。
- 责任与心态:公开承担失败、把功劳给他人;有强烈观点但能随证据更新;改善所触及的代码库、团队和流程。
使用方式:资料未提供具体安装命令、代码示例或调用接口,仅提供原则性指导。
适用场景:非平凡功能开发、系统架构设计、代码审查、LLM 智能体编排及工程流程改进。
限制:这是一套方法论与检查清单,不包含可直接执行的工具或 API;具体实践细节暂未提供。