用 CXAgent 把编码任务拆给子智能体：fan-out 委派、命名角色、技能钩子与沙箱信任实操

# Linux / macOS（二进制安装，不需要本机 .NET）
curl -fsSL https://raw.githubusercontent.com/nickprotop/cxagent/master/install.sh | bash
cxagent

# Windows（PowerShell）
irm https://raw.githubusercontent.com/nickprotop/cxagent/master/install.ps1 | iex

# 作为 .NET 工具安装（需要 .NET 10 SDK 或运行时）
dotnet tool install -g cxagent

# 零密钥试跑：假 provider，只用来看 UI
cxagent --mock
cxagent -v
cxagent -h

# 手工配置示例（Linux/macOS: ~/.config/cxagent/config.json
#                Windows: %APPDATA%\cxagent\config.json）
{
  "providers": {
    "local": {
      "kind": "ollama",
      "model": "qwen3:32b",
      "baseUrl": "http://localhost:11434"
    }
  },
  "defaultProvider": "local"
}

# 用某个 provider 实例启动
cxagent --model local

# 单 Agent 模式（关闭委派）
cxagent --mode single

# 启动时打开委派
cxagent --mode fan-out

# 会话内切换（在输入框里敲）
/mode agent fan-out
/mode agent single
/mode

# 给 Agent 的一句指令示例
用一个子智能体把这个仓库里所有与鉴权相关的测试读一遍，
只回报失败用例文件名与原因，不要改文件。

# 常用面板与命令
F7              打开任务面板
/tasks          列出后台命令与子智能体
/tasks output   看某个任务的进度或输出
/agents open    打开子智能体的会话标签页
/agents send    向已完成的子智能体继续提问

cxagent -p "in one sentence, what is this repo?"

git diff | cxagent -p "/review"

cxagent -p "list the TODOs" --output-format json | jq -r .result

cxagent -c -p "now fix the first one"

# 技能：.cxagent/skills/<name>/SKILL.md
---
name: double-entry-posting
description: Use when adding or fixing ledger posting or balance logic
  in this repo. Covers house rules that are not obvious from the code.
---
Every posting must sum to exactly zero. Reject unbalanced
transactions with ERR-UNBALANCED in the message.

# 自定义命令：.cxagent/commands/review.md
---
description: Review a pull request
argument-hint: [pr-number]
---
Review PR $1 against the house style.

# 钩子：config.json 片段
"hooks": {
  "PreToolUse": [
    { "matcher": "run_shell",
      "hooks": [ { "type": "command", "command": "~/bin/guard.sh" } ] }
  ]
}

# 会话内查看与切换
/sandbox                 显示当前命令可触及的范围
/sandbox review          处理挂载无法保证的路径后重新放行
/mode edits              查看写入模式，默认 always-ask
/permissions             相关设置也可在 F8 的 General 里改
/stats                   历史会话花费与填满上下文的工具
/hooks                   确认生效的钩子

# 插件：F2 打开管理器，或按名加载
/plugin load csharp-lsp.dll

# 浏览器形态（默认只监听本机）
cxagent web
cxagent web status
cxagent web stop