跳转到主要内容

​
概述

Apollo CLI 自带一个 Claude Code 技能，教会 Claude 如何使用 Apollo 命令。这意味着你可以在 Claude Code 会话中管理整个 Apollo 工作区 — 创建任务、搜索知识库、记笔记、复习闪卡，以及查询 Brain，无需切换工具。

​
设置

1

安装 CLI

cd apollo/cli
npm install && npx tsc
npm install -g .
2

认证

apollo login
3

安装技能

将技能文件复制到 Claude Code 的技能目录：
mkdir -p ~/.claude/skills
cp apollo/cli/skill/apollo-tasks.md ~/.claude/skills/apollo-tasks.md
或手动创建 — 参见下方的技能文件参考。
安装后，Claude Code 会自动发现该技能，并在你询问任务、项目、笔记、提醒或任何 Apollo 相关请求时使用它。

​
工作原理

该技能教会 Claude Code：
  1. 检查认证 — 在发起请求前使用 apollo whoami
  2. 始终使用 --json — 获取结构化、可解析的输出
  3. 按名称解析资源 — 使用 CLI 的模糊匹配
  4. 选择正确的命令 — 根据你的自然语言请求
  5. 覆盖所有领域 — 任务、发布、知识库、笔记、提醒、闪卡

​
示例会话

You: What are my current tasks?

Claude: [Runs: apollo task mine --json]

        You have 6 active tasks across 2 projects:

        Delfin One (4 tasks):
        - Fix authentication bug — In Progress, High priority
        - Add retry logic — In Progress, Medium
        - Performance optimization — In Progress, Medium
        - Deploy staging — Blocked

        Apollo (2 tasks):
        - Add CSV export — To Do, Medium
        - Update API docs — To Do, Low

You: Bulk-move all Apollo todo tasks to in_progress

Claude: [Runs: apollo task bulk-status -s in_progress -p "Apollo" --current-status todo --json]

        Done. Updated 2 tasks in Apollo from todo to in_progress.

You: Search the KB for our deployment guide

Claude: [Runs: apollo kb search "deployment" -p "Apollo" --json]

        Found 2 matching pages:
        1. "Production Deployment Guide" (Architecture folder)
        2. "Staging Deploy Runbook" (Operations folder)

You: Create a note about today's standup

Claude: [Runs: apollo note create -t "Standup 2026-02-20" --content "..." --folder "Daily notes"]

        Created note: Standup 2026-02-20

​
完整技能命令参考

该技能向 Claude Code 暴露以下命令组：

​
任务命令

命令用途
apollo task list按项目、状态、负责人列出和筛选任务
apollo task mine快捷方式：列出分配给当前用户的所有任务
apollo task view <ref>获取完整的任务详情
apollo task create创建任务，包含标题、项目、优先级、负责人、描述、截止日期
apollo task update <id>更新状态、优先级、负责人、描述、截止日期、工时
apollo task done <ref>将任务标记为已完成
apollo task assign <ref> <name>将任务分配给某人
apollo task bulk-status按 ID 或项目/状态筛选器批量更新状态
apollo task bulk-assign批量将任务分配给用户
apollo task bulk-create从 JSON 文件批量创建任务

​
发布命令

命令用途
apollo release list列出发布，可按项目筛选
apollo release view <ref>发布详情及任务进度
apollo release create创建新发布
apollo release update <ref>更新发布名称、版本、状态、日期、描述
apollo release assign-tasks <ref>按 ID 或筛选器将任务分配到发布

​
Epic 命令

命令用途
apollo epic list -p <project>列出项目中的 Epic
apollo epic view <name>Epic 详情及发布/任务统计
apollo epic create创建 Epic，包含标题、项目、状态、季度
apollo epic update <name>更新 Epic 标题、状态、描述、季度、颜色
apollo epic complete <name>将 Epic 标记为已完成
apollo epic archive <name>归档 Epic
apollo epic tasks <name>Epic 下的所有任务（通过发布）

​
工作流命令

命令用途
apollo task start <ref>开始处理任务 — 创建 git 分支并标记为 in_progress
apollo task stop停止当前任务 — 暂存 WIP，记录已用时间
apollo task current显示当前正在进行的任务
apollo task next按紧急度评分显示最高优先级的任务
apollo task deps <ref>显示任务依赖树（上游阻塞 + 下游依赖）
apollo filter save <name>从标志保存命名的任务筛选器
apollo filter list列出所有已保存的筛选器
apollo filter run <name>运行已保存的筛选器（委托给 task list）
apollo filter delete <name>删除已保存的筛选器
apollo context set <project>设置所有命令的默认项目
apollo context show显示当前默认项目
apollo context clear清除默认项目

