{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kanban-workflow-export",
    "name": "Kanban Workflow Export",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/simonvanlaak/kanban-workflow-export",
    "canonicalUrl": "https://clawhub.ai/simonvanlaak/kanban-workflow-export",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/kanban-workflow-export",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kanban-workflow-export",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "README.md",
      "SECURITY.md",
      "SKILL.md",
      "package-lock.json",
      "package.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/kanban-workflow-export"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/kanban-workflow-export",
    "agentPageUrl": "https://openagent3.xyz/skills/kanban-workflow-export/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kanban-workflow-export/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kanban-workflow-export/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Goal",
        "body": "Provide a reusable core for a project-management “co-worker” that:\n\nUses the existing stage:* lifecycle as the canonical state machine.\nIntegrates with PM platforms via adapter-managed auth (external CLIs/scripts; may require env vars like API keys). Kanban Workflow does not run interactive OAuth flows or persist secrets.\nCentralizes workflow/rules/runbooks so GitHub/Planka/Plane/Linear implementations share logic."
      },
      {
        "title": "Canonical stage model",
        "body": "Treat these labels/states as canonical (and the only stages the agent should consider):\n\nstage:backlog\nstage:blocked\nstage:in-progress\nstage:in-review\n\nNotes:\n\nDone/closed is platform-specific and intentionally not part of the canonical stage set.\n\nAdapters map platform concepts (labels, lists, statuses, custom fields) into this canonical set."
      },
      {
        "title": "Core (platform-agnostic)",
        "body": "Canonical entities: WorkItem, Project, Comment, Stage.\nCanonical events: WorkItemCreated, WorkItemUpdated, StageChanged, CommentAdded, etc.\nWorkflow engine: stage-based worker loop + clarification/comment templates.\nState: cursors + dedupe + snapshots for diffing."
      },
      {
        "title": "Adapters (platform-specific)",
        "body": "Adapters are “smart wrappers” that:\n\nCall existing CLIs (e.g. gh, planka-cli, plane), relying on their auth/session (Plane uses PLANE_API_KEY + PLANE_WORKSPACE; Linear uses LINEAR_API_KEY via the ClawHub skill linear).\nCompose multiple CLI calls to implement higher-level operations.\nSynthesize events by polling + snapshot diffing when webhooks or event types are missing.\n\nCanonical adapter entrypoints live in src/adapters/:\n\ngithub.ts (gh CLI)\nplanka.ts (planka-cli)\nplane.ts (ClawHub skill plane CLI; owner: vaguilera-jinko)\nlinear.ts (ClawHub skill linear auth convention via scripts/linear_json.sh)\n\nSee also: src/adapters/README.md for CLI links and assumptions."
      },
      {
        "title": "Entry points",
        "body": "Library entry points:\n\ntick() (poll → normalize → diff → events)\nverb-level workflow helpers: show, next, start, update, ask, complete, create, autopilot-tick\nautomations: runProgressAutoUpdates()\n\nCLI entry point:\n\nsrc/cli.ts (provides kanban-workflow <verb>; see README for setup flags)"
      },
      {
        "title": "CLI ergonomics: \"What next\" tips",
        "body": "All kanban-workflow <verb> commands print a What next: tip after execution to guide the canonical flow:\n\nsetup → next → start → (ask | update) → complete → next\n\nAfter start, the tip additionally reminds you to run the actual execution/implementation work in a subagent, then report back via ask/update.\n\nIf config/kanban-workflow.json is missing or invalid, all commands error and instruct you to complete setup."
      },
      {
        "title": "Setup (flags-only)",
        "body": "Setup writes config/kanban-workflow.json and validates that the selected platform CLI is installed + authenticated.\n\nRequired:\n\nkanban-workflow setup --adapter <github|plane|linear|planka> ...\nstage mapping flags: --map-backlog, --map-blocked, --map-in-progress, --map-in-review\n\nOptional autopilot scheduling:\n\n--autopilot-cron-expr \"*/5 * * * *\" (default)\n--autopilot-cron-tz \"Europe/Berlin\" (optional)\n--autopilot-install-cron (creates an OpenClaw cron job that runs kanban-workflow autopilot-tick)\n\nAdapter flags (summary):\n\nGitHub: --github-repo <owner/repo>, optional --github-project-number <number>\nPlane: --plane-workspace-slug <slug>, --plane-project-id <uuid>, optional --plane-order-field <field>\nLinear: --linear-team-id <id> or --linear-project-id <id>, optional --linear-view-id <id>\nPlanka: --planka-board-id <id>, --planka-backlog-list-id <id>"
      },
      {
        "title": "Continuous status updates",
        "body": "While a task is in stage:in-progress, Kanban Workflow can post an automatic progress update comment every 5 minutes.\nUse runProgressAutoUpdates() and persist its state in your agent/runtime."
      },
      {
        "title": "Recommended repo layout",
        "body": "scripts/: deterministic helper scripts used by adapters or the core.\nreferences/: schemas and adapter notes (loaded on demand).\nassets/: runbooks/SOP templates."
      },
      {
        "title": "Repo status",
        "body": "The current core implementation is in TypeScript under src/."
      },
      {
        "title": "Next implementation steps",
        "body": "Extend the adapter port to include idempotent write operations (comment/transition/label) in addition to fetchSnapshot().\nFinish and validate the Plane + Linear adapters (consume ClawHub skill plane output schema; Linear uses scripts/linear_json.sh JSON compatibility wrapper).\nDecide on the authoritative mapping rule for stage → platform state (names vs explicit mapping table) and codify it.\nAdd a small CLI surface for Kanban Workflow itself (e.g. kanban-workflow tick --adapter plane --workspace ... --project ...)."
      }
    ],
    "body": "Kanban Workflow (core)\nGoal\n\nProvide a reusable core for a project-management “co-worker” that:\n\nUses the existing stage:* lifecycle as the canonical state machine.\nIntegrates with PM platforms via adapter-managed auth (external CLIs/scripts; may require env vars like API keys). Kanban Workflow does not run interactive OAuth flows or persist secrets.\nCentralizes workflow/rules/runbooks so GitHub/Planka/Plane/Linear implementations share logic.\nCanonical stage model\n\nTreat these labels/states as canonical (and the only stages the agent should consider):\n\nstage:backlog\nstage:blocked\nstage:in-progress\nstage:in-review\n\nNotes:\n\nDone/closed is platform-specific and intentionally not part of the canonical stage set.\n\nAdapters map platform concepts (labels, lists, statuses, custom fields) into this canonical set.\n\nArchitecture (ports & adapters)\nCore (platform-agnostic)\nCanonical entities: WorkItem, Project, Comment, Stage.\nCanonical events: WorkItemCreated, WorkItemUpdated, StageChanged, CommentAdded, etc.\nWorkflow engine: stage-based worker loop + clarification/comment templates.\nState: cursors + dedupe + snapshots for diffing.\nAdapters (platform-specific)\n\nAdapters are “smart wrappers” that:\n\nCall existing CLIs (e.g. gh, planka-cli, plane), relying on their auth/session (Plane uses PLANE_API_KEY + PLANE_WORKSPACE; Linear uses LINEAR_API_KEY via the ClawHub skill linear).\nCompose multiple CLI calls to implement higher-level operations.\nSynthesize events by polling + snapshot diffing when webhooks or event types are missing.\n\nCanonical adapter entrypoints live in src/adapters/:\n\ngithub.ts (gh CLI)\nplanka.ts (planka-cli)\nplane.ts (ClawHub skill plane CLI; owner: vaguilera-jinko)\nlinear.ts (ClawHub skill linear auth convention via scripts/linear_json.sh)\n\nSee also: src/adapters/README.md for CLI links and assumptions.\n\nEntry points\n\nLibrary entry points:\n\ntick() (poll → normalize → diff → events)\nverb-level workflow helpers: show, next, start, update, ask, complete, create, autopilot-tick\nautomations: runProgressAutoUpdates()\n\nCLI entry point:\n\nsrc/cli.ts (provides kanban-workflow <verb>; see README for setup flags)\nCLI ergonomics: \"What next\" tips\n\nAll kanban-workflow <verb> commands print a What next: tip after execution to guide the canonical flow:\n\nsetup → next → start → (ask | update) → complete → next\n\nAfter start, the tip additionally reminds you to run the actual execution/implementation work in a subagent, then report back via ask/update.\n\nIf config/kanban-workflow.json is missing or invalid, all commands error and instruct you to complete setup.\n\nSetup (flags-only)\n\nSetup writes config/kanban-workflow.json and validates that the selected platform CLI is installed + authenticated.\n\nRequired:\n\nkanban-workflow setup --adapter <github|plane|linear|planka> ...\nstage mapping flags: --map-backlog, --map-blocked, --map-in-progress, --map-in-review\n\nOptional autopilot scheduling:\n\n--autopilot-cron-expr \"*/5 * * * *\" (default)\n--autopilot-cron-tz \"Europe/Berlin\" (optional)\n--autopilot-install-cron (creates an OpenClaw cron job that runs kanban-workflow autopilot-tick)\n\nAdapter flags (summary):\n\nGitHub: --github-repo <owner/repo>, optional --github-project-number <number>\nPlane: --plane-workspace-slug <slug>, --plane-project-id <uuid>, optional --plane-order-field <field>\nLinear: --linear-team-id <id> or --linear-project-id <id>, optional --linear-view-id <id>\nPlanka: --planka-board-id <id>, --planka-backlog-list-id <id>\nContinuous status updates\n\nWhile a task is in stage:in-progress, Kanban Workflow can post an automatic progress update comment every 5 minutes. Use runProgressAutoUpdates() and persist its state in your agent/runtime.\n\nRecommended repo layout\nscripts/: deterministic helper scripts used by adapters or the core.\nreferences/: schemas and adapter notes (loaded on demand).\nassets/: runbooks/SOP templates.\nRepo status\nThe current core implementation is in TypeScript under src/.\nNext implementation steps\nExtend the adapter port to include idempotent write operations (comment/transition/label) in addition to fetchSnapshot().\nFinish and validate the Plane + Linear adapters (consume ClawHub skill plane output schema; Linear uses scripts/linear_json.sh JSON compatibility wrapper).\nDecide on the authoritative mapping rule for stage → platform state (names vs explicit mapping table) and codify it.\nAdd a small CLI surface for Kanban Workflow itself (e.g. kanban-workflow tick --adapter plane --workspace ... --project ...)."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/simonvanlaak/kanban-workflow-export",
    "publisherUrl": "https://clawhub.ai/simonvanlaak/kanban-workflow-export",
    "owner": "simonvanlaak",
    "version": "0.1.4",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kanban-workflow-export",
    "downloadUrl": "https://openagent3.xyz/downloads/kanban-workflow-export",
    "agentUrl": "https://openagent3.xyz/skills/kanban-workflow-export/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kanban-workflow-export/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kanban-workflow-export/agent.md"
  }
}