{
"markdown": "# 式神 Shikigami — AI Agent Scrum Team 框架\n\n\n\n\n\n\n**為你的 AI 開發工具注入 8 個專業角色，涵蓋 Discovery → Definition → Delivery 全產品生命週期。**\n\n### 🆕 v0.119.0 更新（Sprint 183）\n\n| 新功能 | 說明 |\n|--------|------|\n| **Issue 建立安全封裝** | `scripts/gh-issue-create.sh`：強制 `--body-file` 模式，防止特殊字元截斷（紅線 #13 強化） |\n| **禁用軟性字樣清單** | Architect / QA prompt 新增 8 條禁用詞表（考慮、適當、合理…），PO Round 1 自動自檢 |\n| **Agent fallback 驗證** | `dispatch-with-fallback.sh` + ADR-046：偵測 HTTP 429 / 5xx / Policy Refusal，自動切換模型 |\n| **ADR 歸檔政策** | `audit-adr-references.sh`（ACTIVE / DOCS-ONLY / DORMANT / SUPERSEDED 分類）+ ADR-009 已歸檔 |\n| **L-size 自動 Refinement** | 排程模式下 L-size sprint-candidate 觀察期達標後，Cruise Patrol 自動觸發 Architect 拆解 |\n\n```\n/plugin marketplace add KCTW/shikigami\n/plugin install shikigami\n```\n\n> 安裝後對 Claude 說：`幫我初始化 Shikigami` — Scrum Master 會接手引導。\n\n---\n\n## Quick Start\n\n### 前置條件\n\n- 已安裝 [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)\n- 已完成 Claude Code 帳號認證（可正常對話）\n\n### 安裝（Claude Code）\n\n在 Claude Code 互動介面中輸入：\n\n```\n/plugin marketplace add KCTW/shikigami\n/plugin install shikigami\n```\n\n安裝後重啟 Claude Code，在你的專案目錄說：\n\n```\n幫我初始化 Shikigami\n```\n\nScrum Master 會建立 `CLAUDE.md` 與 `docs/` 目錄結構，完成後即可開始。\n\n#### 啟用版本驗證 Git Hook（選用）\n\nShikigami 提供 pre-commit hook，在 commit 前自動驗證版號一致性：\n\n```bash\ngit config core.hooksPath .githooks\n```\n\n啟用後，每次 `git commit` 前會自動執行 `bash scripts/validate-version.sh`，版號不一致時阻止 commit。\n\n### 其他平台\n\n| 平台 | 安裝指令 | 安裝指南 |\n|------|----------|----------|\n| **OpenCode** | symlink 適配策略 | [docs/INSTALL_OPENCODE.md](docs/INSTALL_OPENCODE.md) |\n| **Gemini CLI** | `gemini extensions install https://github.com/KCTW/shikigami` | [docs/INSTALL_GEMINI.md](docs/INSTALL_GEMINI.md) |\n| **Cursor** | `bash scripts/install-cursor.sh` | [docs/INSTALL_CURSOR.md](docs/INSTALL_CURSOR.md) |\n\n---\n\n## 這能解決什麼問題？\n\n你一個人開發，需求靠腦補、寫完的代碼沒人 review，架構決策靠直覺，安全問題等上線才發現。\n\nShikigami 注入 8 個角色，覆蓋產品從**探索到上線**的完整流程：\n\n- **Discovery**：PO 驅動產品探索，Product Brief 標準化格式 + 假設外顯化 + PO 確認關卡\n- **Definition**：Backlog 管理、Sprint Planning、架構決策（ADR）\n- **Delivery**：TDD 開發、QA 雙階段審查、Security 掃描、SRE 部署\n- **Design**：UI/UX Designer 透過 Figma MCP 執行設計，Vision Critic 自審視覺品質\n- **多 Session 協調**：跨機器多團隊並行開發 — Issue 級 claim + 檔案級鎖定 + Session crash 斷點續跑 + PR-based code review\n- **績效可視化**：會議紀錄、出勤時數、探索紀錄自動收集，`/performance-dashboard` 一指令查看當日工作成果\n\n角色之間**互相制衡**，不是 8 個獨立助手。**不需要記指令**，用自然語言說你要做什麼，Scrum Master 自動調度。\n\n---\n\n## 使用情境\n\n### 情境 1：我有一個模糊的想法，想確認該不該做\n\n```\n我想加一個使用者登入功能，但不確定要用哪種方式\n```\n\nShikigami 觸發 Discovery Phase：PO 產出 Product Brief（問題陳述 + 商業假設 + 驗證方法），Architect 評估技術可行性，PO 簽核後自動轉為 Backlog Issues。從探索到可執行 Story，全程結構化。\n\n### 情境 2：我想讓 AI 執行代碼審查，而不只是給建議\n\n```\n開始 Sprint / 實作 Story A\n```\n\nDeveloper subagent 依照 TDD 流程實作（Red → Green → Refactor），完成後 QA subagent 自動執行雙階段審查（Spec Compliance + Code Quality）。任何不符合 AC 的代碼都會在合併前被攔截。\n\n\n更多使用情境範例（Sprint 開發循環、Issue 管理、架構決策）
\n\n### Sprint 開發循環\n\n```\n開始 Sprint\n\nScrum Master → 觸發 sprint-planning\nPO：從 Backlog 選取 Stories\nArchitect：技術估算\nQA：AC 可測試性確認\nPO：Sprint 文件已建立 → docs/sprints/sprint_N.md\n\n實作 Story A\n\nDeveloper subagent：\n Red — 寫失敗測試\n Green — 最小實作通過\n Refactor — 重構優化\n commit: \"test: 新增功能測試\"\n commit: \"feat: 實作核心邏輯\"\n\nQA subagent（Spec Review）：所有 AC 通過\nQA subagent（Code Quality）：品質門禁通過\n```\n\n### Issue 管理\n\n```\n幫我分類一下 GitHub Issues\n\nPO subagent：\n gh issue list --search \"no:label\" → 找到 5 個未分類 issues\n 分類結果：\n #12 登入失敗 | bug | 已要求補充重現步驟\n #13 希望支援匯出 | feature-request | —\n #14 怎麼安裝？ | question | 已引導至 README\n Labels 已自動套用\n```\n\n### 架構決策\n\n```\n資料庫要用 PostgreSQL 還是 SQLite？\n\nArchitect subagent：\n 建立 ADR-002\n 選項 A：PostgreSQL — 擴展性強，維運成本高\n 選項 B：SQLite — 零配置，單檔案，不適合高併發\n 建議：採用 SQLite（MVP 階段，KISS 原則）\n\nQA subagent（Decision Challenger）：\n 為 PostgreSQL 辯護：未來遷移成本可能很高\n 結論：同意 SQLite，但建議抽象 DB 層以降低遷移風險\n\nArchitect：ADR-002 狀態 → Accepted\n```\n\n \n\n---\n\n## 功能概覽\n\n### 8 個角色\n\n| 角色 | 職責 |\n|---|---|\n| **Product Owner** | 需求定義、優先級決策、Backlog 管理 |\n| **Architect** | 架構決策、SDD 撰寫、技術選型 |\n| **Developer** | 功能實作、TDD 開發、Bug 修復 |\n| **QA Engineer** | 代碼審查、測試策略、品質把關 |\n| **Security Engineer** | 安全掃描、漏洞評估、OWASP 檢查 |\n| **SRE Engineer** | 部署檢查、監控配置、環境管理 |\n| **UI/UX Designer** | 設計系統維護、Figma 原型製作、視覺品質審查 |\n| **Stakeholder** | 最終仲裁、打破僵局 |\n\n**重點：它們互相制衡，不是 8 個獨立助手。**\n\n\n完整 31 個 Skills 列表
\n\n**Discovery（產品探索）**\n\n| Skill | 說明 |\n|---|---|\n| **discovery-phase** | Product Discovery 獨立入口、Product Brief 標準化格式、假設外顯化、PO 確認關卡 |\n\n**Definition（需求定義與 Sprint 管理）**\n\n| Skill | 說明 |\n|---|---|\n| **scrum-master** | 自動調度 Agent Scrum Team 的角色分工與 Sprint 流程 |\n| **sprint-planning** | 啟動新 Sprint、從 Backlog 選取 Stories、規劃 Sprint 目標 |\n| **backlog-management** | Backlog 梳理、需求變更管理 |\n| **escalation** | 團隊衝突無法解決、重大產品轉向、升級鏈啟動 |\n\n**Delivery（開發與交付）**\n\n| Skill | 說明 |\n|---|---|\n| **sprint-execution** | 執行 Sprint Stories、功能實作、處理 Sprint Backlog |\n| **sprint-review** | Sprint 結束時進行回顧與驗收、評估 Sprint 成果 |\n| **architecture-decision** | 技術決策、架構審查、技術選型、ADR 撰寫 |\n| **quality-gate** | 代碼審查、功能驗收、PR 檢查、品質指標檢測 |\n| **security-review** | 外部輸入處理、API 安全、配置安全、漏洞評估 |\n| **deployment-readiness** | 部署準備、版本發布、環境配置、生產就緒檢查 |\n| **systematic-debugging** | Bug 排查、測試失敗分析、系統化除錯流程 |\n| **dispel** | Legacy 系統考古、不熟悉 codebase 分析、解咒模式 |\n| **architect** | Architect 角色知識框架、架構評估決策指引 |\n| **qa-engineer** | QA 角色知識框架、審查策略與 Story-Lifecycle 整合指引 |\n| **team-debate** | 同職能 Critic Agent 對 M/L Stories 的獨立 peer critique |\n\n**Design（設計）**\n\n| Skill | 說明 |\n|---|---|\n| **uiux-designer** | UI/UX Designer 角色定義、Design Foundation 流程、Figma MCP 整合 |\n| **vision-critic** | UI 截圖多維度視覺一致性評分，產出 PASS/FAIL 報告與可執行修正建議 |\n\n**工具整合**\n\n| Skill | 說明 |\n|---|---|\n| **git-workflow** | 分支隔離、Worktree 管理、開發完成後的合併/PR 流程 |\n| **parallel-dispatch** | 多個獨立任務的平行 Subagent 派遣，含同檔案衝突偵測與自動序列化 |\n| **issue-management** | GitHub Issue 管理、自動分類、回覆、Issue 轉 Backlog |\n| **health-check** | 框架自我診斷、結構完整性檢查、逾期 Action Items 偵測 |\n| **doctor** | 消費端專案 Shikigami 設定健康診斷、自動修復 |\n| **onboarding** | 新專案初始化、目錄結構建立、CLAUDE.md 生成引導 |\n| **schedule** | Sprint 自動排程執行、cron 腳本生成、序列排程保護 |\n| **shoot** | 短衝模式、單 Story 快速執行、不起 Sprint 的輕量交付 |\n| **browser-automation** | Web 應用瀏覽器自動化測試與驗證、E2E 測試、Synthetic Monitoring |\n| **cruise** | PO 定期巡邏 + SRE 基礎設施巡檢的背景自動化模式（支援 cron 排程） |\n| **debate** | D3 Framework 結構化辯論與決策（Debate-Deliberate-Decide） |\n| **performance-dashboard** | 團隊績效報告生成（出勤、探索紀錄、會議摘要） |\n| **diagram** | 架構圖自動化生成（drawio-mcp-server stdio 整合、雙格式輸出、多雲圖標集） |\n\n \n\n---\n\n## 進階設定\n\n### 專案配置（CLAUDE.md）\n\n安裝 plugin 後，將 `templates/CLAUDE.md.template` 複製到你的專案根目錄：\n\n```bash\ncp templates/CLAUDE.md.template ./CLAUDE.md\n```\n\n根據你的專案調整：專案名稱與技術棧、開發紅線、文件目錄結構、快速啟動指令。\n\n### 專案等級（自治策略）\n\n在 `CLAUDE.md` 中設定 AI 團隊的自治程度：\n\n```\nshikigami.project_level: medium\n```\n\n| 等級 | 適用場景 | 行為 |\n|------|----------|------|\n| **low** | 個人專案、實驗 | 完全自治，所有操作自動執行 |\n| **medium**（預設） | 一般開發專案 | 低風險自動，高風險由 QA 審核後自動執行 |\n| **high** | 重要產品、公開 repo | 低風險自動，高風險需人工確認 |\n\n---\n\n## 文件導覽\n\n| 文件 | 用途 |\n|------|------|\n| [入門教學](docs/tutorial/GETTING_STARTED.md) | 從安裝到第一個 Sprint 的完整端對端步驟指引 |\n| [Troubleshooting 指南](docs/tutorial/TROUBLESHOOTING.md) | 6 個常見失敗情境排查指南 |\n| [版本歷程](docs/CHANGELOG.md) | 完整版本演進與 Sprint 紀錄 |\n| [OpenCode 安裝](docs/INSTALL_OPENCODE.md) | OpenCode 平台詳細安裝步驟 |\n| [Gemini CLI 安裝](docs/INSTALL_GEMINI.md) | Gemini CLI 平台詳細安裝步驟 |\n| [Cursor 安裝](docs/INSTALL_CURSOR.md) | Cursor 平台詳細安裝步驟 |\n\n---\n\n## 自動巡航模式（Cruise + Cron）\n\n設定後 Shikigami 全自動運作 — 巡邏 Issues、觸發 Sprint、執行 Stories、Review、版本發布，無需人工介入：\n\n```bash\n/schedule cruise --interval 15m\n```\n\n每 15 分鐘啟動一個乾淨 session 執行 `/cruise --once`，flock 防重複，每次 session 獨立（無 context 汙染）。\n\n```bash\n# 查看即時狀態\ntail -f logs/schedule-cruise.log\n\n# 查看 subagent 動態\ntail -f logs/live/*.log\n\n# 停止排程\n/schedule cruise --remove\n```\n\n---\n\n## 授權\n\n本專案採用 **MIT License** 開放原始碼授權。\n\n你可以自由地：\n- ✅ 商業使用（Commercial use）\n- ✅ 修改（Modification）\n- ✅ 散布（Distribution）\n- ✅ 私人使用（Private use）\n\n唯一條件：保留原始的著作權聲明與 MIT 授權文件。\n\n完整授權條款：[LICENSE](LICENSE) ｜ Copyright (c) 2026 KCTW\n\n---\n\n## 貢獻與社群\n\n- 遇到問題或有功能建議？[開 Issue](https://github.com/kctw-dev/shikigami/issues/new)\n- 想了解框架演進？查看 [CHANGELOG](docs/CHANGELOG.md) 與 [ADR 目錄](docs/adr/README.md)\n- Shikigami 本身就用 Shikigami 開發 🪄\n",
"bytes": 8241,
"sha": "0f5eff48ed1d6dfc8c3341a046e442438ab4902d802783232f8ed523013762ce",
"repo_slug": "kctw-dev/shikigami",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/plg_kctw_dev_shikigami_2047d506/readme"
}