deckrd

aglabo 的头像作者 aglabo

从需求到可执行任务的逐步推导工作流程。

📖 中文导读:从需求到可执行任务的逐步推导工作流程。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: deckrd description: "Use when structuring requirements, specifications, or tasks. Enforces stepwise derivation and phase integrity."

Deckrd - Your Goals to Tasks framework

Deckrd is a document-centered framework for structuring and refining ideas through iterative discussion with AI. It guides the creation of requirements, decisions, specifications, and implementation plans as derived documents, not final outputs. Each document captures reasoning at a specific stage, preserving context and intent. Through a strict, state-driven workflow, these documents are progressively shaped into executable development tasks. Deckrd enables documentation to function as a practical engine for action, not just description.

Commands

Command Description
init <ns>/<mod> Initialize module directory and session
req Derive requirements from goals
dr Manage Decision Records (req step only)
dr --add Append a new Decision Record
spec Derive specifications from requirements
impl Derive implementation plan from specifications
tasks Derive executable tasks from implementation
status Display current workflow progress and status

Session Resolution

Session state is stored in docs/.deckrd/.session.json.

Before executing any command:

  1. Read .session.json to get active module and current step
  2. Validate the command matches expected workflow progression
  3. Load the appropriate reference from references/commands/

Reference selection:

Current State Next Command Load Reference
(none) init commands/init.md
init completed req commands/req.md
req completed spec commands/spec.md
spec completed impl commands/impl.md
impl completed tasks commands/tasks.md

For workflow overview: workflow.md For session management details: session.md For status command: commands/status.md