跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
AI 与知识库

xmake-harness

Use when running or configuring `xmake ai` — the terminal coding agent provided by the xmake-harness addon. Covers installing it, setting an llm provider and api key, sessions (`-c`/`-r`), permission modes, the non-interactive `--print` mode for scripts and CI, and listing its skills/agents/tools/commands.

xmake-io · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add xmake-io/xmake-skills --skill xmake-harness

技能说明


name: xmake-harness description: Use when running or configuring xmake ai — the terminal coding agent provided by the xmake-harness addon. Covers installing it, setting an llm provider and api key, sessions (-c/-r), permission modes, the non-interactive --print mode for scripts and CI, and listing its skills/agents/tools/commands.

xmake-harness (xmake ai)

xmake-harness is an agent harness written in xmake lua. As an addon it exposes xmake ai, a claude-code style terminal agent that knows how to build the project it is sitting in.

Install

xmake addon --install xmake-harness
xmake ai --setup                     # interactive wizard: provider, api key, model

Or from the source:

xmake addon --install github:xmake-addons/xmake-harness

Configure a provider

xmake ai --config=providers.deepseek.apikey=sk-xxxxxx
xmake ai --apikey=sk-xxxxxx                 # api key of the current provider
xmake ai --provider=deepseek --model=deepseek-chat
xmake ai --smallmodel=deepseek-chat         # used by the title/summary/light subagents
xmake ai --showconfig                       # the resolved configuration
xmake ai --doctor                           # check the environment

Run it

xmake ai                                    # interactive tui
xmake ai "add a unit test for foo"          # start with a prompt
xmake ai -c                                 # continue the last session of this directory
xmake ai -c "and now add the tests"
xmake ai -r                                 # pick a session to resume
xmake ai -r 6a86cfc5-bbda-14ce
xmake ai --new                              # force a new session

Non-interactive

For scripts, hooks and CI — it prints the result and exits:

xmake ai --print "what does this build produce?"
xmake ai --command=doctor                   # run one slash command and exit
xmake ai --command='model deepseek-reasoner'

Permissions and sandbox

xmake ai --mode=plan          # read-only, it plans before touching anything
xmake ai --mode=acceptedits   # auto-accept file edits, still asks for commands
xmake ai --mode=bypass        # no prompts (use with care)
xmake ai --sandbox            # confine the commands it runs
xmake ai --notools            # chat only, no tools at all

--mode=plan is the right default when you let it look at an unfamiliar repository.

What it carries

xmake ai --list=skills        # also: agents, tools, commands, plugins, providers, sessions

Skills are the same shape as this repository's — dropping xmake-skills into it teaches it xmake in the same way it teaches Claude Code.

Gotchas

  • It needs an api key and network access; --doctor tells you which part is missing.
  • Sessions are per directory, so -c in another directory continues a different thread.
  • --print is the only mode safe to run from a script — the tui expects a real terminal.