​
项目命令

命令用途
apollo project list列出可访问的项目
apollo project view <ref>项目详情及任务汇总统计
apollo project export <ref>将项目数据导出为 JSON、CSV 或 Markdown

​
知识库命令

命令用途
apollo kb list -p <project>列出项目中的知识库页面
apollo kb view <title>查看知识库页面的完整内容
apollo kb search <query> -p <project>按标题或内容搜索知识库页面
apollo kb create创建新的知识库页面
apollo kb update <title>更新知识库页面的内容、标题或文件夹
apollo kb delete <title>软删除知识库页面
apollo kb folders -p <project>列出知识库文件夹

​
个人笔记

命令用途
apollo note list列出个人笔记
apollo note view <title>查看笔记的完整内容
apollo note search <query>按标题或内容搜索笔记
apollo note create创建笔记，可指定文件夹
apollo note update <title>更新笔记的内容、标题或文件夹
apollo note folders列出笔记文件夹

​
提醒

命令用途
apollo reminder list列出待处理的提醒
apollo reminder create创建基于时间的提醒
apollo reminder complete <id>将提醒标记为已完成
apollo reminder snooze <id>推迟提醒
apollo reminder dismiss <id>忽略提醒
apollo reminder delete <id>永久删除提醒

​
闪卡

命令用途
apollo flashcard list列出闪卡（使用 --due 仅显示到期的卡片）
apollo flashcard view <id>查看卡片及 SM-2 统计
apollo flashcard create创建新闪卡
apollo flashcard due计数并预览到期的卡片
apollo flashcard review --json以 JSON 格式输出到期卡片，用于非交互式复习

​
其他命令

命令用途
apollo ai "<prompt>"查询 Apollo Brain
apollo status个人仪表板 — 任务、发布、阻塞项
apollo whoami检查认证状态

​
工作流示例

​
实现功能后

You: I just finished the token refresh logic. Mark the task as done
     and check if anything was blocked by it.

Claude: [Runs: apollo task done "token refresh" --json]
        [Runs: apollo task list -s blocked --json]

        Marked "Fix authentication bug" as done.
        This unblocks 1 task:
        - "Deploy staging environment" — was blocked, now ready.
        Want me to move it to In Progress?

​
知识库工作流

You: Create a KB page for our new API rate limiting rules

Claude: [Runs: apollo kb create -t "API Rate Limiting" -p "Apollo"
         --content "## Rate Limits\n..." --folder "Architecture" --json]

        Created KB page "API Rate Limiting" in the Architecture folder.

​
学习会话

You: How many flashcards are due?

Claude: [Runs: apollo flashcard due --json]

        You have 12 flashcards due for review.
        Want me to start a review session?

​
早间简报

You: Give me a morning briefing — my tasks, any reminders, and due flashcards

Claude: [Runs: apollo task mine --json]
        [Runs: apollo reminder list --json]
        [Runs: apollo flashcard due --json]

        Morning Briefing:

        Tasks (6 active):
        - 3 in progress, 2 todo, 1 blocked

        Reminders (2 pending):
        - "Deploy v2" — due in 3 hours
        - "Weekly standup prep" — due tomorrow

        Flashcards: 8 due for review

​
技能文件参考

技能文件位于 ~/.claude/skills/apollo-tasks.md。它包含：
  • 认证检查：在任何命令前执行 apollo whoami
  • 完整命令参考：涵盖全部 34+ CLI 命令
  • 模糊名称解析文档
  • JSON 模式说明：用于结构化输出
  • 工作流示例：常见使用模式
  • MCP 服务器回退：当 CLI 不可用时
Claude Code 在调用技能时读取此文件。对文件的任何更新都会立即被新会话获取。

​
环境变量

变量说明
APOLLO_TOKEN用于认证的 JWT 令牌（跳过交互式登录）
APOLLO_API_URL覆盖 API 端点（默认：api.apol.dev）
对于 CI 环境或远程 Claude Code 会话，设置 APOLLO_TOKEN 以避免交互式认证： 
export APOLLO_TOKEN="eyJhbGciOiJIUzI1NiIs..."