sn-proactive-agent

1# Proactive Agent
2 
3本 Skill 是 Agent 的操作说明，运行代码通过独立的 Python 安装包获取。
4服务整理多轮对话中的项目进展，发现值得推进的事情时在 Web 工作台提出建议；
5用户接受后，由对应 Connector 交回原 Session 继续执行。
6 
7## 按任务读取说明
8 
9- 询问原理、状态或已有记录时，只做相关的只读检查，不因加载 Skill 就安装、改配置或启动服务。
10- 用户要求安装、启动、升级或卸载时，先读 [通用流程](references/install/overview.md)，再按实际运行环境读取一份系统说明。
11- 配置对话接入时，只读取当前 Harness 对应的 Connector 说明，不加载其他平台的资料。
12 
13| 条件 | 读取文件 |
14|---|---|
15| 安装、运行与维护服务 | [install/overview.md](references/install/overview.md) |
16| macOS | [install/macos.md](references/install/macos.md) |
17| Windows PowerShell 或 WSL | [install/windows.md](references/install/windows.md) |
18| Hermes 接入 | [connectors/hermes.md](references/connectors/hermes.md) |
19| OpenClaw 接入 | [connectors/openclaw.md](references/connectors/openclaw.md) |
20 
21`install/` 负责操作系统、依赖和服务生命周期；`connectors/` 负责 Harness
22配置、对话采集与获批续跑。支持 Hermes 和 OpenClaw，分别按对应说明安装，不能混用命令。
23目标运行包版本为 `0.1.4`，通过 GitHub Release 下载并校验；发布状态检查见通用流程。
24Hermes 使用 Web-only 续跑桥，OpenClaw 使用 Gateway 插件。当前 Core 的语义整理与判断仍依赖
25已配置模型的 Hermes CLI，即使只监听 OpenClaw，也需准备这个后台工作器。
26安装包验收不等于真实接入验收。
27Windows 说明是安装参考，不代表完整接入已验收。
28 
29## 命名与命令
30 
31- 本 Skill 的目录和文件名使用英文；除标准入口 `SKILL.md` 外，使用小写与连字符。
32- 示例命令、参数、变量名和命令块中的注释统一使用英文，中文解释放在命令块外。
33- 保留程序原有的命令名称，不翻译参数。用户真实路径即使含中文，也应按原名正确引用，不为符合示例命名而改动用户文件。
34 
35## 运行边界
36 
37- 安装 Skill 与安装运行包是两件事；`pipx` 不会把 Skill 安装到 Harness，也不会自动启动服务。
38- 区分运行包、安装文件、目标窗口在线与真实回流检查。`doctor --session-id` 读取指定窗口的实际证据，不主动发消息；`unverified` 不等于通过，旧包缺少检查能力也不能视为接入成功。
39- 当前使用 Web 展示建议、接受或忽略、项目进展与日报；服务按 `serve --web-only` 启动，不启用终端内的重复建议界面。
40…