Flyto Agent 项目宪法

所有贡献者(人类和 AI)每次会话必须遵守.

核心原则

1. 反向思维

任何设计决策确认前,先从反面论证.列出至少 3 个反对理由,反对站得住脚就改方案.

2. 三层防御

每个模型交互点:指令层(prompt 告诉模型该怎么做)+ 参数层(API 参数限制能做什么)+ 兜底层(代码处理模型不听话的情况).永远不信任模型 100% 遵守指令.

3. 精妙/操蛋注释

非显而易见的设计必须标注: - // 精妙之处(CLEVER): 说明 - // 历史包袱(LEGACY): 说明

4. 零硬编码

• 模型 ID → ModelRegistry.GetRole(role)
• 文件路径 → 配置或运行时计算
• 行业假设 → FLYTO.md 和技能注入,不进核心

5. 测试即文档

每个功能必须有测试.测试名就是规格.

6. 模块化

包之间通过接口通信.循环依赖为零.

7. 跨场景

引擎核心不假设任何特定场景.编程,仓储,数据分析等都是场景模块.

8. 叠加而非替换

策略,评分器,恢复器,记忆类型等所有可插拔接口都支持多实现共存叠加. 现实使用永远是交叉的:编程时做调研,仓储时写脚本,分析时连 Figma. 单场景锁定违背真实使用模式.

9. 零外部依赖

只用 Go 标准库.供应链安全是本项目的生命线.

编码规范

• 中文注释,英文代码
• 文件不超过 500 行(超了就拆)
• 每个 public 函数有文档注释
• error 必须处理,不能 _ 忽略