名称： cairn
描述： 使用 Markdown 文件进行 AI 智能体项目管理。安装并使用 cairn CLI 来创建项目、管理任务、跟踪状态，并通过共享的 Markdown 文件工作空间协调人机协作。

Cairn — AI 原生项目管理

Cairn 为您和您的 AI 智能体提供了一个共享的 Markdown 文件工作空间，用于管理项目和任务。状态是共享的语言。任何能够读取文件的 AI 都可以立即投入使用。

安装

npm install -g cairn-work
cairn onboard

运行 cairn onboard 会创建 ~/cairn/ 目录，并生成供智能体自动读取的上下文文件（AGENTS.md 和 .cairn/planning.md）。

社区

• 在 X 上关注 @letcairnwork
• 访问网站 letcairn.work
• 提交问题
• 参与讨论

核心命令

工作空间

• cairn status — 概览，显示任务数量
• cairn my — 查看分配给您的任务
• cairn active — 查看所有进行中的任务
• cairn doctor — 诊断工作空间健康状况

项目与任务

• cairn create project "项目名称" --description "..." --objective "..." — 创建项目及其章程
• cairn create task "任务名称" --project <项目标识> --description "..." --objective "..." — 创建任务
• cairn list tasks [--status pending,in_progress] [--project 项目标识] — 列出任务（支持状态和项目筛选）
• cairn search "关键词" — 按内容搜索任务

任务工作流

• cairn start <任务标识> — 开始工作（状态设为 in_progress）
• cairn note <任务标识> "进度更新" — 添加状态备注
• cairn artifact <任务标识> "产出物名称" — 创建链接的交付物
• cairn done <任务标识> — 完成工作（移至 review 或 completed）
• cairn block <任务标识> "原因" — 标记为受阻

维护

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

工作空间结构

~/cairn/
  AGENTS.md                  # 智能体上下文（自动生成）
  .cairn/planning.md         # 规划指南（自动生成）
  projects/
    项目标识/
      charter.md             # 项目章程：原因、成功标准、背景
      artifacts/             # 交付物（设计文档、提案等）
      tasks/                 # 单个任务的 Markdown 文件
  inbox/                     # 待分类的想法
  memory/                    # 工作空间记忆

任务状态

pending（待处理） → next_up（待启动） → in_progress（进行中） → review（审核中） → completed（已完成）（或在任意阶段变为 blocked（受阻））

自主级别

可为每个任务设置，以控制智能体的操作权限：
- propose（提议） — 仅由智能体规划，任务最终状态为 review
- draft（草稿） — 智能体执行工作，但需您批准后才能交付
- execute（执行） — 完全自主，任务直接完成并标记为 completed

使用提示

• 首先运行 cairn onboard — 它会设置智能体所需的一切。
• 使用 cairn my 快速查看您当前的工作负载。
• 产出物命令（cairn artifact）会创建与项目关联的交付物文件。
• 所有数据均为带有 YAML 前言的纯 Markdown 格式 — 对版本控制友好。