[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77K9BABQBK89776KB2ECRFF":3,"skill-same:01M77K9BABQBK89776KB2ECRFF":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":39,"commitSha":40,"skillDirectory":41,"forksCount":42,"repositoryHtmlUrl":43,"repositoryHomepageUrl":44,"ownerHtmlUrl":45,"ownerBlogUrl":6,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M77K9BABQBK89776KB2ECRFF","kimi_cli_headless_execution",null,"教 OpenClaw 在自动化脚本、后台任务、CI\u002FCD、无 TTY 环境等非交互场景中， 正确使用 Kimi Code CLI 的 `-p\u002F--prompt`、`--print`、`--quiet`、`--wire` 等参数完成无头执行。 涵盖命令构造、自动审批控制、输出格式选择、会话管理、错误处理与安全护栏。","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fk\u002Fkimi-cli-headless-execution\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: kimi_cli_headless_execution\ntitle: Kimi CLI 无头执行操作手册\nversion: 1.0\nlanguage: zh-CN\ncategory: dev-tool-cli-automation\ndescription: >\n  教 OpenClaw 在自动化脚本、后台任务、CI\u002FCD、无 TTY 环境等非交互场景中，\n  正确使用 Kimi Code CLI 的 `-p\u002F--prompt`、`--print`、`--quiet`、`--wire` 等参数完成无头执行。\n  涵盖命令构造、自动审批控制、输出格式选择、会话管理、错误处理与安全护栏。\ntags:\n  - Kimi CLI\n  - headless\n  - 无头执行\n  - 自动化\n  - CI\u002FCD\n  - 命令行工具\n  - 代码代理\nowner: Assistant\nstatus: production-ready\n---\n\n# Skill: Kimi CLI 无头执行操作手册\n\n## Overview\n\nKimi Code CLI 默认以交互式 Shell\u002FTUI 模式启动，但在自动化场景中需要**无头执行**（不进入交互界面，传入提示词后直接输出结果并退出）。本 Skill 指导 Agent 在需要调用 `kimi` 命令完成后台任务时，如何构造正确的无头执行命令，确保输出可控、错误可处理、操作安全。\n\n---\n\n## Core Mission\n\n执行本 Skill 时，最终必须做到：\n\n1. **构造出可在当前环境直接执行的 `kimi` 无头命令**\n2. **根据场景选择最合适的输出模式**（`--quiet` 快速文本 \u002F `--print` 完整过程 \u002F `--wire` 服务化）\n3. **明确是否启用自动审批（`--yolo`）并告知用户风险**\n4. **处理命令执行结果或错误，给出下一步建议**\n\n---\n\n## Trigger Conditions\n\n在以下情况下必须触发本 Skill：\n\n- 用户要求 Agent **使用 Kimi CLI 自动完成某个任务**（如“让 Kimi CLI 无头重构这段代码”、“用 Kimi CLI 分析当前目录的 bug”）\n- 任务需要运行在 **无 TTY 环境**、**后台脚本** 或 **CI\u002FCD 流水线** 中\n- 用户询问 **Kimi CLI 是否支持无头模式 \u002F 非交互执行 \u002F 自动化调用**\n- Agent 自身需要通过 `kimi` 命令行工具调用 Kimi 模型能力，而不是通过 API 直接请求\n\n## Non-Trigger Cases\n\n以下情况不应套用本 Skill 的完整执行流程：\n\n- 用户只是问 Kimi CLI 的安装、登录、配置方法（直接文字回答即可）\n- 用户想手动和 Kimi CLI 进行交互式聊天（建议用户直接运行 `kimi`）\n- 当前环境未安装 `kimi` 命令，且用户未要求安装（应先提示安装或换用 API）\n- 用户要求比较 Kimi CLI 与其他 CLI 工具的优缺点（纯问答场景）\n\n---\n\n## Pre-Flight Check\n\n在构造命令前，必须先确认：\n\n1. **命令是否存在**：运行 `which kimi` 或 `kimi --version`，确认 Kimi CLI 已安装\n2. **是否需要登录**：若用户未配置 API Key 且未通过 `kimi login` 登录，需提示用户先完成认证\n3. **工作目录是否正确**：若任务涉及特定项目路径，必须显式使用 `--work-dir PATH`\n4. **是否需要文件修改权限**：若 Kimi CLI 需要自动修改文件\u002F执行 Shell，必须加 `--yolo`（并告知风险）\n\n---\n\n## Command Reference\n\n### 基础无头执行（最常用）\n\n| 参数 | 简写 | 说明 |\n|------|------|------|\n| `--prompt TEXT` | `-p` | 传入用户提示，不进入交互模式 |\n| `--command TEXT` | `-c` | `--prompt` 的别名 |\n| `--print` | | 以 Print 模式运行（非交互式），隐式启用 `--yolo` |\n| `--quiet` | | 等价于 `--print --output-format text --final-message-only` |\n| `--yolo` | `-y` | 自动批准所有文件修改和 Shell 命令执行 |\n| `--work-dir PATH` | `-w` | 指定工作目录 |\n| `--model NAME` | `-m` | 指定模型，覆盖配置文件 |\n| `--continue` | `-C` | 继续当前工作目录的上一个会话 |\n| `--session ID` \u002F `--resume ID` | `-S` \u002F `-r` | 恢复指定会话 |\n| `--output-format FORMAT` | | 仅在 `--print` 下有效：`text`（默认）或 `stream-json` |\n| `--final-message-only` | | 仅在 `--print` 下有效：只输出最终 assistant 消息 |\n| `--wire` | | 以 Wire 服务器模式运行（实验性），适合程序集成 |\n\n### 关键模式选择策略\n\n- **快速单次问答（推荐默认）**：`kimi -p \"任务描述\" --quiet`\n  - 优点：输出最干净，直接返回最终结论，适合脚本捕获\n  - 缺点：不展示中间思考\u002F工具调用过程\n\n- **需要观察完整过程**：`kimi -p \"任务描述\" --print`\n  - 优点：能看到 Kimi CLI 使用的工具、执行的命令、读取的文件\n  - 缺点：输出较长，包含中间步骤，需 Agent 自行过滤关键信息\n\n- **需要结构化\u002F流式输出**：`kimi -p \"任务描述\" --print --output-format stream-json`\n  - 优点：每行一个 JSON 对象，便于程序解析\n  - 缺点：需要额外的 JSON 解析逻辑\n\n- **长任务\u002F多轮迭代**：`kimi -p \"任务描述\" --print --max-ralph-iterations N`\n  - 开启 Ralph 循环模式，让 Agent 反复迭代直到完成任务或达到上限\n\n- **服务化\u002F后台常驻**：`kimi --wire`\n  - 启动 Wire 协议服务器，供本地客户端（如 IDE 插件、其他 Agent）通过协议通信\n  - 不接受初始提示词，需要配合 Wire 客户端使用\n\n---\n\n## Execution Policy\n\n执行时必须按以下顺序构造命令：\n\n### Step 1：确定执行模式\n根据用户需求选择输出模式：\n- 只需要最终结果 → `--quiet`\n- 需要查看 Kimi 的分析\u002F操作过程 → `--print`\n- 需要程序解析 → `--print --output-format stream-json`\n\n### Step 2：确定是否需要自动审批\n若任务涉及**读写文件、执行 Shell 命令、安装依赖**等需要审批的操作：\n- 无头模式下必须加 `--yolo`（或依赖 `--print` 隐式启用 `--yolo`）\n- **但在加之前，必须向用户声明风险**：\"YOLO 模式下所有文件修改和命令都会自动执行，请确认是否继续？\"\n\n### Step 3：确定工作目录\n若任务与当前目录无关，或需要操作特定项目：\n- 显式添加 `--work-dir \"目标路径\"`\n\n### Step 4：确定会话策略\n- 全新单次任务：不加会话参数\n- 继续之前的上下文：加 `--continue`\n- 恢复指定会话：加 `--session \u003CID>`\n\n### Step 5：组装并执行\n按照以下优先级拼接命令（注意参数顺序）：\n\n```bash\nkimi \\\n  [--work-dir PATH] \\\n  [--model NAME] \\\n  [--continue | --session ID] \\\n  -p \"具体任务提示词\" \\\n  [--quiet | --print [--output-format stream-json] [--final-message-only]] \\\n  [--yolo]\n```\n\n**典型命令示例**：\n\n```bash\n# 示例1：快速无头分析当前目录代码\nkimi -p \"分析当前项目的主要架构和潜在问题\" --quiet\n\n# 示例2：让 Kimi 自动修复指定文件的 bug（自动审批）\nkimi -w .\u002Fsrc -p \"修复 main.py 中的空指针异常\" --quiet --yolo\n\n# 示例3：完整过程输出，用于观察 Kimi 的思考链\nkimi -p \"为这个项目添加单元测试\" --print\n\n# 示例4：结构化流式输出，供程序解析\nkimi -p \"生成 CHANGELOG\" --print --output-format stream-json\n\n# 示例5：恢复之前会话继续工作\nkimi -w .\u002Fmy-project -p \"继续完成刚才的优化\" --continue --quiet --yolo\n```\n\n---\n\n## Output Handling\n\n### `--quiet` 模式输出\n直接返回纯文本字符串，可直接作为答案呈现给用户，无需额外解析。\n\n### `--print` + `text` 模式输出\n通常包含：\n- 系统信息（版本、模型等）\n- 工具调用记录（读取文件、执行命令）\n- 思考过程\n- 最终回答\n\nAgent 应该：\n1. 先检查退出码（`$?`）是否为 0\n2. 向用户摘要展示关键动作（如“Kimi 读取了 3 个文件，执行了 2 条命令”）\n3. 提取最终结论部分呈现\n\n### `--print` + `stream-json` 模式输出\n每行是一个 JSONL 对象，常见 `type` 字段包括：\n- `start`：开始\n- `thinking`：思考内容\n- `tool_call` \u002F `tool_result`：工具调用及结果\n- `content`：模型生成的内容片段\n- `done`：结束标记\n\nAgent 应该：\n- 过滤 `type == \"content\"` 的片段拼接成完整回复\n- 或过滤 `type == \"tool_result\"` 获取工具执行结果\n\n### Wire 模式\n`kimi --wire` 启动后，需要配合 Wire 客户端进行通信。此模式下：\n- 不输出到 stdout\n- 在默认端口（或配置端口）监听\n- Agent 应告知用户 \"Wire 服务器已启动，请通过 Wire 客户端连接\"\n\n---\n\n## Guardrails\n\n1. **未经许可不得在关键系统目录使用 `--yolo`**\n   - 避免在 `$HOME` 根目录、`\u002Fetc`、`\u002Fusr` 等全局目录自动执行命令\n2. **必须确认 `--yolo` 的风险**\n   - 在启用前向用户明确说明：所有文件修改和 Shell 命令都会自动执行，无法撤销\n3. **优先使用 `--quiet` 避免信息过载**\n   - 除非用户明确要求查看过程，否则默认用 `--quiet`\n4. **不要混淆 `-p` 的两种含义**\n   - 在 `kimi` 主命令中 `-p` 是 `--prompt`\n   - 在 `kimi web` 子命令中 `-p` 是 `--port`，注意上下文\n5. **检查命令退出码**\n   - Kimi CLI 执行失败时（如 API 限流、网络错误、认证失败），应捕获 stderr 并告知用户\n6. **避免在 `--quiet`\u002F`--print` 中混用交互式参数**\n   - 无头模式下不要期望用户能在中途输入确认\n\n---\n\n## Failure Modes\n\n### Failure Mode 1：未安装 Kimi CLI\n**表现**：`command not found: kimi`  \n**处理**：提示用户通过 `pip install kimi-cli` 或官方推荐方式安装，或换用 Moonshot API 直接调用。\n\n### Failure Mode 2：未登录\u002F未配置 API Key\n**表现**：报错信息包含 `Unauthorized`、`请登录` 或 `API key not found`  \n**处理**：提示用户运行 `kimi login` 或在 `~\u002F.kimi\u002Fconfig.toml` 中配置 API key。\n\n### Failure Mode 3：加了 `--yolo` 但用户不想自动执行\n**表现**：用户反馈 \"Kimi 直接改了我文件但我没同意\"  \n**处理**：道歉并解释 `--yolo` 的作用，今后在涉及文件修改前必须显式征得同意。\n\n### Failure Mode 4：`--print --output-format stream-json` 输出为空或解析失败\n**表现**：没有任何 stdout 或 JSON 解析报错  \n**处理**：先降级到 `--quiet` 或 `--print --output-format text` 重新执行，确认是基础命令问题还是格式问题。\n\n### Failure Mode 5：会话恢复失败\n**表现**：`--continue` 或 `--session ID` 提示会话不存在  \n**处理**：不加会话参数以新建会话执行，或提示用户通过 `kimi info` 查看可用会话。\n\n---\n\n## Input Schema\n\n```yaml\ninput_schema:\n  type: object\n  required:\n    - task_description\n  properties:\n    task_description:\n      type: string\n      description: 要交给 Kimi CLI 执行的具体任务描述\n    work_dir:\n      type: string\n      description: 工作目录路径，默认为当前目录\n    output_mode:\n      type: string\n      enum: [quiet, print, stream-json, wire]\n      description: 输出模式选择\n    auto_approve:\n      type: boolean\n      description: 是否启用 --yolo 自动审批\n    model:\n      type: string\n      description: 指定使用的模型名称\n    session_strategy:\n      type: string\n      enum: [new, continue, resume]\n      description: 会话策略\n    session_id:\n      type: string\n      description: 当 session_strategy 为 resume 时必填\n```\n\n## Output Schema\n\n```yaml\noutput_schema:\n  type: object\n  properties:\n    constructed_command:\n      type: string\n      description: 最终构造并执行的 kimi 命令\n    execution_result:\n      type: string\n      description: 命令输出内容或结果摘要\n    exit_code:\n      type: integer\n      description: 命令退出码\n    warnings:\n      type: array\n      items:\n        type: string\n      description: 执行过程中的警告或风险提示\n    next_steps:\n      type: array\n      items:\n        type: string\n      description: 建议的后续操作\n```\n\n---\n\n## Response Template\n\n```markdown\n### 构造的命令\n\\`\\`\\`bash\n{constructed_command}\n\\`\\`\\`\n\n### 执行结果\n{execution_result_summary}\n\n### 风险提示\n{yolo_warning_if_applicable}\n\n### 后续建议\n{next_steps}\n```\n\n---\n\n## Final Rule\n\n本 Skill 的终极要求只有一句话：\n\n**在无头场景下调用 Kimi CLI 时，必须让命令“一次成型、自动跑完、输出干净、风险可知”。**\n\n- 不要构造出还需要人机交互的命令\n- 不要在用户不知情时自动修改文件\n- 不要让输出模式与解析需求不匹配\n- 命令执行失败后，要有清晰的降级方案\n","# Skill: Kimi CLI 无头执行操作手册\n\n## Overview\n\nKimi Code CLI 默认以交互式 Shell\u002FTUI 模式启动，但在自动化场景中需要**无头执行**（不进入交互界面，传入提示词后直接输出结果并退出）。本 Skill 指导 Agent 在需要调用 `kimi` 命令完成后台任务时，如何构造正确的无头执行命令，确保输出可控、错误可处理、操作安全。\n\n---\n\n## Core Mission\n\n执行本 Skill 时，最终必须做到：\n\n1. **构造出可在当前环境直接执行的 `kimi` 无头命令**\n2. **根据场景选择最合适的输出模式**（`--quiet` 快速文本 \u002F `--print` 完整过程 \u002F `--wire` 服务化）\n3. **明确是否启用自动审批（`--yolo`）并告知用户风险**\n4. **处理命令执行结果或错误，给出下一步建议**\n\n---\n\n## Trigger Conditions\n\n在以下情况下必须触发本 Skill：\n\n- 用户要求 Agent **使用 Kimi CLI 自动完成某个任务**（如“让 Kimi CLI 无头重构这段代码”、“用 Kimi CLI 分析当前目录的 bug”）\n- 任务需要运行在 **无 TTY 环境**、**后台脚本** 或 **CI\u002FCD 流水线** 中\n- 用户询问 **Kimi CLI 是否支持无头模式 \u002F 非交互执行 \u002F 自动化调用**\n- Agent 自身需要通过 `kimi` 命令行工具调用 Kimi 模型能力，而不是通过 API 直接请求\n\n## Non-Trigger Cases\n\n以下情况不应套用本 Skill 的完整执行流程：\n\n- 用户只是问 Kimi CLI 的安装、登录、配置方法（直接文字回答即可）\n- 用户想手动和 Kimi CLI 进行交互式聊天（建议用户直接运行 `kimi`）\n- 当前环境未安装 `kimi` 命令，且用户未要求安装（应先提示安装或换用 API）\n- 用户要求比较 Kimi CLI 与其他 CLI 工具的优缺点（纯问答场景）\n\n---\n\n## Pre-Flight Check\n\n在构造命令前，必须先确认：\n\n1. **命令是否存在**：运行 `which kimi` 或 `kimi --version`，确认 Kimi CLI 已安装\n2. **是否需要登录**：若用户未配置 API Key 且未通过 `kimi login` 登录，需提示用户先完成认证\n3. **工作目录是否正确**：若任务涉及特定项目路径，必须显式使用 `--work-dir PATH`\n4. **是否需要文件修改权限**：若 Kimi CLI 需要自动修改文件\u002F执行 Shell，必须加 `--yolo`（并告知风险）\n\n---\n\n## Command Reference\n\n### 基础无头执行（最常用）\n\n| 参数 | 简写 | 说明 |\n|------|------|------|\n| `--prompt TEXT` | `-p` | 传入用户提示，不进入交互模式 |\n| `--command TEXT` | `-c` | `--prompt` 的别名 |\n| `--print` | | 以 Print 模式运行（非交互式），隐式启用 `--yolo` |\n| `--quiet` | | 等价于 `--print --output-format text --final-message-only` |\n| `--yolo` | `-y` | 自动批准所有文件修改和 Shell 命令执行 |\n| `--work-dir PATH` | `-w` | 指定工作目录 |\n| `--model NAME` | `-m` | 指定模型，覆盖配置文件 |\n| `--continue` | `-C` | 继续当前工作目录的上一个会话 |\n| `--session ID` \u002F `--resume ID` | `-S` \u002F `-r` | 恢复指定会话 |\n| `--output-format FORMAT` | | 仅在 `--print` 下有效：`text`（默认）或 `stream-json` |\n| `--final-message-only` | | 仅在 `--print` 下有效：只输出最终 assistant 消息 |\n| `--wire` | | 以 Wire 服务器模式运行（实验性），适合程序集成 |\n\n### 关键模式选择策略\n\n- **快速单次问答（推荐默认）**：`kimi -p \"任务描述\" --quiet`\n  - 优点：输出最干净，直接返回最终结论，适合脚本捕获\n  - 缺点：不展示中间思考\u002F工具调用过程\n\n- **需要观察完整过程**：`kimi -p \"任务描述\" --print`\n  - 优点：能看到 Kimi CLI 使用的工具、执行的命令、读取的文件\n  - 缺点：输出较长，包含中间步骤，需 Agent 自行过滤关键信息\n\n- **需要结构化\u002F流式输出**：`kimi -p \"任务描述\" --print --output-format stream-json`\n  - 优点：每行一个 JSON 对象，便于程序解析\n  - 缺点：需要额外的 JSON 解析逻辑\n\n- **长任务\u002F多轮迭代**：`kimi -p \"任务描述\" --print --max-ralph-iterations N`\n  - 开启 Ralph 循环模式，让 Agent 反复迭代直到完成任务或达到上限\n\n- **服务化\u002F后台常驻**：`kimi --wire`\n  - 启动 Wire 协议服务器，供本地客户端（如 IDE 插件、其他 Agent）通过协议通信\n  - 不接受初始提示词，需要配合 Wire 客户端使用\n\n---\n\n## Execution Policy\n\n执行时必须按以下顺序构造命令：\n\n### Step 1：确定执行模式\n根据用户需求选择输出模式：\n- 只需要最终结果 → `--quiet`\n- 需要查看 Kimi 的分析\u002F操作过程 → `--print`\n- 需要程序解析 → `--print --output-format stream-json`\n\n### Step 2：确定是否需要自动审批\n若任务涉及**读写文件、执行 Shell 命令、安装依赖**等需要审批的操作：\n- 无头模式下必须加 `--yolo`（或依赖 `--print` 隐式启用 `--yolo`）\n- **但在加之前，必须向用户声明风险**：\"YOLO 模式下所有文件修改和命令都会自动执行，请确认是否继续？\"\n\n### Step 3：确定工作目录\n若任务与当前目录无关，或需要操作特定项目：\n- 显式添加 `--work-dir \"目标路径\"`\n\n### Step 4：确定会话策略\n- 全新单次任务：不加会话参数\n- 继续之前的上下文：加 `--continue`\n- 恢复指定会话：加 `--session \u003CID>`\n\n### Step 5：组装并执行\n按照以下优先级拼接命令（注意参数顺序）：\n\n```bash\nkimi \\\n  [--work-dir PATH] \\\n  [--model NAME] \\\n  [--continue | --session ID] \\\n  -p \"具体任务提示词\" \\\n  [--quiet | --print [--output-format stream-json] [--final-message-only]] \\\n  [--yolo]\n```\n\n**典型命令示例**：\n\n```bash\n# 示例1：快速无头分析当前目录代码\nkimi -p \"分析当前项目的主要架构和潜在问题\" --quiet\n\n# 示例2：让 Kimi 自动修复指定文件的 bug（自动审批）\nkimi -w .\u002Fsrc -p \"修复 main.py 中的空指针异常\" --quiet --yolo\n\n# 示例3：完整过程输出，用于观察 Kimi 的思考链\nkimi -p \"为这个项目添加单元测试\" --print\n\n# 示例4：结构化流式输出，供程序解析\nkimi -p \"生成 CHANGELOG\" --print --output-format stream-json\n\n# 示例5：恢复之前会话继续工作\nkimi -w .\u002Fmy-project -p \"继续完成刚才的优化\" --continue --quiet --yolo\n```\n\n---\n\n## Output Handling\n\n### `--quiet` 模式输出\n直接返回纯文本字符串，可直接作为答案呈现给用户，无需额外解析。\n\n### `--print` + `text` 模式输出\n通常包含：\n- 系统信息（版本、模型等）\n- 工具调用记录（读取文件、执行命令）\n- 思考过程\n- 最终回答\n\nAgent 应该：\n1. 先检查退出码（`$?`）是否为 0\n2. 向用户摘要展示关键动作（如“Kimi 读取了 3 个文件，执行了 2 条命令”）\n3. 提取最终结论部分呈现\n\n### `--print` + `stream-json` 模式输出\n每行是一个 JSONL 对象，常见 `type` 字段包括：\n- `start`：开始\n- `thinking`：思考内容\n- `tool_call` \u002F `tool_result`：工具调用及结果\n- `content`：模型生成的内容片段\n- `done`：结束标记\n\nAgent 应该：\n- 过滤 `type == \"content\"` 的片段拼接成完整回复\n- 或过滤 `type == \"tool_result\"` 获取工具执行结果\n\n### Wire 模式\n`kimi --wire` 启动后，需要配合 Wire 客户端进行通信。此模式下：\n- 不输出到 stdout\n- 在默认端口（或配置端口）监听\n- Agent 应告知用户 \"Wire 服务器已启动，请通过 Wire 客户端连接\"\n\n---\n\n## Guardrails\n\n1. **未经许可不得在关键系统目录使用 `--yolo`**\n   - 避免在 `$HOME` 根目录、`\u002Fetc`、`\u002Fusr` 等全局目录自动执行命令\n2. **必须确认 `--yolo` 的风险**\n   - 在启用前向用户明确说明：所有文件修改和 Shell 命令都会自动执行，无法撤销\n3. **优先使用 `--quiet` 避免信息过载**\n   - 除非用户明确要求查看过程，否则默认用 `--quiet`\n4. **不要混淆 `-p` 的两种含义**\n   - 在 `kimi` 主命令中 `-p` 是 `--prompt`\n   - 在 `kimi web` 子命令中 `-p` 是 `--port`，注意上下文\n5. **检查命令退出码**\n   - Kimi CLI 执行失败时（如 API 限流、网络错误、认证失败），应捕获 stderr 并告知用户\n6. **避免在 `--quiet`\u002F`--print` 中混用交互式参数**\n   - 无头模式下不要期望用户能在中途输入确认\n\n---\n\n## Failure Modes\n\n### Failure Mode 1：未安装 Kimi CLI\n**表现**：`command not found: kimi`  \n**处理**：提示用户通过 `pip install kimi-cli` 或官方推荐方式安装，或换用 Moonshot API 直接调用。\n\n### Failure Mode 2：未登录\u002F未配置 API Key\n**表现**：报错信息包含 `Unauthorized`、`请登录` 或 `API key not found`  \n**处理**：提示用户运行 `kimi login` 或在 `~\u002F.kimi\u002Fconfig.toml` 中配置 API key。\n\n### Failure Mode 3：加了 `--yolo` 但用户不想自动执行\n**表现**：用户反馈 \"Kimi 直接改了我文件但我没同意\"  \n**处理**：道歉并解释 `--yolo` 的作用，今后在涉及文件修改前必须显式征得同意。\n\n### Failure Mode 4：`--print --output-format stream-json` 输出为空或解析失败\n**表现**：没有任何 stdout 或 JSON 解析报错  \n**处理**：先降级到 `--quiet` 或 `--print --output-format text` 重新执行，确认是基础命令问题还是格式问题。\n\n### Failure Mode 5：会话恢复失败\n**表现**：`--continue` 或 `--session ID` 提示会话不存在  \n**处理**：不加会话参数以新建会话执行，或提示用户通过 `kimi info` 查看可用会话。\n\n---\n\n## Input Schema\n\n```yaml\ninput_schema:\n  type: object\n  required:\n    - task_description\n  properties:\n    task_description:\n      type: string\n      description: 要交给 Kimi CLI 执行的具体任务描述\n    work_dir:\n      type: string\n      description: 工作目录路径，默认为当前目录\n    output_mode:\n      type: string\n      enum: [quiet, print, stream-json, wire]\n      description: 输出模式选择\n    auto_approve:\n      type: boolean\n      description: 是否启用 --yolo 自动审批\n    model:\n      type: string\n      description: 指定使用的模型名称\n    session_strategy:\n      type: string\n      enum: [new, continue, resume]\n      description: 会话策略\n    session_id:\n      type: string\n      description: 当 session_strategy 为 resume 时必填\n```\n\n## Output Schema\n\n```yaml\noutput_schema:\n  type: object\n  properties:\n    constructed_command:\n      type: string\n      description: 最终构造并执行的 kimi 命令\n    execution_result:\n      type: string\n      description: 命令输出内容或结果摘要\n    exit_code:\n      type: integer\n      description: 命令退出码\n    warnings:\n      type: array\n      items:\n        type: string\n      description: 执行过程中的警告或风险提示\n    next_steps:\n      type: array\n      items:\n        type: string\n      description: 建议的后续操作\n```\n\n---\n\n## Response Template\n\n```markdown\n### 构造的命令\n\\`\\`\\`bash\n{constructed_command}\n\\`\\`\\`\n\n### 执行结果\n{execution_result_summary}\n\n### 风险提示\n{yolo_warning_if_applicable}\n\n### 后续建议\n{next_steps}\n```\n\n---\n\n## Final Rule\n\n本 Skill 的终极要求只有一句话：\n\n**在无头场景下调用 Kimi CLI 时，必须让命令“一次成型、自动跑完、输出干净、风险可知”。**\n\n- 不要构造出还需要人机交互的命令\n- 不要在用户不知情时自动修改文件\n- 不要让输出模式与解析需求不匹配\n- 命令执行失败后，要有清晰的降级方案\n",{"name":5,"tags":24,"owner":32,"title":33,"status":34,"version":35,"category":36,"language":37,"description":38},[25,26,27,28,29,30,31],"Kimi CLI","headless","无头执行","自动化","CI\u002FCD","命令行工具","代码代理","Assistant","Kimi CLI 无头执行操作手册","production-ready",1,"dev-tool-cli-automation","zh-CN","教 OpenClaw 在自动化脚本、后台任务、CI\u002FCD、无 TTY 环境等非交互场景中， 正确使用 Kimi Code CLI 的 `-p\u002F--prompt`、`--print`、`--quiet`、`--wire` 等参数完成无头执行。 涵盖命令构造、自动审批控制、输出格式选择、会话管理、错误处理与安全护栏。\n","master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fk\u002Fkimi-cli-headless-execution",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill kimi_cli_headless_execution",{"tool":54,"command":55},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill kimi_cli_headless_execution",{"tool":57,"command":58},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill kimi_cli_headless_execution","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fk\u002Fkimi-cli-headless-execution\u002FSKILL.md",true,[],[63,70,77,84,91,98],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]