痛点拆解：不是模型「变笨」，而是系统提示里根本没有可执行清单
痛点 1：能力口述化。运维把「怎么发版、怎么查日志」写在群公告里，模型在会话内看不到版本化清单，于是每一轮都重新发明流程，耗时且易与真实 runbook 冲突。
痛点 2：长对话漂移。没有结构化 CONTEXT 时，后续轮次会稀释早期约束；代理看似「忘记」禁止操作，实为上下文窗口与摘要策略下的信息丢失。
痛点 3：改 JSON 不重启。Skills 与部分插件路径在运行期缓存；只改磁盘文件不冷重启网关，会与 MCP 子进程残留叠加，表现为「配置写了但工具列表不变」。
痛点 4：通道无响应误判为模型问题。实际卡在 pairing、webhook 或代理层；若跳过 网关分层排查去改 Skills，只会南辕北辙。
痛点 5：Skills 与权限混为一谈。Skills 描述意图与步骤；workspaceAccess 与 shell 画像决定能否真的写盘。缺一层都会出现「说得头头是道但工具拒绝」或「工具过强但描述缺失」。
Skills 与结构化 CONTEXT：和纯最小权限文互补的两块拼图
最小权限回答「允许触碰的磁盘边界」；Skills 回答「在边界内推荐的操作序列与术语」。CONTEXT 文件则提供稳定短约束：项目名、环境别名、审批入口、常用命令模板，避免把十万字手册塞进 system 提示。
发现机制应可审计：技能目录、命名规范、与发布分支的对应关系要写进内部文档；变更走评审，与 反向代理与 TLS 配置同级对待。
与 sessions_spawn 与 allowAgents 同用时，Skills 里应写明「何时才允许 spawn」，否则并发子代理会放大漂移。
需要上网检索时，把 web_search 提供方与出站边界写进同一运维表，避免 Skills 描述与网络策略打架。
可量化基线：用五条指标判断「上下文工程」是否生效
统计每百轮对话中「重复询问已写在 CONTEXT 的字段」次数，目标逐月下降。记录 Skills 调用成功率与失败原因标签：未发现、参数不全、权限拒绝、通道错误应分开。
把冷重启次数与配置变更工单绑定；无工单却频繁重启往往意味着缓存或子进程泄漏。监控网关启动到首次成功回复的耗时，异常上升常与技能扫描路径过大相关。
为高危操作保留 HITL 命中率与人工驳回率，Skills 应引用相同工单编号规则。
决策矩阵：仅靠 system 提示、仅 Skills、或 Skills+CONTEXT+权限三联
| 模式 | 适用 | 收益 | 风险 |
|---|---|---|---|
| 超长 system 提示 | 个人试用 | 写得快 | 难维护、易漂移、难审计 |
| 仅 Skills 无 CONTEXT | 工具多、流程少 | 可发现工具 | 边界与术语仍分散 |
| Skills + CONTEXT | 团队生产 | 可版本化、可评审 | 需规定目录与命名 |
| 三联 + doctor 阶梯 | 远程 Mac 7×24 | 排障可复现 | 运维表更厚 |
选定一行作为默认，把例外场景记在 runbook，而不是让每个工程师私藏一份「我的提示词」。
实操步骤与配置片段（字段名随版本演进，仅示意骨架）
{
"workspaceAccess": { "root": "/var/openclaw/work/acme" },
"skills": {
"searchPaths": ["/var/openclaw/skills/team", "/var/openclaw/skills/shared"],
"manifest": "/var/openclaw/skills/manifest.json"
},
"contextFiles": [
"/var/openclaw/context/PROJECT.md",
"/var/openclaw/context/BOUNDARIES.md"
]
}
步骤一 在仓库或配置库中定义技能目录与 CONTEXT 模板。步骤二 在测试网关加载后执行 openclaw doctor，对照 运维文。步骤三 完整冷重启并验证工具列表与技能元数据一致。步骤四 用合成对话探测「应引用 Skills」与「应拒绝越权路径」两类用例。步骤五 将工作区目录纳入与构建产物相同的 rsync／SFTP 快照策略，减少多机漂移。
强相关 CTA 与阅读顺序
建议顺序：网关 doctor → MCP 冷重启 → 本文 Skills/CONTEXT → workspaceAccess → web_search → HITL → 反向代理 → 首页 了解托管节点。
把「技能版本、CONTEXT 哈希、网关镜像版本」写进同一发布注释，回滚时才能三元对齐。
FAQ 与为什么用 SFTPMAC 稳定远程 Mac 工作区
Skills 能替代代码评审吗？
不能。Skills 是运行期指南，敏感逻辑仍应在仓库与流水线里受控。
多台网关如何同步 Skills？
用快照化目录与固定标签发布；避免每台机器手工 scp 不同版本。
总结：Skills 与 CONTEXT 把「代理能做什么」从聊天里抽出来，变成可发现、可评审、可与 doctor 对齐的资产。
局限：自建远程 Mac 需自己维护磁盘、权限与同步节奏；若希望Apple 原生环境 + 可预期的 SFTP/rsync 工作区交付，减少手工拷贝技能树与上下文漂移，SFTPMAC 托管远程 Mac 让团队把精力放在技能内容与网关策略，而不是反复对齐多台机器上的目录树。
稳定工作区目录与网关配置一并版本化，托管环境更易做到技能与 CONTEXT 的可重复发布。