核心用法
Cairn 是一款专为 AI 代理与人类协作设计的项目管理 CLI 工具，通过纯 Markdown 文件架构实现透明、可版本控制的工作空间。用户通过 npm install -g cairn-work 安装后，运行 cairn onboard 即可在 ~/cairn/ 目录生成包含 AGENTS.md 和 .cairn/planning.md 的初始化环境，为 AI 代理提供自动读取的上下文。
核心工作流围绕状态驱动的任务管理展开：从 pending → in_progress → review → completed，支持 blocked 中断状态。用户可通过 cairn create project 和 cairn create task 建立项目章程与任务文件，利用 cairn start/note/done 等命令推进工作。cairn artifact 命令可创建链接式交付物，cairn search 支持内容检索。
自主级别控制是 Cairn 的差异化设计：
- propose：AI 仅规划，完成后进入人工审核
- draft：AI 执行工作，需人类批准才能交付
- execute：完全自主，完成后直接标记完成
显著优点
1. AI 原生架构：Markdown + YAML frontmatter 格式天然适合 LLM 上下文窗口，任何能读取文件的 AI 均可直接参与
2. 完全本地与可版本控制：纯文本存储，天然支持 Git 协作与历史追溯
3. 零 vendor lock-in：数据格式开放，不依赖特定平台 API
4. 状态语义明确：标准化的状态流转降低人机沟通成本
5. 轻量 CLI 体验：无需复杂 GUI，适合开发者与 AI 代理脚本化操作
潜在缺点与局限性
1. 非实时协作：基于文件轮询或显式命令，无实时同步机制
2. 学习曲线：需要理解 Markdown 结构、slug 命名、状态机等概念
3. 缺乏可视化：纯 CLI 界面，无看板、甘特图等经典项目管理视图
4. 权限控制有限：自主级别仅三档，无细粒度角色权限（如只读、评论等）
5. 生态早期：社区规模尚小，集成生态（Slack、Notion、Jira 等）待观察
适合人群
- AI 辅助编程/写作的深度用户，希望建立结构化工作流
- 偏好本地优先、隐私敏感的技术团队
- 需要人类-AI 混合审核流程的项目（如内容审核、代码审查）
- 厌倦传统 SaaS 项目管理工具锁定、追求数据主权的开发者
常规风险
- 数据丢失风险：虽支持 Git，但用户需自行配置备份策略
- AI 行为不可预测：
execute模式下 AI 可能产生不符合预期的输出，需配合cairn block及时干预 - 版本兼容性：CLI 更新后需运行
cairn update-skill刷新上下文文件 - 权限边界模糊：多 Agent 共享工作空间时，需明确约定谁可修改哪些文件