shikigami

式神 Shikigami — AI Agent Scrum Team 框架

為你的 AI 開發工具注入 8 個專業角色，涵蓋 Discovery → Definition → Delivery 全產品生命週期。

🆕 v0.119.0 更新（Sprint 183）

/plugin marketplace add KCTW/shikigami
/plugin install shikigami

安裝後對 Claude 說：幫我初始化 Shikigami — Scrum Master 會接手引導。

Quick Start

前置條件

• 已安裝 Claude Code CLI
• 已完成 Claude Code 帳號認證（可正常對話）

安裝（Claude Code）

在 Claude Code 互動介面中輸入：

/plugin marketplace add KCTW/shikigami
/plugin install shikigami

安裝後重啟 Claude Code，在你的專案目錄說：

幫我初始化 Shikigami

Scrum Master 會建立 CLAUDE.md 與 docs/ 目錄結構，完成後即可開始。

啟用版本驗證 Git Hook（選用）

Shikigami 提供 pre-commit hook，在 commit 前自動驗證版號一致性：

git config core.hooksPath .githooks

啟用後，每次 git commit 前會自動執行 bash scripts/validate-version.sh，版號不一致時阻止 commit。

其他平台

這能解決什麼問題？

你一個人開發，需求靠腦補、寫完的代碼沒人 review，架構決策靠直覺，安全問題等上線才發現。

Shikigami 注入 8 個角色，覆蓋產品從探索到上線的完整流程：

• Discovery：PO 驅動產品探索，Product Brief 標準化格式 + 假設外顯化 + PO 確認關卡
• Definition：Backlog 管理、Sprint Planning、架構決策（ADR）
• Delivery：TDD 開發、QA 雙階段審查、Security 掃描、SRE 部署
• Design：UI/UX Designer 透過 Figma MCP 執行設計，Vision Critic 自審視覺品質
• 多 Session 協調：跨機器多團隊並行開發 — Issue 級 claim + 檔案級鎖定 + Session crash 斷點續跑 + PR-based code review
• 績效可視化：會議紀錄、出勤時數、探索紀錄自動收集，/performance-dashboard 一指令查看當日工作成果

角色之間互相制衡，不是 8 個獨立助手。不需要記指令，用自然語言說你要做什麼，Scrum Master 自動調度。

使用情境

情境 1：我有一個模糊的想法，想確認該不該做

我想加一個使用者登入功能，但不確定要用哪種方式

Shikigami 觸發 Discovery Phase：PO 產出 Product Brief（問題陳述 + 商業假設 + 驗證方法），Architect 評估技術可行性，PO 簽核後自動轉為 Backlog Issues。從探索到可執行 Story，全程結構化。

情境 2：我想讓 AI 執行代碼審查，而不只是給建議

開始 Sprint / 實作 Story A

Developer subagent 依照 TDD 流程實作（Red → Green → Refactor），完成後 QA subagent 自動執行雙階段審查（Spec Compliance + Code Quality）。任何不符合 AC 的代碼都會在合併前被攔截。

開始 Sprint

Scrum Master → 觸發 sprint-planning
PO：從 Backlog 選取 Stories
Architect：技術估算
QA：AC 可測試性確認
PO：Sprint 文件已建立 → docs/sprints/sprint_N.md

實作 Story A

Developer subagent：
  Red — 寫失敗測試
  Green — 最小實作通過
  Refactor — 重構優化
  commit: "test: 新增功能測試"
  commit: "feat: 實作核心邏輯"

QA subagent（Spec Review）：所有 AC 通過
QA subagent（Code Quality）：品質門禁通過

幫我分類一下 GitHub Issues

PO subagent：
  gh issue list --search "no:label" → 找到 5 個未分類 issues
  分類結果：
    #12 登入失敗      | bug             | 已要求補充重現步驟
    #13 希望支援匯出  | feature-request | —
    #14 怎麼安裝？    | question        | 已引導至 README
  Labels 已自動套用

資料庫要用 PostgreSQL 還是 SQLite？

Architect subagent：
  建立 ADR-002
  選項 A：PostgreSQL — 擴展性強，維運成本高
  選項 B：SQLite — 零配置，單檔案，不適合高併發
  建議：採用 SQLite（MVP 階段，KISS 原則）

QA subagent（Decision Challenger）：
  為 PostgreSQL 辯護：未來遷移成本可能很高
  結論：同意 SQLite，但建議抽象 DB 層以降低遷移風險

Architect：ADR-002 狀態 → Accepted

功能概覽

8 個角色

重點：它們互相制衡，不是 8 個獨立助手。