核心用法
sofagent 是一套 Agent 行为约束与任务编排框架,采用「三层加载链」设计:
1. L1 宪法层(skill 自动注入):4 条安全底线(隐私保护、危险操作确认、有害内容拒绝、AI 身份标注)+ 6 则铁律(主动回应、错误显性、不确定即问、目标驱动、全局视角、成本意识)
2. L2 反思层(think.md):Agent 主动读取,记录上次任务踩过的坑
3. L3 企业层(fde.md):组织级最高优先级规范
触发场景包括:Agent 行为失控、任务需拆解、多文件修改、高风险操作、历史任务复现等。系统通过「复杂度预判」自动分级(🟢🟡🔴),复杂任务激活编排引擎。
显著优点
- 约束机制前置:不依赖模型自我克制,通过强制加载链注入行为准则
- 错误沉淀复用:think.md 机制让教训跨会话保留,避免重复踩坑
- 分层治理清晰:个人反思 < 企业规范 < 安全底线,优先级明确
- 静默自检闸门:回复前自动过滤内部标记,防止技术细节泄漏
潜在局限
- 冷启动摩擦:首次使用需创建 think.md,加载链提醒可能让用户困惑
- 技术术语密集:「反向锚点」「加载链」「闸门」等概念增加认知负担
- 过度约束风险:简单任务可能被套用复杂编排流程,反而降低效率
- 依赖文件系统:跨设备/容器环境需同步
.sofagent目录
适合人群
- 高频使用 Agent 进行代码生成、文件操作的开发者
- 团队协作场景下需要统一 Agent 行为规范的技术主管
- 曾因 Agent「自由发挥」导致代码回滚或安全事故的用户
常规风险
- 规范僵化:铁律过度执行可能抑制合理创造性
- 日志累积:task/logs 长期不清理可能暴露敏感路径信息
- 层间冲突:L3 企业规范若与 L1 底线矛盾,实际执行顺序依赖实现细节