用途
Kanban AI 用于把看板作为一组 Markdown 文件来管理。看板目录为 kanban/，其中每个文件是一张卡片，已完成卡片放在 kanban/archived/。看板状态不是单独存储的，而是通过读取所有卡片文件并按 status 分组推导得出。
叙述性记录（必需）
卡片被视为可供未来查阅的持久素材。除非被明确要求，否则不应重写或删除已有的叙述内容。更新卡片时，应在文件末尾的 ## Narrative 段落追加一条简短叙述，重点记录原因、发现、洞察和决策，避免仅记录事务性的状态变更，除非该变更对故事有意义。日期使用 ISO 格式。
叙述条目格式：
## Narrative
- 2026-02-05: Discovered the auth flow must support device-based MFA; shifted approach to use WebAuthn. (by @assistant)
如果卡片没有 ## Narrative 段落，则新增该段落。如果变更很小（例如拼写修正），除非包含有意义的洞察，否则可跳过叙述记录。当卡片移动到 done 时，应补充足够的叙述细节，使未来的读者能理解该卡片的经过与结果，保持连贯完整而不过于冗长。
卡片字段
每张卡片的 frontmatter 支持以下字段：
id— 唯一数字标识。扫描kanban/（包括kanban/archived/）中的现有卡片，取最大值加 1；若为空则从 1 开始。通过该编号引用卡片。status— 列：backlog、todo、doing、done 或 archive。priority— High 或 Normal，省略时默认为 Normal。blocked_by— 卡片 ID 列表，这些卡片必须先 done，当前卡片才能移动到 doing。示例：[3, 7]。若无阻塞则省略或设为[]。assignee— （可选）卡片负责人。due_date— （可选）目标日期。tags— （可选）标签列表。
创建卡片
在 kanban/ 中新建一个 .md 文件，文件名使用 kebab-case。
在合适时，可包含一个 Job Story，结构为“When [situation], I want to [motivation], so I can [expected outcome].”。不要强行添加，仅在合适时使用；如果添加，应与请求者确认。
示例：
---
id: 1
status: todo
priority: Normal
blocked_by: []
assignee: "@claude"
due_date: 2026-02-28
tags: [auth, backend]
---
# Implement User Authentication
Set up user authentication using JWTs.
## Acceptance Criteria
- Users can register for a new account.
- Users can log in with their credentials.
- Authenticated users receive a JWT.
移动卡片
更新 frontmatter 中的 status 字段。
移动到 doing 之前，需校验 blocked_by 中的所有 ID 状态均为 done。若存在未完成者，卡片保持原位。
状态为 done 的卡片可移动到 kanban/archived/ 以保持主看板整洁。这只是文件位置的移动，除非被明确修改，卡片仍应是 status: done 的普通卡片。如果 kanban/archived/ 不存在，应先在活动卡片目录（kanban/）下创建它，再移动卡片。
查看看板
辅助脚本随本技能文件一起放在 scripts/ 目录中。要定位它们，可在已安装插件内查找本技能所在目录（例如使用 glob 查找 **/kanban-ai/scripts/view_board.sh）。
运行看板查看脚本：
bash <SCRIPTS_DIR>/view_board.sh kanban/
输出按状态列分组的卡片，并内联显示优先级和 blocked_by 标记。
搜索与过滤
按标签搜索：
bash <SCRIPTS_DIR>/search_by_tag.sh kanban/ <tag>
输出：具有该标签的卡片（ID、status、title）。
内容搜索：
bash <SCRIPTS_DIR>/search_content.sh kanban/ "<search term>"
输出：匹配搜索词的卡片及上下文行。
显示被阻塞的卡片：
bash <SCRIPTS_DIR>/show_blocked.sh kanban/
输出：blocked_by 字段非空的卡片，以及阻塞它们的内容。
列出所有标签：
bash <SCRIPTS_DIR>/list_tags.sh kanban/
输出：所有标签，按使用次数排序（最常用的在前）。
列出所有卡片：
bash <SCRIPTS_DIR>/list_all_cards.sh kanban/
输出：所有卡片，以管道分隔格式（id|status|blocked_by|title）按 ID 排序。便于解析、调试依赖关系或导出看板状态。
注意：<SCRIPTS_DIR> 指本 SKILL.md 文件旁的 scripts/ 目录。所有脚本都把 kanban 目录作为第一个参数；若省略，则默认使用当前目录。
适用场景与限制
适用于以纯文本、可版本控制的方式维护任务看板，尤其适合需要保留决策脉络、依赖关系和标签检索的协作流。
该技能基于 Markdown 文件与随附脚本运行；除 frontmatter 字段和上述脚本外，资料未提供图形界面、云端同步、权限管理或多用户并发等能力的具体说明。