kan

一个基于文件、版本可控的看板工具,专为开发者设计。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:kan。
它的用途是:一个基于文件、版本可控的看板工具,专为开发者设计。
完整的 Skill 内容见:https://321skill.com/skills/kan/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我把‘修复登录页面的样式问题’这个任务添加到当前项目的看板中,并放到‘进行中’列。”,AI 会调用 Kan 的 CLI 执行 `kan add "修复登录页面的样式问题"` 和 `kan edit <卡片ID> -c doing` 等命令来完成操作。或者,你可以直接让 AI “列出当前看板上所有未完成的任务”,AI 会使用 `kan list` 并过滤状态来反馈给你。

介绍

Kan 解决了开发者在项目管理中,看板数据与代码仓库分离、依赖外部服务或网络的问题。它是一个将看板数据以纯文件形式存储在项目仓库中的工具,运行 kan serve 即可启动本地 Web 界面,或直接使用 CLI 进行快速操作。

使用非常简单,在项目根目录执行 kan init 初始化看板,然后 kan serve 即可在浏览器中打开交互式界面进行拖拽管理。对于自动化场景,其完整的 CLI 支持通过脚本添加、编辑、列出卡片等操作。

它非常适合需要将任务管理与代码版本控制紧密结合的开发者,尤其是独立开发者、小型团队或同时处理多个项目的工程师。项目看板随代码库走,切换项目时能立刻回到上次的工作上下文。

建议将其用于跟踪代码特性开发、Bug修复等与仓库强相关的任务。由于数据存储在 .kan/ 目录下,请注意将其纳入 .gitignore 的排除项,避免误提交个人工作区的临时卡片。

核心特点

核心区别在于数据完全本地化、文件化,看板历史即 Git 历史,无需任何外部账户或网络服务,实现了真正的自包含和版本控制。同时,它原生提供了遵循 Agent Skills 标准的技能文件,AI 编程助手可直接调用其 CLI 管理看板。

注意事项

不适合需要复杂权限管理、实时多用户协作或跨团队大规模使用的场景。

常见问题

Kan 的数据存储在哪里?安全吗?

数据以 JSON 和 TOML 文件形式存储在项目根目录的 `.kan/` 文件夹中,完全本地化,无网络传输,安全性由用户本地环境保障。

AI 助手(如 Claude)能直接使用 Kan 吗?

可以,Kan 附带了标准的 Agent Skill 文件,AI 编码助手可以直接调用其 CLI 命令来添加、移动或查看看板任务。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/kan/raw/index.md 读取 kan 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。