零摩擦使用：只需引入项目入口，然后描述任务

步骤1: 在对话中引入 @projects/EXAMPLE/index.md
步骤2: 告诉 AI "帮我实现用户登录功能"
步骤3: 完成 — AI 自动创建任务文档、执行、更新状态

想先看效果？查看示例项目：projects/EXAMPLE/（含进行中任务 + 归档示例）

AI-TASK 是一套面向 AI 协作的文件系统约定：用统一的目录结构、任务模板和技能系统，把你在多个项目中的 AI 协作过程沉淀为可复用的"路书"。

AI-TASK 是 DDAC 方法论的落地实现。详见 docs/ARCHITECTURE.md。

适用：单人（或极小团队）、多项目并行、跨设备切换、用 Markdown 沉淀协作过程。 不适用：强依赖看板/通知/权限/指派的团队协作。

• 支持 AI 协作的 IDE（Claude Code / CodeBuddy / Cursor 等）
• macOS 或 Linux（软链接支持最好，Windows 需额外配置）
• Git（可选，用于版本管理）

在 AI 助手中说：

帮我安装并初始化 AI-TASK 协作系统 仓库地址：https://github.com/ArnoFrost/AI-TASK

或直接执行：

curl -fsSL https://raw.githubusercontent.com/ArnoFrost/AI-TASK/main/setup.sh | bash

AI 会自动完成：克隆仓库 → 选择安装路径 → 初始化项目 → 注入技能

1. 克隆仓库

   git clone https://github.com/ArnoFrost/AI-TASK.git ~/AI-TASK

2. 初始化项目空间

   cd ~/AI-TASK
   ./init-project.sh

3. 开始协作 — 在 AI 助手中引入项目入口：

   @projects/MYAPP/index.md
   帮我实现用户登录功能
   

4. 注入开源技能（可选）

   ./install-skills.sh

斜杠命令通过个人技能库扩展，详见 skills/README.md

graph TB
    subgraph REPO["AI-TASK 仓库"]
        direction TB
        PROJECTS["projects/"]
        SKILLS["skills/"]
        TEMPLATES["templates/"]

        subgraph SPACES["项目协作空间"]
            P1["项目A/"] --> P1T["tasks/"]
            P2["项目B/"] --> P2T["tasks/"]
        end

        PROJECTS --> P1
        PROJECTS --> P2
    end

    subgraph REAL["你的真实项目"]
        EXT1["~/Projects/app-a/"]
        EXT2["~/Projects/app-b/"]
    end

    EXT1 -.->|"软链接"| P1
    EXT2 -.->|"软链接"| P2

    style REPO fill:#e1f5fe,stroke:#90caf9
    style SPACES fill:#fff3e0,stroke:#ffcc80
    style REAL fill:#f3e5f5,stroke:#ce93d8

完整架构说明、目录结构详解、软链接原理、任务标签列表 → docs/ARCHITECTURE.md

• 跨设备同步冲突：避免同时编辑同一任务文件；冲突副本以任务编号为准手动合并
• 软链接跨平台差异：macOS/Linux 体验最好，Windows 可能需要额外权限
• 不是团队任务平台：偏"个人工作台 + 路书沉淀"，无看板/权限/指派

欢迎贡献！请参阅 CONTRIBUTING.md。

MIT License — 详见 LICENSE。