Cairn — 原生 AI 项目管理工具

Cairn 为你和你的 AI 智能体提供一个共享的 Markdown 文件工作区，用于管理项目与任务。状态（Statuses）是双方共通的语言。任何能够读取文件的 AI 均可即刻开始工作。

安装

npm install -g cairn-work
cairn onboard

cairn onboard 命令将在 ~/cairn/ 目录下创建自动化的上下文文件（AGENTS.md 和 .cairn/planning.md），AI 智能体将自动读取这些文件。

社区

• 关注 X 平台上的 @letcairnwork
• 访问 letcairn.work
• 提交 issue
• 参与讨论

核心命令

工作区

• cairn status — 任务统计概览
• cairn my — 查看分配给你的任务
• cairn active — 查看所有进行中的任务
• cairn doctor — 诊断工作区健康状况

项目与任务

• cairn create project "名称" --description "..." --objective "..." — 创建带章程（charter）的项目
• cairn create task "名称" --project --description "..." --objective "..." — 创建任务
• cairn list tasks [--status pending,in_progress] [--project slug] — 按条件筛选并列出任务
• cairn search "关键词" — 根据内容搜索任务

任务工作流

• cairn start — 开始执行任务（状态设为 in_progress）
• cairn note "进度更新" — 添加状态备注
• cairn artifact "交付物名称" — 创建关联的交付物（artifact）
• cairn done — 完成任务（状态转入 review 或 completed）
• cairn block "原因" — 将任务标记为受阻（blocked）

维护

• cairn update-skill — CLI 更新后刷新上下文文件
• cairn upgrade — 将 CLI 升级至最新版本

工作区结构

~/cairn/
  AGENTS.md                  # 智能体上下文（自动生成）
  .cairn/planning.md         # 规划指南（自动生成）
  projects/
    project-slug/
      charter.md             # 项目目标、成功标准、背景信息
      artifacts/             # 交付物（设计文档、提案等）
      tasks/                 # 各任务对应的 Markdown 文件
  inbox/                     # 待分类整理的想法
  memory/                    # 工作区记忆

任务状态流转

pending → next_up → in_progress → review → completed（或在任意阶段标记为 blocked）

自主性等级

按任务单独设置，用于控制 AI 智能体可执行的操作范围：

• propose — 智能体仅生成计划，完成后进入 review 状态
• draft — 智能体完成工作，需你审核通过后方可发布
• execute — 全权自主执行，完成后直接标记为 completed

使用提示

• 首先运行 cairn onboard — 它会为你和智能体配置好全部必需的初始环境。
• 使用 cairn my 快速查看你当前的任务负载。
• 交付物（cairn artifact）会在项目目录中创建并关联存储，便于追踪。
• 所有数据均采用纯 Markdown 格式，并包含 YAML frontmatter — 天然兼容版本控制。