Skip to content
Productivity
Skill

/sn-proactive-agent

安装、启动和使用 Proactive Agent,记录项目进展并在合适时机提醒下一步。

From plugin
sensenova-skills
6.1k84 skills

Claude Code

$ npx -y skills add OpenSenseNova/SenseNova-Skills --skill sn-proactive-agent --agent claude-code

SKILL.md

sn-proactive-agent.SKILL.md
name: sn-proactive-agent
description: 安装、启动和使用 Proactive Agent,记录项目进展并在合适时机提醒下一步。

Proactive Agent

本 Skill 是 Agent 的操作说明,运行代码通过独立的 Python 安装包获取。 服务整理多轮对话中的项目进展,发现值得推进的事情时在 Web 工作台提出建议; 用户接受后,由对应 Connector 交回原 Session 继续执行。

按任务读取说明

  • 询问原理、状态或已有记录时,只做相关的只读检查,不因加载 Skill 就安装、改配置或启动服务。
  • 用户要求安装、启动、升级或卸载时,先读 [通用流程](references/install/overview.md),再按实际运行环境读取一份系统说明。
  • 配置对话接入时,只读取当前 Harness 对应的 Connector 说明,不加载其他平台的资料。

| 条件 | 读取文件 | |---|---| | 安装、运行与维护服务 | [install/overview.md](references/install/overview.md) | | macOS | [install/macos.md](references/install/macos.md) | | Windows PowerShell 或 WSL | [install/windows.md](references/install/windows.md) | | Hermes 接入 | [connectors/hermes.md](references/connectors/hermes.md) | | OpenClaw 接入 | [connectors/openclaw.md](references/connectors/openclaw.md) |

`install/` 负责操作系统、依赖和服务生命周期;`connectors/` 负责 Harness 配置、对话采集与获批续跑。支持 Hermes 和 OpenClaw,分别按对应说明安装,不能混用命令。 目标运行包版本为 `0.1.4`,通过 GitHub Release 下载并校验;发布状态检查见通用流程。 Hermes 使用 Web-only 续跑桥,OpenClaw 使用 Gateway 插件。当前 Core 的语义整理与判断仍依赖 已配置模型的 Hermes CLI,即使只监听 OpenClaw,也需准备这个后台工作器。 安装包验收不等于真实接入验收。 Windows 说明是安装参考,不代表完整接入已验收。

命名与命令

  • 本 Skill 的目录和文件名使用英文;除标准入口 `SKILL.md` 外,使用小写与连字符。
  • 示例命令、参数、变量名和命令块中的注释统一使用英文,中文解释放在命令块外。
  • 保留程序原有的命令名称,不翻译参数。用户真实路径即使含中文,也应按原名正确引用,不为符合示例命名而改动用户文件。

运行边界

  • 安装 Skill 与安装运行包是两件事;`pipx` 不会把 Skill 安装到 Harness,也不会自动启动服务。
  • 区分运行包、安装文件、目标窗口在线与真实回流检查。`doctor --session-id` 读取指定窗口的实际证据,不主动发消息;`unverified` 不等于通过,旧包缺少检查能力也不能视为接入成功。
  • 当前使用 Web 展示建议、接受或忽略、项目进展与日报;服务按 `serve --web-only` 启动,不启用终端内的重复建议界面。
  • Connector 自动上报完整 QA 和新一轮输入信号;Core 负责归属、状态更新和提醒判断。
  • 建议不是授权。用户接受后,只通过 Connector 续跑原 Session;读取 Skill 的 Agent 不应另外提交同一动作,造成重复执行。
  • 执行结果由 Connector 带 `source_suggestion_id` 回流;本轮更新状态,不连续生成下一条建议。
  • 不代替后台服务直接编辑 `project.md`、`item.md`、`events.md` 或 `runtime.jsonl`。
  • 不读取、打印或复制 API Key、`.env` 或其他凭据。

查看记录

数据默认放在当前用户 Home 下的 `.sn-proactive-agent/`,不是安装包或源码目录。 可用 `--data-root` 或 `SN_PROACTIVE_AGENT_DATA_ROOT` 覆盖。首次有明确长期目标的 完整对话后,服务按归属创建 Project / Item,用户不需要手工建项目;一次性问题可仅记录在运行日志中。

升级用户若已有 `.proactive-memory/` 且新目录不存在,自动沿用旧目录,不搬迁或合并。 旧 `PROACTIVE_MEMORY_*` 环境变量可继续读取,同名的新 `SN_PROACTIVE_AGENT_*` 设置优先。

以下路径相对于数据根目录:

  • `projects/<project-id>/project.md`:项目概述和 Item 索引。
  • `projects/<project-id>/items/<item-id>/item.md`:事项最新状态。
  • `projects/<project-id>/items/<item-id>/events.md`:相关 QA 与状态变化,用于溯源。
  • `runtime.jsonl`:对话接收、归属、提醒或静默原因、用户决定、执行结果与日报记录,用于恢复、去重和审计。

Web 读取这些记录的 JSON 展示结果,不直接修改源文件。建议区域保持简短; 详细判断依据保存在运行记录中,按需检查。

Read more
@opensensenova
Ships withsensenova-skills

The SenseNova model family plugs directly into agent runtimes such as OpenClaw and hermes-agent, with the skills in this repository extending the models with concrete, end-to-end office capabilities.

Stars on GitHub

Momentum

stars in total
6.1k
Star history of OpenSenseNova/SenseNova-Skills on GitHub, a chart by star-history.com

Other skills on sensenova-skills.

sn-da-excel-workflow

sn-da-excel-workflow

Excel 数据分析多步编排器。覆盖:(1) 读取多 Sheet Excel 文件并统计行数,(2) 大文件检测(≥10k 行自动 Parquet 优化),(3) 数据清洗(缺失值、文本标准化、无效字符),(4) 条件筛选与分类提取,(5) 跨 Sheet…

category-coloring

category-coloring

当Excel文件总行数超过1万行时,通过转换为Parquet格式提升读取性能,提取目标指标并计算最大值,最后将结果输出为Excel并对特定行进行高亮标注。

threshold-cell-coloring

threshold-cell-colorin…

根据Excel总行数自动切换Parquet加速读取,计算特定维度的时间序列平均值,并使用openpyxl输出带有条件格式(如低于均值标绿)和自定义样式的分析报告。

More skills from other plugins.

i-have-adhd

i-have-adhd

Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…

@ayghri@ayghriInstall Skill
ab-test-analysis

ab-test-analysis

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop…

@phuryn@phurynInstall Skill
distilly

distilly

Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…

Questions about sn-proactive-agent.

Which coding agents can use sn-proactive-agent?
sn-proactive-agent installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.