功能描述

Kanban Workflow is a TypeScript skill for a stage-based agentic co-worker that integrates PM platforms via CLI-first adapters (CLIs or small wrapper scripts)...

使用说明 (SKILL.md)

Kanban Workflow (core)

Name: Kanban Workflow Export
Author: simonvanlaak

Goal

Provide a reusable core for a project-management “co-worker” that:

Uses the existing stage:* lifecycle as the canonical state machine.
Integrates 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.
Centralizes workflow/rules/runbooks so GitHub/Planka/Plane/Linear implementations share logic.

Canonical stage model

Treat these labels/states as canonical (and the only stages the agent should consider):

stage:backlog
stage:blocked
stage:in-progress
stage:in-review

Notes:

Done/closed is platform-specific and intentionally not part of the canonical stage set.

Adapters map platform concepts (labels, lists, statuses, custom fields) into this canonical set.

Architecture (ports & adapters)

Core (platform-agnostic)

Canonical entities: WorkItem, Project, Comment, Stage.
Canonical events: WorkItemCreated, WorkItemUpdated, StageChanged, CommentAdded, etc.
Workflow engine: stage-based worker loop + clarification/comment templates.
State: cursors + dedupe + snapshots for diffing.

Adapters (platform-specific)

Adapters are “smart wrappers” that:

Call 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).
Compose multiple CLI calls to implement higher-level operations.
Synthesize events by polling + snapshot diffing when webhooks or event types are missing.

Canonical adapter entrypoints live in src/adapters/:

github.ts (gh CLI)
planka.ts (planka-cli)
plane.ts (ClawHub skill plane CLI; owner: vaguilera-jinko)
linear.ts (ClawHub skill linear auth convention via scripts/linear_json.sh)

See also: src/adapters/README.md for CLI links and assumptions.

Entry points

Library entry points:

tick() (poll → normalize → diff → events)
verb-level workflow helpers: show, next, start, update, ask, complete, create, autopilot-tick
automations: runProgressAutoUpdates()

CLI entry point:

src/cli.ts (provides kanban-workflow \x3Cverb>; see README for setup flags)

CLI ergonomics: "What next" tips

All kanban-workflow \x3Cverb> commands print a What next: tip after execution to guide the canonical flow:

setup → next → start → (ask | update) → complete → next

After start, the tip additionally reminds you to run the actual execution/implementation work in a subagent, then report back via ask/update.

If config/kanban-workflow.json is missing or invalid, all commands error and instruct you to complete setup.

Setup (flags-only)

Setup writes config/kanban-workflow.json and validates that the selected platform CLI is installed + authenticated.

Required:

kanban-workflow setup --adapter \x3Cgithub|plane|linear|planka> ...
stage mapping flags: --map-backlog, --map-blocked, --map-in-progress, --map-in-review

Optional autopilot scheduling:

--autopilot-cron-expr "*/5 * * * *" (default)
--autopilot-cron-tz "Europe/Berlin" (optional)
--autopilot-install-cron (creates an OpenClaw cron job that runs kanban-workflow autopilot-tick)

Adapter flags (summary):

GitHub: --github-repo \x3Cowner/repo>, optional --github-project-number \x3Cnumber>
Plane: --plane-workspace-slug \x3Cslug>, --plane-project-id \x3Cuuid>, optional --plane-order-field \x3Cfield>
Linear: --linear-team-id \x3Cid> or --linear-project-id \x3Cid>, optional --linear-view-id \x3Cid>
Planka: --planka-board-id \x3Cid>, --planka-backlog-list-id \x3Cid>

Continuous status updates

While 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.

Recommended repo layout

scripts/: deterministic helper scripts used by adapters or the core.
references/: schemas and adapter notes (loaded on demand).
assets/: runbooks/SOP templates.

Repo status

The current core implementation is in TypeScript under src/.

Next implementation steps

Extend the adapter port to include idempotent write operations (comment/transition/label) in addition to fetchSnapshot().
Finish and validate the Plane + Linear adapters (consume ClawHub skill plane output schema; Linear uses scripts/linear_json.sh JSON compatibility wrapper).
Decide on the authoritative mapping rule for stage → platform state (names vs explicit mapping table) and codify it.
Add a small CLI surface for Kanban Workflow itself (e.g. kanban-workflow tick --adapter plane --workspace ... --project ...).

安全使用建议

