Mission

Claude Mission Plugin

中文 | English

中文

概述

mission 是一个面向 Claude Code 的本地任务编排插件。

• Claude 只负责 orchestrator，不直接充当 worker 或 validator
• Kimi CLI 负责执行 work 任务
• Codex CLI 负责执行 validate 任务
• 任务视图采用 task-first 模式，按单个 work / validate 任务显示进度
• provider 通过 adapter 接口接入，后续可以替换或扩展

功能特性

• 单一命令面启动 mission：/mission:start <prompt>（Claude 先规划 milestones，再交给 runtime 执行）
• 辅助命令查看、推进、取消和检查 mission 运行状态
• workspace 级默认 provider 选择：/mission:providers [worker] [validator]
• mission 启动时会绑定当时的 worker / validator，后续 resume 不受 workspace 默认值变更影响
• validate 默认使用本机 codex CLI，MISSION_CODEX_VALIDATOR_RUNNER 仅作为 override
• 插件 runtime bundle 已随插件一起发布，不依赖仓库根目录的 dist/

当前 Provider

• Worker: kimi
• Validator: codex

依赖

• Node.js
• Bun
• Kimi CLI
• Codex CLI

安装

从 GitHub 安装

claude plugin marketplace add Loner1024/claude-mission-plugin --scope user
claude plugin install mission@local-mission --scope user
claude plugin enable mission@local-mission --scope user

如果当前 Claude Code 会话已经打开，执行：

/reload-plugins

从本地源码安装

claude plugin marketplace add /absolute/path/to/claude-mission-plugin/.claude-plugin/marketplace.json --scope local
claude plugin install mission@local-mission --scope local
claude plugin enable mission@local-mission --scope local

源码变更后更新本地安装：

claude plugin update mission@local-mission --scope local

命令

• /mission:setup
  • 检查 Kimi / Codex 是否可用
  • 显示当前 workspace 默认 worker / validator
• /mission:providers [worker] [validator]
  • 无参数时显示当前默认 provider
  • 带两个参数时写入 workspace 默认 provider
• /mission:start <mission-prompt>
  • 先由 Claude 生成英文 goal + milestones 计划
  • 然后调用 runtime 创建 mission，并自动推进 task-first 任务列表
• /mission:status [mission-id]
  • 查看当前 workspace 最新 mission，或指定 mission 的任务状态
• /mission:resume <mission-id>
  • 推进一个可执行任务
• /mission:result [mission-id]
  • 查看 mission 当前结果摘要
• /mission:cancel <mission-id>
  • 取消 mission，并把未完成任务同步标记为 canceled

Validator Runner 覆盖

validate 默认走本机 codex CLI。

• 显式覆盖 runner：MISSION_CODEX_VALIDATOR_RUNNER
• 覆盖默认 codex 可执行文件路径：CODEX_BINARY

示例：

export MISSION_CODEX_VALIDATOR_RUNNER=/absolute/path/to/validator-runner.ts
export CODEX_BINARY=/absolute/path/to/codex

如果未设置 MISSION_CODEX_VALIDATOR_RUNNER，插件会检测：

codex login status

只有默认 Codex CLI 或 override runner 至少有一个可用时，validate 任务才会继续执行。

开发

构建：

bun run build

测试：

bun test

类型检查：

bun run typecheck

插件校验：

claude plugin validate .claude-plugin/marketplace.json
claude plugin validate plugins/mission/.claude-plugin/plugin.json

English

Overview

mission is a local mission orchestration plugin for Claude Code.

• Claude acts only as the orchestrator, never as the worker or validator
• Kimi CLI executes work tasks
• Codex CLI executes validate tasks
• Progress is surfaced in a task-first view, one work / validate task at a time
• Providers are wired through adapters so they can be replaced later

Features

• Single entrypoint to start a mission: /mission:start <prompt> (Claude plans milestones first, then runtime executes)
• Helper commands to inspect, advance, cancel, and validate mission runtime state
• Workspace-level default provider selection with /mission:providers [worker] [validator]
• The selected worker / validator pair is pinned into the mission at start time
• Validation uses the local codex CLI by default; MISSION_CODEX_VALIDATOR_RUNNER is only an override
• The runtime bundle is shipped inside the plugin, so installed plugins do not depend on a repo-root dist/

Current Providers

• Worker: kimi
• Validator: codex

Requirements

• Node.js
• Bun
• Kimi CLI
• Codex CLI

Installation

Install from GitHub

claude plugin marketplace add Loner1024/claude-mission-plugin --scope user
claude plugin install mission@local-mission --scope user
claude plugin enable mission@local-mission --scope user

If Claude Code is already running, reload plugins:

/reload-plugins

Install from local source

claude plugin marketplace add /absolute/path/to/claude-mission-plugin/.claude-plugin/marketplace.json --scope local
claude plugin install mission@local-mission --scope local
claude plugin enable mission@local-mission --scope local

Update an existing local install after source changes:

claude plugin update mission@local-mission --scope local

Commands

• /mission:setup
  • Checks Kimi / Codex availability
  • Shows the current workspace default worker / validator
• /mission:providers [worker] [validator]
  • Without arguments, shows current defaults
  • With two arguments, persists workspace defaults
• /mission:start <mission-prompt>
  • Claude first drafts an English goal + milestone plan
  • Then runtime creates the mission and advances the task-first loop
• /mission:status [mission-id]
  • Shows the latest mission in the current workspace, or a specific mission
• /mission:resume <mission-id>
  • Advances exactly one executable task
• /mission:result [mission-id]
  • Shows the current mission result summary
• /mission:cancel <mission-id>
  • Cancels the mission and marks unfinished tasks as canceled

Validator Runner Override

Validation uses the local codex CLI by default.

• Override the validator runner with MISSION_CODEX_VALIDATOR_RUNNER
• Override the default Codex binary path with CODEX_BINARY

Example:

export MISSION_CODEX_VALIDATOR_RUNNER=/absolute/path/to/validator-runner.ts
export CODEX_BINARY=/absolute/path/to/codex

When MISSION_CODEX_VALIDATOR_RUNNER is not set, the plugin checks:

codex login status

At least one of the default Codex CLI or the explicit override runner must be available before a validate task can proceed.

Development

Build:

bun run build

Test:

bun test

Type check:

bun run typecheck

Plugin validation:

claude plugin validate .claude-plugin/marketplace.json
claude plugin validate plugins/mission/.claude-plugin/plugin.json