sofagent / rules

---
description: sofagent 约束层加载（薄挂载——规范资产唯一来源是 SKILL/，本文件不含规则内容）
globs:
alwaysApply: true
---

# sofagent · Cursor 适配（薄挂载）

> 本文件是**挂载点**不是规范副本——四层加载链的规范资产唯一来源是 sofagent 的 `SKILL/` 目录（单一真相源，ECC DRY adapter 模式）。规则内容更新只发生在 SKILL/，本文件永不复制它们。

## 会话开始时按序加载（四层加载链）

一、读取已安装的 SKILL.md 作为系统约束（L1 硬约束）：

```
~/.sofagent/skills/sofagent/SKILL.md
```

（若用 `bash install.sh --platform cursor` 安装，则为 `~/.cursor/skills/sofagent/SKILL.md`。）

二、读取用户工作规则（L2）：`~/.sofagent/skills/sofagent/fde.md`

三、读取反思区（L3）：`~/.sofagent/skills/sofagent/think.md`

四、知识库（L4）：`~/.sofagent/skills/sofagent/knowledge/` 目录，按任务关键词检索加载。

## 审计强制（平台无关）

约束是建议性的，审计是强制性的——提交前审计走 **git hook**（`sofagent-audit --install-hook`），与宿主平台无关：25 条 git diff 规则 + HMAC 链审计在 Cursor 下同样生效。

## 连接 MCP Server

Cursor 的 MCP 配置指向 sofagent MCP Server（stdio）：

```json
{ "mcpServers": { "sofagent": { "command": "sofagent-mcp" } } }
```

103 个 tool（`run_audit` / `check_acceptance` / `snapshot_restore` / `device_register` 等）经 MCP 协议面暴露——适配器只依赖 @public API 子集，@internal 破坏性变更不影响本挂载。