菜单
在 Heptabase 建立符合 Sprint whiteboard 標準格式的任務卡片。 當使用者說「建立任務卡片」「新增 sprint card」「create task card」「加一張卡到 sprint」， 或要把計畫拆解成子任務時立即觸發。 支援批次建立多張卡片，並在每張卡片的 `## Depends on` section 標記依賴關係， 讓 /start-day skill 可正確解析。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Document codebase as-is via parallel sub-agents. Use when researching how code works, mapping architecture, or answering questions about existing systems. Auto-detects thoughts/ directory — if present, integrates historical context and syncs; if absent, skips those steps.
Create the Questions artifact before codebase research, design, planning, or implementation. Use for feature tickets, architecture changes, unclear code work, CRISPY/QRSPI Questions phase, or when the agent needs to define code-answerable unknowns and human questions before researching or planning.
Create a concise Design Concept artifact after questions and codebase research are available. Use for CRISPY/QRSPI Design phase, architecture alignment, feature design discussion, or turning current-state research into a small human-reviewable proposed shape before detailed planning.
Create an interface-first Structure Outline before detailed planning or implementation. Use for CRISPY/QRSPI Structure Outline phase, vertical planning, method signatures, type contracts, API/component boundaries, or converting an accepted design concept into end-to-end slices with verification checkpoints.
Create comprehensive handoff documents for transferring work to another agent session. Use when the user requests to create a handoff, end a session, or document work-in-progress for future continuation.
Create detailed implementation plans through interactive research and iteration. Use when starting a new feature or ticket that needs a comprehensive technical plan. Saves plans to the repo-appropriate plans location and emits Personal Knowledge events when applicable.
| name | heptabase-task-card |
| description | 在 Heptabase 建立符合 Sprint whiteboard 標準格式的任務卡片。 當使用者說「建立任務卡片」「新增 sprint card」「create task card」「加一張卡到 sprint」， 或要把計畫拆解成子任務時立即觸發。 支援批次建立多張卡片，並在每張卡片的 `## Depends on` section 標記依賴關係， 讓 /start-day skill 可正確解析。 |
# [type] 任務標題
---
## Task Context
- Goal: {一句話說明目標}
- Description:
- What: {要做什麼，核心工作範圍}
- Expected: {完成後的預期狀態或可驗證結果}
---
## Related Source
- {描述}: `{.md 文件路徑}`
---
## Note
- {補充說明，無則留空}
---
## Depends on
- {依賴的任務卡片完整標題}
- 或 nothing（此任務無前置依賴）
type 可選值：feature / fix / debug / refactor / report / doc / test / archi / harness / research / auto
Goal：一句話，說明「做完這個任務，達成什麼結果」。
Description：用結構化 bullet list 呈現，每個 label 一行：
What: 要做什麼，核心工作範圍（一句話）Expected: 完成後的預期狀態或可驗證結果Scope: / Constraint: / Output:
不要列步驟清單或程式碼，細節留在計畫文件（.md）中。Related Source：只放 .md 格式的文件。格式為 {描述}: \{路徑}``，描述說明這份文件的用途，讓人一眼知道要去哪裡查什麼。不放程式碼檔案、JSON、YAML 等。
範例：
## Related Source
- wave 1.5 儲存層外部化主計畫: `thoughts/shared/plans/2026-04-28-wave-1-5-storage-mvp.md`
- 22 個 client 遷移詳細邏輯: `thoughts/shared/plans/2026-04-28-clients-output-unification-migration.md`
Note：任何影響判斷但不屬於 Description 的補充，例如特殊邊界 case、已知限制、待確認事項。
程式符號格式規則：卡片任何欄位中，凡是含有技術符號的詞彙一律用 inline code（backtick）包住，包括但不限於：
--apply、--dry-runoutput/、clients/{c}/{pid}/、_archive/project.yaml、run_manifest.json、final_statusDepends on：卡片完整標題（與依賴卡片的 H1 一致），解析時做 normalize（小寫 + 空白壓縮）後比對。
## Depends on 格式規範此 section 由 /start-day skill 的 fetch_heptabase.py 自動解析。每行一個依賴，內容為依賴卡片的完整標題。
正確格式：
## Depends on
- [wave-1.5/P0] GCS 前置設定
- [wave-1.5/G2] path_utils 重寫 + orchestrator 路徑切換
無依賴時：
## Depends on
- nothing
只列直接前置依賴，不列間接依賴（避免依賴鏈冗餘）。
批次建立時在標題加識別符，讓依賴關係清晰可讀：
| 格式 | 範例標題 |
|---|---|
[project/PhaseStep] | [wave-1.5/G1] clients+output 目錄遷移 |
[project/TaskCode] | [wave-1.5/I0+I1] validator 根因分析與修正 |
每次建立完畢，告知使用者：
✅ 已建立 N 張卡片：
- [card 1 title]
- ...
⚠️ 卡片已建立在 main space，請在 Sprint whiteboard 將它們拖入
{週號}section。 可用 Heptabase Search 搜尋卡片標題快速定位。