uncaged/nerve
Archived
10
0
Fork 0
Code Issues 5 Pull Requests Actions Packages Projects Releases Wiki Activity

RFC: nerve agent inject — 为 AI agent 注入 nerve skill #289

New Issue
Closed
opened 2026-04-30 13:27:10 +00:00 by scottwei · 3 comments
scottwei commented 2026-04-30 13:27:10 +00:00
Owner
Copy Link
Copy Source

背景

让每个 AI agent 都深度理解 nerve，把 nerve 作为日常基础能力——查看 sense 监控、调用 workflow、开发和改进 sense/workflow。

方案：在 CLI 包内置 agent skill 文件和 nerve agent 子命令，随 CLI 版本发布更新。

Phase 拆分

Phase 1: Hermes Skill 编写

  • 编写完整的 nerve SKILL.md（覆盖概念、CLI 用法、sense/workflow 开发、日常操作）
  • 文件放在 packages/cli/skills/hermes/SKILL.md
  • 验证目标：skill 内容完整准确，能被 Hermes 加载
  • Testing issue: 待创建

Phase 2: nerve agent 子命令实现

  • 实现 inject / update / remove / status 四个子操作
  • inject hermes：将 skill 复制到 ~/.hermes/skills/nerve/
  • status：对比已注入版本 vs CLI 版本
  • update：重新注入最新 skill
  • remove：清理已注入文件
  • 验证目标：nerve agent inject hermes 后 Hermes 能自动加载 nerve skill
  • Testing issue: 待创建

Phase 3: 打包与版本管理

  • 确保 skills/ 目录包含在 npm 发布的 files 中
  • CLI 升级后 nerve agent status 能检测版本不匹配
  • 验证目标：npm install 后 skill 文件存在，版本检测正确
  • Testing issue: 待创建

Phase 4: 扩展其他 Agent（后续）

  • Cursor (.cursorrules)
  • Claude Code (CLAUDE.md)
  • 按需添加

完成标准

  • Phase 1-3 的 testing issue 已 close
  • 至少一个真实 agent 能通过 nerve agent inject 获得 nerve 能力
  • skill 内容经主人 review 确认
## 背景 让每个 AI agent 都深度理解 nerve，把 nerve 作为日常基础能力——查看 sense 监控、调用 workflow、开发和改进 sense/workflow。 方案：在 CLI 包内置 agent skill 文件和 `nerve agent` 子命令，随 CLI 版本发布更新。 ## Phase 拆分 ### Phase 1: Hermes Skill 编写 - 编写完整的 nerve SKILL.md（覆盖概念、CLI 用法、sense/workflow 开发、日常操作） - 文件放在 `packages/cli/skills/hermes/SKILL.md` - 验证目标：skill 内容完整准确，能被 Hermes 加载 - Testing issue: 待创建 ### Phase 2: `nerve agent` 子命令实现 - 实现 inject / update / remove / status 四个子操作 - inject hermes：将 skill 复制到 `~/.hermes/skills/nerve/` - status：对比已注入版本 vs CLI 版本 - update：重新注入最新 skill - remove：清理已注入文件 - 验证目标：`nerve agent inject hermes` 后 Hermes 能自动加载 nerve skill - Testing issue: 待创建 ### Phase 3: 打包与版本管理 - 确保 skills/ 目录包含在 npm 发布的 files 中 - CLI 升级后 `nerve agent status` 能检测版本不匹配 - 验证目标：`npm install` 后 skill 文件存在，版本检测正确 - Testing issue: 待创建 ### Phase 4: 扩展其他 Agent（后续） - Cursor (.cursorrules) - Claude Code (CLAUDE.md) - 按需添加 ## 完成标准 - [ ] Phase 1-3 的 testing issue 已 close - [ ] 至少一个真实 agent 能通过 `nerve agent inject` 获得 nerve 能力 - [ ] skill 内容经主人 review 确认
scottwei changed title from feat(cli): nerve agent inject — 为 AI agent 注入 nerve skill to RFC: nerve agent inject — 为 AI agent 注入 nerve skill 2026-04-30 13:30:47 +00:00
scottwei commented 2026-04-30 14:08:51 +00:00
Author
Owner
Copy Link
Copy Source

验证结果汇总

交付内容

  • packages/cli/skills/hermes/SKILL.md — 505 行完整 nerve skill
  • packages/cli/src/commands/agent.ts — inject/update/remove/status 四个子命令
  • package.json files 包含 skills 目录，npm 发布正确
  • 版本动态读取 package.json，不再硬编码

Phase 1-3 完成，Close RFC。

## 验证结果汇总 - ✅ Phase 1: Hermes Skill 编写 (#290) — PR #291 - ✅ Phase 2: nerve agent 子命令 (#293) — PR #294 - ✅ Phase 3: 打包与版本管理 (#296) — PR #297 - ⏳ Phase 4: 扩展其他 Agent（Cursor、Claude Code）— 后续按需 ## 交付内容 - `packages/cli/skills/hermes/SKILL.md` — 505 行完整 nerve skill - `packages/cli/src/commands/agent.ts` — inject/update/remove/status 四个子命令 - `package.json files` 包含 skills 目录，npm 发布正确 - 版本动态读取 package.json，不再硬编码 Phase 1-3 完成，Close RFC。
scottwei reopened this issue 2026-04-30 14:47:56 +00:00
scottwei commented 2026-04-30 14:47:57 +00:00
Author
Owner
Copy Link
Copy Source

Phase 4 更新

  • ✅ Cursor (.cursorrules) — PR #303 已合并

当前支持：

  • nerve agent inject hermes — 全局 skill
  • nerve agent inject cursor — 项目级 .cursorrules

剩余：

  • Claude Code (CLAUDE.md)
  • 其他 agent 按需

RFC 保持 open 直到 Claude Code 也搞定。

## Phase 4 更新 - ✅ Cursor (.cursorrules) — PR #303 已合并 当前支持： - `nerve agent inject hermes` — 全局 skill - `nerve agent inject cursor` — 项目级 .cursorrules 剩余： - [ ] Claude Code (CLAUDE.md) - [ ] 其他 agent 按需 RFC 保持 open 直到 Claude Code 也搞定。
xiaoju commented 2026-05-02 00:55:26 +00:00
Owner
Copy Link
Copy Source

Phase 1-3 已完成并合并，Phase 4 Cursor inject 已在 PR #303 合并。剩余 Claude inject 由 #305 追踪。Close RFC。

— 小橘 🍊（NEKO Team）

Phase 1-3 已完成并合并，Phase 4 Cursor inject 已在 PR #303 合并。剩余 Claude inject 由 #305 追踪。Close RFC。 — 小橘 🍊（NEKO Team）
This repo is archived. You cannot comment on issues.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aobing jiashuang (Jia Shuang) jiayi (Jiayi) luming scottwei tuanzi xiaoju xiaomo xiaonuo xingyue
No Assignees
2 Participants
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: uncaged/nerve#289
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?