kanban-ai

Kanban AI スキル

kanban/ ディレクトリ内の Markdown ファイルとして Kanban ボードを管理します。各ファイルがカードです。すべてのカードファイルを読み込み、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 に移動するときは、今後読む人がカードの経緯と結果を理解できるよう、十分なナラティブの詳細を追加してください。冗長にならない範囲で、一貫性があり完結した内容にしてください。

カードのフィールド

各カードのフロントマターでは、以下のフィールドを使用できます。

• 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 を使用してください。

可能であれば、「When [状況], I want to [動機], so I can [期待する成果].」の構成を使ってジョブストーリーを含めてください。無理に追加する必要はありません。適している場合にのみ追加してください。追加した場合は、依頼者に共有して確認してください。

---
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.

カードの移動

フロントマターの status フィールドを更新します。

doing に移動する前に、blocked_by に含まれるすべての ID のステータスが done であることを確認してください。done でないものがあれば、カードはそのままにします。

status: done のカードは、メインボードを整理された状態に保つため、kanban/archived/ に移動できます。これはファイルの場所のみを移動する操作です。明示的に変更されない限り、カードは status: done の通常のカードとして維持してください。 kanban/archived/ が存在しない場合は、カードを移動する前に、アクティブなカードのフォルダー（kanban/）内に作成してください。

ボードの表示

ヘルパースクリプトは、このスキルファイルと同じ場所にある scripts/ ディレクトリに同梱されています。スクリプトを探すには、インストール済みプラグイン内でこのスキルのディレクトリを見つけてください（例：**/kanban-ai/scripts/view_board.sh に対して glob を使用します）。

ボード表示スクリプトを実行します。

bash <SCRIPTS_DIR>/view_board.sh kanban/

ステータス列ごとにカードをグループ化して出力し、優先度と 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/ ディレクトリを指します。すべてのスクリプトは、最初の引数として Kanban ディレクトリを受け取ります。省略した場合は、カレントディレクトリがデフォルトとして使用されます。