This skill appears coherent with its purpose: it is a TypeScript core that delegates auth/actions to platform CLIs and a few small wrapper scripts. Before installing or running it, review and accept the following: 1) It will execute host CLIs (gh, planka-cli, plane, curl/jq) and therefore inherits their permissions—use least-privilege tokens/accounts for those CLIs. 2) If you select the Linear or Plane adapters you will need API keys (LINEAR_API_KEY, PLANE_API_KEY) which are used by bundled scripts; keep those scoped and stored securely. 3) Setup can write config/kanban-workflow.json into the repo and (if you opt in) install a recurring cron job that will run automations—only enable cron/automation if you want autonomous operations. 4) The repo includes wrapper scripts (scripts/linear_json.sh and scripts/planka_whoami_json.mjs); inspect them if you want to confirm network endpoints and parsing behavior (the Linear script calls api.linear.app). 5) There are no hidden remote installers in the bundle, but running npm ci will install dependencies from npm (inspect package.json/package-lock.json if you need to audit dependencies). If you want an extra safety layer, run the skill in an isolated environment (container/VM) and limit adapter credentials to scoped tokens.

功能分析

Type: OpenClaw Skill Name: kanban-workflow-export Version: 0.1.4 The OpenClaw AgentSkills skill 'kanban-workflow' is classified as benign. It is designed for legitimate project management automation, integrating with external CLIs (GitHub, Linear, Plane, Planka) for its functionality. The skill's security model is transparently documented in `SECURITY.md` and `README.md`, explicitly stating that it operates with the same privileges as the underlying CLI sessions and does not handle API tokens directly. While it uses `execa` to run external commands and can install an OpenClaw cron job for its `autopilot-tick` feature (persistence), these actions are clearly stated, aligned with its purpose, and do not show signs of malicious intent like data exfiltration, unauthorized remote control, or stealthy backdoors. The code uses safe practices like passing arguments as arrays to `execa` to mitigate direct shell injection.

能力评估

✓ Purpose & Capability

Name/description match the code and runtime instructions. Adapters and optional env vars (PLANE_API_KEY, PLANE_WORKSPACE, LINEAR_API_KEY) correspond to the stated platform integrations. No unrelated credentials, binaries, or config-path access are requested.

ℹ Instruction Scope

SKILL.md instructs the agent to run Node/npm and to call platform CLIs or bundled wrapper scripts (e.g., scripts/linear_json.sh, scripts/planka_whoami_json.mjs). Those instructions are aligned with the adapter model, but they explicitly grant the skill the same privileges as the chosen CLIs (the README/SECURITY.md also note this). The skill reads/writes its own config/kanban-workflow.json and may install an OpenClaw cron job if you opt into --autopilot-install-cron.

✓ Install Mechanism

There is no opaque download/install in the skill bundle. The package includes source and a package-lock.json; SKILL.md instructs users to run npm ci locally. No external arbitrary URL downloads or extract steps are present in the provided files.

✓ Credentials

No global required environment variables; optional API keys are adapter-specific and justified by their adapters (Linear/Plane). The linear wrapper script will fail if LINEAR_API_KEY is absent, but that is consistent with using the linear adapter. No unrelated secrets or broad system credentials are requested.

ℹ Persistence & Privilege

always:false (default). The skill persists config in-repo (config/kanban-workflow.json) and can optionally install a scheduled cron job via a setup flag. These behaviors are documented and expected for a scheduler/agentic worker, but you should only enable autopilot/crons if you trust the runtime and adapter CLI auth.

版本历史

v0.1.4

- Added detailed SKILL.md with architecture, setup, platform adapters, workflow, and usage documentation. - Defined requirements, supported platform adapters (GitHub, Planka, Plane, Linear), and needed environment variables. - Outlined canonical stage model, entry points, CLI ergonomics, setup procedure, and automation options. - Provided guidance for repo layout and described current implementation status and next steps.

元数据

Slug kanban-workflow-export

版本 0.1.4

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题

Kanban Workflow Export 是什么？

Kanban Workflow is a TypeScript skill for a stage-based agentic co-worker that integrates PM platforms via CLI-first adapters (CLIs or small wrapper scripts)... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 342 次。

如何安装 Kanban Workflow Export？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install kanban-workflow-export」即可一键安装，无需额外配置。

Kanban Workflow Export 是免费的吗？

是的，Kanban Workflow Export 完全免费（开源免费），可自由下载、安装和使用。

Kanban Workflow Export 支持哪些平台？

Kanban Workflow Export 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Kanban Workflow Export？

由 Simon van Laak（@simonvanlaak）开发并维护，当前版本 v0.1.4。

Kanban Workflow Export