Claude 指令：Startup-Check Skill

Claude 指令：Startup-Check

此命令在 Claude Code session 開始時執行環境檢查，並偵測待恢復的 handoff 任務。

使用方法

/startup-check

系統指令

你是 Claude Code Session 啟動檢查專家。執行以下檢查流程，按順序完成每個步驟。

Step 1: Handoff 待恢復任務偵測

最高優先級：先檢查是否有待恢復的 handoff 任務。

執行以下步驟：

掃描 .claude/handoff/pending/ 目錄中的所有 .json 檔案
過濾條件：resumed_at 欄位為 null（表示尚未接手）
如果找到待恢復任務：

有待恢復任務時：

對每個待恢復任務：

a. 讀取 handoff JSON 檔案，取得 ticket_id、title、direction b. 從 ticket_id 解析版本號（例如 {version}-W{wave}-{seq} -> v{version}） c. 讀取對應的 Ticket 檔案：docs/work-logs/v{version}/tickets/{ticket_id}.md d. 輸出完整的 Ticket 內容到對話中

輸出格式：

============================================================
[Handoff 任務恢復] 偵測到 N 個待恢復任務
============================================================

任務: {ticket_id} - {title}
方向: {direction}

--- Ticket 完整內容 ---
{Ticket 檔案完整內容}
--- End ---

建議動作：
1. 執行 /ticket track claim {ticket_id} 認領任務
2. 根據 Ticket 內容繼續執行

============================================================

然後直接開始恢復任務：

讀取 Ticket 的 frontmatter 了解任務狀態和 TDD 階段
根據 Ticket 內容判斷下一步動作
主動開始執行（無需等待用戶額外指令）

無待恢復任務時：跳過此步驟，繼續 Step 2。

Step 2: Git 環境檢查

執行以下指令並分析結果：

git status --porcelain
git branch --show-current
git log --oneline -3

預期結果：

工作目錄狀態（乾淨或有未提交變更）
當前分支名稱
最近 3 次提交

Step 3: 開發狀態檢查

確認以下項目：

關鍵檔案存在性（CLAUDE.md、FLUTTER.md、pubspec.yaml）
最後測試執行時間（如可取得）

Step 4: 輸出報告

彙整所有檢查結果，輸出簡潔的環境狀態報告。

=== Session 啟動檢查報告 ===

Handoff: {有/無} 待恢復任務
Git: {分支名} | {狀態}
環境: {正常/異常}

{如有 handoff 任務，已在 Step 1 輸出完整內容}

與 Hook 的協作邊界

| 元件 | 職責 | 觸發方式 | |------|------|---------| | startup-check SKILL | 主動恢復：讀取 Ticket 完整內容到主對話流 | 用戶執行 /startup-check | | handoff-reminder-hook | 提醒：SessionStart 時顯示簡短提醒 | 自動（SessionStart） | | handoff-prompt-reminder-hook | 備用注入：UserPromptSubmit 時注入 context | 自動（UserPromptSubmit） |

設計原則：

SKILL 輸出在主對話流中，Claude 會自然處理並主動執行
Hook 輸出在 system-reminder 中，作為備用提醒
兩者可共存，SKILL 提供最佳體驗，Hook 提供安全網

Last Updated: 2026-03-02 Version: 1.0.0

Agent Skills: Claude 指令：Startup-Check

Install this agent skill to your local

Skill Files