🌐 English abridged version → | 🇨🇳 中文完整版
sofa + agent = 沙发特工——希望有一天，我们能躺在沙发上，Agent 就把活干完了。
企业上 AI，先上缰绳再上路。 中小企业和 OPC 的 FDE 工具包——约束底座管行为，审计引擎盯结果。不用请昂贵顾问，不用养 AI 团队，自己就能搭建 AI 节点。
License：MIT。代码、文档、模板——随便用，保留版权声明就行。
给 AI Agent 装一个提交时审计官——不看 Agent 怎么说，只看 git diff 怎么变。11 条审计规则扫描每次代码变更，自动判定违规、生成反思。中小企业装完就能用，不用请顾问、不用写 prompt。
成熟度说明：作者自用一个多月，审计引擎日常稳定（406 tests 全绿，5/5 靶向违规全部检出）。编排引擎能跑但未到「装上就能用」。如果你试了，告诉我什么场景、什么问题。
| 组件 | 做什么 | 怎么跑 |
|---|---|---|
| 审计引擎 | git diff → 11 条规则 → exit code | git pre-commit hook，不挑 Agent、不挑平台 |
| 约束底座 | MD 规则注入 Agent 上下文 | install.sh 装完自动加载 |
| 编排引擎（实验性） | FDE 拆任务 → workflow → 部署 | OpenClaw + ao compose |
审计引擎零 Agent 依赖——看的是已发生的 git diff。约束底座和审计引擎不需要 OpenClaw。编排引擎才需要。
需要 bash 4+ 和 git。OpenClaw 跑复杂任务另需 Node.js ≥18 + npm（详见 HANDBOOK）。 📋 安装脚本做了什么？看 SECURITY.md · install.sh 行为说明。
平台支持：macOS / Linux 全功能。Windows 为实验性（PowerShell 脚本功能覆盖不全，核心审计引擎可用但部分检查项缺失，详见 LIMITATIONS）。
只想加 Agent 行为约束？把 4 底线 + 6 铁律复制进你的 Agent 设置就行，不需要装整个 sofagent。
# ClawHub / SkillHub
clawhub skill install KongFangXun/sofagent
skillhub install sofagent
# 或从仓库手动装
git clone https://github.com/KongFangXun/sofagent.git
bash sofagent/scripts/install.shgit clone https://github.com/KongFangXun/sofagent.git
cd sofagent && bash sofagent/scripts/install.sh有 ClawHub CLI 也可以：
clawhub skill install KongFangXun/sofagent
# Skill 用户（通过 install.sh 安装）
bash sofagent/scripts/verify.sh
# CLI 用户（通过 npm 安装）
npm install -g @sofagent/audit && sofagent-verify两种方式等效——verify 检查全 pass 即安装就绪。
打开你的 Agent 客户端，试一个需要多步拆解的任务：
/goal 帮我分析这个项目的代码质量，生成改进建议报告
跑完看结果：
ls .sofagent/task/logs/ # 按年-月分目录的执行日志
cat .sofagent/think.md # Agent 自动提炼的反思摘要OpenClaw 上全自动；其他平台部分能力需手动触发。详见 LIMITATIONS.md。
跑通了？ HANDBOOK 教你怎么调，DEVELOPMENT 讲内部怎么跑。
两层架构——地基常驻，引擎按需点火。
梳理企业工作流 → 识别 AI 节点
├── 🔄 自动执行 → 闲置设备搭建 AI 节点
└── ⚡ 强化岗位 → AI 领航员辅助人
审计引擎（每次提交） 编排引擎（FDE 进场 + 定期重测）
│ │
├─ git diff 扫描 ├─ FDE 进场：一次性生成 workflow.yaml
├─ 规则检查 A1-A11 │ └─ 智能拆解 → 生成编排方案
│ │
│ ├─ 生产运行：AI 节点按 workflow 执行
│ │ ├─ 🔄 自动执行
│ │ └─ ⚡ AI 领航员辅助
│ │
│ ├─ 定期 A/B 重测（每 N 个 session）
│ │ ├─ 编排引擎重出一版新方案
│ │ └─ sofagent-orchestrate-compare 对比
│ │ ├─ 新方案胜出 → promote
│ │ └─ 旧方案更好 → 保留
│ │
└────────────── think.md ─────────────────────┘
（审计引擎写 / 编排引擎读 / A/B 结果写入 orchestrator/）
| 引擎 | 做什么 | 依赖 Agent | 触发方式 |
|---|---|---|---|
| 审计引擎 | git diff → 规则检查 → 自动生成 think.md | ❌ | 每次 git commit |
| 编排引擎 | FDE 进场一次性生成 workflow + 定期 A/B 重优化 | ✅ | FDE 部署时 / 定时触发 |
约束自己定，模板和 Skills 从社区取。已知局限见 LIMITATIONS.md。
Forward Deployed Engineer（前向部署工程师）进驻企业后，做三件事：梳理工作流 → 识别 AI 可切入节点 → 部署 Agent。sofagent 是部署后约束 Agent 行为的那一层——Agent 改了代码你能看到，跳过验证审计能发现，think.md 持续沉淀反思。
中小企业不需要请顾问——自己就能做 FDE。 装上 FDE 工具包，Agent 带着你按四阶段十二步走完（进场→挖掘→交付→检查离场），然后找一台闲置设备（旧电脑、服务器、Nas 都行），把 sofagent 装上去——约束底座管着 Agent 行为，审计引擎盯着代码变更。之上是你梳理出来的一个个 AI 节点：🔄 自动执行的跑在上面，⚡ 辅助员工的在你同事手边。从头到尾，不需要一个外部顾问。
企业搭 AI 中台，真正难的是部署后的事——谁盯着 Agent 不乱改代码、谁保证产出质量、谁把经验留下来。sofagent 离场后，企业留下三样东西：
| 产物 | 说明 |
|---|---|
| 一份谁都能看懂的部署方案 | 从现状到如何部署，任何人翻一遍都能懂 |
| 一套在跑的 AI 节点 | 自动执行 + 辅助岗位的所有节点都在跑，按要求定时出审计报告 |
| 一个会自己生长的知识库 | 不用人来维护——AI 干的活自己记录自己查，新节点启动时自动检索学习经验 |
sofagent 不做 AI 中台——做 AI 中台里约束 Agent 行为和审计的那一层。
- 梳理工作流——逐个岗位、逐段流程画出来
- 识别 AI 节点——标注哪些可以自动化（🔄）、哪些强化岗位（⚡）
- 装上工具包——找一台闲置设备，
install.sh一键部署 sofagent - 自动跑业务——AI 节点自己干活、自己汇报、自己复盘
完整四阶段十二步部署流程见 FDE/FDE.md。FDE 可直接装 sofagent-fde Skill——Agent 自动走流程，不用手动记步骤。
不论是中小企业（SMB）还是一人公司（OPC），让 AI 节点接管重复任务，即使只有一人也能跑出以一当百的产出。
| 你想了解 | 看哪里 |
|---|---|
| 怎么装、怎么用、什么是铁律 | HANDBOOK.md |
| 为什么这么设计、已知局限 | ARCHITECTURE.md |
| Skill 怎么协同、编排怎么跑 | DEVELOPMENT.md |
| 企业落地三阶段指南 | docs/guides/team-deploy.md |
| 实际效果数据 | evidence.md |
| 平台能力与已知局限 | LIMITATIONS.md |
| 版本路线图 | ROADMAP.md |
| 版本历史 | CHANGELOG.md |
| 项目反思 | THINK.md |
| 贡献指南 | CONTRIBUTING.md |
| GitHub Action 审计集成 | docs/guides/github-action.md |
| FDE 工具包 | FDE/ |
| 安全声明 | SECURITY.md |
| 社区与数据 | COMMUNITY.md |
| 行为准则 | CODE_OF_CONDUCT.md |
| 致谢 | THANKS.md |
欢迎提 Issue 和 PR，尤其挑刺的那种。详见 CONTRIBUTING.md。我们在寻找 Co-maintainer——熟悉 bash 兼容性、OpenClaw hook、安全审计或英文文档的人。
sofagent 站在 8 个开源项目和 7 篇文章/社区的肩膀上。→ 完整致谢
我叫孔放勋，一个只懂点前端代码的产品经理。
项目维护模型声明：sofagent 的代码由 AI 模型（DeepSeek V4 Pro / GLM-5.2）生成，作者做产品决策和终审。这意味着 bug 修复依赖 AI 模型可用性——如果模型停止服务，项目失去修复能力。这是比单人维护更深层的结构性风险。
每个版本经独立模型评审，详见 CHANGELOG。我们在寻找 Co-maintainer。