Back to Details

kimaki-expert

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Kimaki Expert

Kimaki 专家指南

Use this skill to configure and operate Kimaki as a Discord control plane for OpenCode projects.

使用此技能将Kimaki配置并操作为OpenCode项目的Discord控制平面。

Trigger Conditions

触发条件

Activate when a request includes one or more of these signals:

Mentions
```
kimaki
```
,
```
kimaki.xyz
```
, or
```
npx -y kimaki@latest
```
Requests Discord bot setup for coding agents
Asks to map project directories to Discord channels
Needs help with Kimaki slash commands, queueing, session resume/fork/share
Wants CI or automation via
```
kimaki send
```
or
```
kimaki project add
```

当请求包含以下一个或多个信号时触发：

提及
```
kimaki
```
、
```
kimaki.xyz
```
或
```
npx -y kimaki@latest
```
请求为编码Agent设置Discord机器人
询问如何将项目目录映射到Discord频道
需要Kimaki斜杠命令、队列管理、会话恢复/分叉/共享相关帮助
希望通过
```
kimaki send
```
或
```
kimaki project add
```
实现CI或自动化

Operating Procedure

操作流程

Identify target mode: initial setup, ongoing operations, or automation.
Validate prerequisites: Discord app, bot token, project directory, and running Kimaki bridge process.
Guide through smallest viable flow first: start bot, link one project, send one message.
Expand to advanced features only after baseline path works.
Prefer exact commands and short checklists over conceptual explanations.

确定目标模式：初始设置、日常运维或自动化。
验证先决条件：Discord应用、机器人令牌、项目目录以及运行中的Kimaki桥接进程。
先引导完成最小可行流程：启动机器人、关联一个项目、发送一条消息。
仅在基础流程正常运行后，再扩展到高级功能。
优先提供精确命令和简短检查清单，而非概念性解释。

Standard Workflows

标准工作流

First-Time Setup

首次设置

Run
```
npx -y kimaki@latest
```
and follow interactive prompts.
Ensure required Discord intents are enabled during bot creation.
Install bot into target server.
Add at least one project-channel mapping and test with a short prompt message.

运行
```
npx -y kimaki@latest
```
并按照交互式提示操作。
确保在创建机器人时启用所需的Discord权限（Intents）。
将机器人安装到目标服务器。
添加至少一个项目-频道映射，并使用简短提示消息进行测试。

Day-2 Operations

日常运维

Use slash commands for session control:

/session

,

/resume

,

/abort

,

/queue

,

/clear-queue

,

/undo

,

/redo

.

Use
```
/model
```
and
```
/agent
```
to tune execution context per channel or session.
Keep one dedicated server for agent traffic and access-control hygiene.

使用斜杠命令进行会话控制：
```
/session
```
、
```
/resume
```
、
```
/abort
```
、
```
/queue
```
、
```
/clear-queue
```
、
```
/undo
```
、
```
/redo
```
。
使用
```
/model
```
和
```
/agent
```
为每个频道或会话调整执行上下文。
为Agent流量和访问控制管理保留一个专用服务器。

Automation and CI

自动化与CI

Start jobs programmatically with

npx -y kimaki send --channel <id> --prompt "..."

.

Continue existing threads with
```
--thread
```
or
```
--session
```
.
Create isolated runs with
```
--worktree <name>
```
.
Use
```
--notify-only
```
for context events without immediate execution.

通过

npx -y kimaki send --channel <id> --prompt "..."

以编程方式启动任务。

使用
```
--thread
```
或
```
--session
```
继续现有线程。
使用
```
--worktree <name>
```
创建隔离运行环境。
使用
```
--notify-only
```
处理上下文事件而不立即执行。

Troubleshooting Heuristics

故障排查指南

If messages do nothing, verify permissions and role policy (
```
Kimaki
```
role and no
```
no-kimaki
```
blocker role).
If sessions fail to start, verify Kimaki process is running on machine hosting target project.
If channels are missing, re-run mapping with
```
/add-project
```
or
```
kimaki project add
```
.
If multi-machine routing is confusing, enforce one bot per machine and explicit channel labeling.

如果消息无响应，请验证权限和角色策略（需有
```
Kimaki
```
角色且无
```
no-kimaki
```
限制角色）。
如果会话无法启动，请验证托管目标项目的机器上Kimaki进程是否在运行。
如果频道丢失，请使用
```
/add-project
```
或
```
kimaki project add
```
重新运行映射。
如果多机器路由混乱，请为每台机器配置一个独立机器人，并使用明确的频道标签。

Response Style

回复风格

Lead with exact command(s), then expected result.
Include one validation step after each critical action.
Keep guidance operational and concise.
Use
```
references/kimaki-quick-reference.md
```
for commands and recipes.

先给出精确命令，再说明预期结果。
在每个关键操作后添加一个验证步骤。
保持指导内容实用且简洁。
如需命令和参考方案，请使用
```
references/kimaki-quick-reference.md
```
。