docs: 编写 coding agent skill — Nerve 开发指南 #187

New Issue

2026-04-27T09:48:31Z

xiaoju commented

2026-04-27 09:48:31 +00:00

目标

为 coding agent（Cursor、Claude Code 等）编写 skill，让它们能够理解和开发 Nerve 项目。

Skill 内容范围

1. 基本概念

Nerve 是什么：本地感知引擎，sense → signal → workflow 的数据流
核心术语：sense、signal、workflow、kernel、daemon
架构概览：daemon 进程、worker pool、signal bus

2. CLI 命令

nerve start / nerve stop / nerve status
nerve sense list / nerve sense query <name>
nerve workflow list / nerve workflow run <name>
nerve logs / nerve dev
其他常用命令

3. 项目结构 `~/.uncaged-nerve/`

nerve.yaml — 主配置文件（senses + workflows 声明）
senses/ — sense 模块目录
workflows/ — workflow 模块目录
data/ — SQLite 数据库、signal 存储
目录布局和文件命名规范

4. Sense 开发规范

sense 的生命周期：register → compute → emit signal
nerve.yaml 中的 sense 配置：group、throttle、timeout、interval、on
调度方式：interval（定时轮询）和 on（响应其他 sense 的 signal）直接声明在 sense 上
sense 代码结构和模板
compute 函数签名和返回值
错误处理和超时机制

5. Workflow 开发规范

workflow 的触发方式（sense compute 返回值 directive、手动、API）
nerve.yaml 中的 workflow 配置（concurrency、overflow）
workflow 代码结构和模板
step/role 定义
输入输出和上下文传递

6. nerve.yaml 配置示例

senses:
  cpu-usage:
    group: system
    throttle: 5s
    timeout: 10s
    interval: 10s        # 定时轮询
    on: [disk-usage]     # 响应其他 sense 的 signal

workflows:
  alert:
    concurrency: 1

7. 开发流程

nerve dev 热重载开发
调试技巧（logs、query signals）
测试方法

产出

一个完整的 Hermes skill（SKILL.md），coding agent 加载后能够：

理解 Nerve 的架构和概念
使用 CLI 管理 daemon
独立开发新的 sense 和 workflow
遵循项目代码规范

小橘 🍊（NEKO Team）

## 目标为 coding agent（Cursor、Claude Code 等）编写 skill，让它们能够理解和开发 Nerve 项目。 ## Skill 内容范围 ### 1. 基本概念 - Nerve 是什么：本地感知引擎，sense → signal → workflow 的数据流 - 核心术语：sense、signal、workflow、kernel、daemon - 架构概览：daemon 进程、worker pool、signal bus ### 2. CLI 命令 - `nerve start` / `nerve stop` / `nerve status` - `nerve sense list` / `nerve sense query <name>` - `nerve workflow list` / `nerve workflow run <name>` - `nerve logs` / `nerve dev` - 其他常用命令 ### 3. 项目结构 `~/.uncaged-nerve/` - `nerve.yaml` — 主配置文件（senses + workflows 声明） - `senses/` — sense 模块目录 - `workflows/` — workflow 模块目录 - `data/` — SQLite 数据库、signal 存储 - 目录布局和文件命名规范 ### 4. Sense 开发规范 - sense 的生命周期：register → compute → emit signal - `nerve.yaml` 中的 sense 配置：group、throttle、timeout、interval、on - **调度方式**：`interval`（定时轮询）和 `on`（响应其他 sense 的 signal）直接声明在 sense 上 - sense 代码结构和模板 - compute 函数签名和返回值 - 错误处理和超时机制 ### 5. Workflow 开发规范 - workflow 的触发方式（sense compute 返回值 directive、手动、API） - `nerve.yaml` 中的 workflow 配置（concurrency、overflow） - workflow 代码结构和模板 - step/role 定义 - 输入输出和上下文传递 ### 6. nerve.yaml 配置示例 ```yaml senses: cpu-usage: group: system throttle: 5s timeout: 10s interval: 10s # 定时轮询 on: [disk-usage] # 响应其他 sense 的 signal workflows: alert: concurrency: 1 ``` ### 7. 开发流程 - `nerve dev` 热重载开发 - 调试技巧（logs、query signals） - 测试方法 ## 产出一个完整的 Hermes skill（SKILL.md），coding agent 加载后能够： - 理解 Nerve 的架构和概念 - 使用 CLI 管理 daemon - 独立开发新的 sense 和 workflow - 遵循项目代码规范小橘 🍊（NEKO Team）

xiaoju referenced this issue

2026-04-27 10:05:28 +00:00

refactor: rename scaffold CLI commands #188

xiaoju referenced this issue

2026-04-27 10:05:44 +00:00

refactor: remove explicit reflex config, use sense-level trigger declarations #189