kanban-ai

看板 AI 技能

在 kanban/ 目录下以 Markdown 文件的形式管理看板。每个文件就是一张卡片。看板状态通过读取所有卡片文件并按 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 — 在这张卡片移动到 doing 之前必须为 done 的卡片 ID 列表。例如：[3, 7]。如果无阻塞则省略或设置为 []。
• assignee — （可选）卡片负责人。
• due_date — （可选）目标日期。
• tags — （可选）标签列表。

创建卡片

在 kanban/ 中创建一个新的 .md 文件。文件名应使用 kebab-case。

如有可能，加入一个采用“当 [情况] 时，我想要 [动机]，以便我能够 [预期结果]。”结构的 Job Story。不要强行套用；只在合适时添加。如果你添加了一个，请与提出需求的人分享以确认。

---
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，卡片保持原位。

status: done 的卡片可以被移动到 kanban/archived/，以保持主看板整洁。这只是文件位置的移动；除非明确更改，卡片应保持为一张 status: done 的普通卡片。 如果 kanban/archived/ 不存在，则在移动卡片之前，在活动卡片文件夹（kanban/）下创建它。

查看看板

辅助脚本与本技能文件一起捆绑在 scripts/ 目录中。要找到它们，请在已安装的插件中定位此技能所在目录（例如，使用 glob 查找 **/kanban-ai/scripts/view_board.sh）。

运行看板查看脚本：

bash <SCRIPTS_DIR>/view_board.sh kanban/

按状态列分组输出卡片，并内联显示 priority 和 blocked_by 标记。

搜索和筛选

按标签搜索

bash <SCRIPTS_DIR>/search_by_tag.sh kanban/ <tag>

输出：具有该标签的卡片（ID、状态、标题）

搜索内容

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/ 目录。所有脚本都将看板目录作为第一个参数。如果省略，它们默认为当前目录。