菜单
Guides Codemation CLI work for consumer apps and framework-author development. Use when the user asks about `codemation dev`, `build`, `serve web`, `serve worker`, `user create`, `user list`, `--consumer-root`, `.codemation/output`, or consumer versus framework-author mode.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
CodemationDocumentScanner node — managed document/invoice/image extraction via the Codemation doc-scanner service. No Azure credentials required. Read before writing any workflow that scans documents, invoices, or images.
ListWorkspaceFiles + ReadWorkspaceFile nodes — read files from the shared workspace pool. Covers read-by-filename (latest-wins), pinned fileId, binary slot handoff, and the raw-upload → concierge-digests → workflow-reads-derived-file pattern. Read before building any workflow that reads workspace files.
AIAgent constructor, message shape, managed and BYOK chatModel configs, outputSchema, mcpServers. Read before writing any workflow step that calls an LLM.
Guides Codemation custom credential development with `defineCredential(...)`, typed sessions, credential testing, and node credential slots. Use when creating or updating custom credentials, credential registrations, or credential-aware custom nodes.
Guides Codemation custom node development with `defineNode(...)` (`execute` per item), `defineBatchNode(...)` (batch `run`), reusable node modules, credential-aware nodes, and the class-based node fallback for advanced cases. Use when creating or updating custom nodes for apps or plugin packages.
Explains Codemation package boundaries, runtime concepts, observability shape, and the normal consumer mental model. Use when the user asks where code belongs across `@codemation/core`, `@codemation/host`, `@codemation/next-host`, `@codemation/cli`, workflows, plugins, credentials, activation, telemetry, or runtime modes. Read this first when starting any Codemation task — it points at the right skill for the work.
| name | codemation-cli |
| description | Guides Codemation CLI work for consumer apps and framework-author development. Use when the user asks about `codemation dev`, `build`, `serve web`, `serve worker`, `user create`, `user list`, `--consumer-root`, `.codemation/output`, or consumer versus framework-author mode. |
| compatibility | Designed for Codemation repositories and projects that use the Codemation CLI. |
| tags | cli, dev |
The CLI is a thin orchestrator: it loads codemation.config.ts, delegates to @codemation/host (web server) and worker packages, and manages build artifacts in .codemation/output/. It owns no workflow logic. There are two modes: consumer mode (codemation dev) runs a stable packaged UI against the consumer's workflows; framework-author mode (codemation dev --watch-framework) enables next-host HMR for monorepo development.
Use this skill for command selection, local development flow, and CLI troubleshooting. Do not use for workflow graph design, custom node implementation, or credential modeling unless the CLI command is the core question.
codemation dev # consumer development (default)
codemation dev --watch-framework # framework-author / UI HMR (monorepo)
codemation build # emit .codemation/output/build
codemation serve web # run packaged web host
codemation serve worker # start queue-backed worker
codemation user create # bootstrap local-auth user
codemation user list # inspect auth users
Use codemation --help or codemation <command> --help before guessing flags.
Standalone consumer vs monorepo: confirm which context the user is in before suggesting commands. In the monorepo, distinguish framework-author mode from consumer mode explicitly.
Plugin loading: in consumer mode, plugins are loaded from the built JavaScript path declared in package.json#codemation.plugin — not from TypeScript source under node_modules. In plugin dev mode, the CLI TypeScript-loads only the current plugin repo through the generated .codemation/plugin-dev/codemation.config.ts.
Redis-backed execution: when Redis-backed execution is involved, mention the shared PostgreSQL requirement — local SQLite no longer fits.
Skills sync: after @codemation/cli or @codemation/agent-skills package upgrades in monorepo work, run codemation skills sync to refresh extracted packaged skills in .agents/skills/extracted. Automatic refresh is intentionally disabled in the monorepo worktree to keep it clean.
codemation <command> --help.references/command-map.md for command responsibilities and development-mode guidance.