agent-mini

# 交互模式
npc

# 单次调用
npc agent --message "帮我查看 package.json"

# JSON 格式输出（方便程序化调用）
npc agent --json --message "列出当前目录的文件"

# 指定会话 ID（多轮对话复用）
npc agent --message "继续上次的任务" --session-id "my_session"

# 外部注入 system prompt
npc agent --message "评审这个 PR" --system-prompt "你是代码评审专家"

# 图片识别（需配置 vision，见下方说明）
npc agent --message "帮我识别这张图片" --images https://example.com/screenshot.png

# 多张图片
npc agent --message "对比这两张截图的差异" --images https://example.com/before.png https://example.com/after.png

# 图片 + JSON 输出
npc agent --json --message "识别图片中的文字" --images https://example.com/doc.png

# 测试模式
npc --test

{
  "agent": {
    "defaultModel": "deepseek-chat",
    "providers": {
      "openai": {
        "apiKey": "sk-xxx",
        "baseUrl": "https://api.deepseek.com/v1"
      }
    }
  }
}

{
  "agent": {
    "defaultModel": "deepseek-chat",
    "providers": {
      "openai": {
        "apiKey": "sk-xxx",
        "baseUrl": "https://api.deepseek.com/v1"
      }
    }
  }
}

{
  "agent": {
    "providers": {
      "anthropic": {
        "apiKey": "sk-ant-xxx",
        "model": "claude-sonnet-4-20250514"
      }
    }
  }
}

{
  "agent": {
    "providers": {
      "openai": {
        "apiKey": "any-value",
        "baseUrl": "http://localhost:11434/v1",
        "model": "llama3",
        "type": "openai-compatible"
      }
    }
  }
}

{
  "agent": {
    "provider": "deepseek",
    "providers": {
      "openai": {
        "apiKey": "sk-openai-xxx",
        "baseUrl": "https://api.openai.com/v1",
        "model": "gpt-4o"
      },
      "deepseek": {
        "apiKey": "sk-deepseek-xxx",
        "baseUrl": "https://api.deepseek.com/v1",
        "model": "deepseek-chat",
        "type": "openai-compatible"
      },
      "anthropic": {
        "apiKey": "sk-ant-xxx",
        "model": "claude-sonnet-4-20250514"
      }
    }
  }
}

{
  "agent": {
    "providers": {
      "openai": {
        "apiKey": "${MY_API_KEY}",
        "baseUrl": "${MY_BASE_URL}",
        "model": "gpt-4o"
      }
    }
  }
}

MY_API_KEY=sk-xxxxxxxxxxxx
MY_BASE_URL=https://api.openai.com/v1

{
  "agent": {
    "defaultModel": "deepseek-chat",
    "providers": {
      "openai": { "apiKey": "sk-xxx", "baseUrl": "https://api.deepseek.com/v1" }
    },
    "vision": {
      "model": "gpt-4o",
      "provider": {
        "apiKey": "sk-xxx",
        "baseUrl": "https://api.openai.com/v1"
      }
    }
  }
}

# 基础配置
OPENAI_API_KEY=sk-xxx              # → providers.openai.apiKey
LLM_BASE_URL=https://api.xxx/v1   # → providers.openai.baseUrl（type 自动改为 openai-compatible）
LLM_MODEL=gpt-4o                  # → agent.defaultModel
LLM_PROVIDER=openai               # → agent.provider

# Anthropic
ANTHROPIC_API_KEY=sk-ant-xxx       # → providers.anthropic.apiKey
ANTHROPIC_BASE_URL=https://...     # → providers.anthropic.baseUrl

# 可选
BRAVE_SEARCH_API_KEY=xxx           # 启用 Brave 搜索

# Vision（可选）
VISION_MODEL=gpt-4o
VISION_API_KEY=sk-xxx
VISION_BASE_URL=https://api.openai.com/v1

skills/
└── my-skill/
    ├── SKILL.md          # 必须：技能定义文件
    ├── tools/            # 可选：自带工具
    │   └── my-tool.js
    └── scripts/          # 可选：脚本

---
name: my-skill # 必填：技能唯一标识
description: 我的自定义技能 # 必填：技能描述
version: "1.0" # 可选：版本号
requires: # 可选：运行条件检查
  bins: [node, npm] #   依赖的系统命令
  env: [MY_API_KEY] #   依赖的环境变量
os: [darwin, linux] # 可选：支持的操作系统
tools: # 可选：自带工具声明
  - name: my_tool
    file: ./tools/my-tool.js
depends: # 可选：依赖其他 skill
  - name: other-skill
    optional: true
---
## 你是 XXX 专家

这里写 prompt 正文，会自动注入到 Agent 的 system prompt 中。
可以包含工作流程、规范、示例等任何 Markdown 内容。

// tools/my-tool.js
export default {
  name: "my_tool",
  description: "我的自定义工具",
  parameters: {
    type: "object",
    properties: {
      input: { type: "string", description: "输入参数" },
    },
    required: ["input"],
  },
  async execute(params) {
    // 实现逻辑...
    return { success: true, output: "执行结果" };
  },
};

{
  "skills": {
    "dirs": ["./my-skills", "/path/to/shared-skills"],
    "entries": {
      "my-skill": {
        "apiKey": "${MY_SKILL_API_KEY}",
        "env": { "CUSTOM_VAR": "value" },
        "disabled": false
      }
    }
  }
}

mkdir -p skills/code-review

---
name: code-review
description: 代码评审专家，遵循团队规范进行代码审查
version: "1.0"
---
## 代码评审规范

你是一个代码评审专家，在评审代码时请遵循以下规范：

1. **命名规范**：变量使用 camelCase，常量使用 UPPER_SNAKE_CASE
2. **错误处理**：所有异步操作必须有错误处理
3. **性能**：避免不必要的重渲染和内存泄漏
4. **安全**：检查 SQL 注入、XSS 等安全隐患

{
  "skills": {
    "remotes": [
      {
        "url": "https://cnb.cool/org/skills-repo.git",
        "path": "skills/",
        "ref": "main"
      }
    ]
  }
}

docker build -t npc .
docker run -it npc
docker run npc agent --message "列出文件"