菜单
Full reference for Kitaru v2 development commands, tests, docs generation, packaging, Docker builds, and CI workflows. Use when a task needs commands beyond just check, just fix, or just test.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/zenml-io/kitaru --skill kitaru-dev-commands命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | kitaru-dev-commands |
| description | Full reference for Kitaru v2 development commands, tests, docs generation, packaging, Docker builds, and CI workflows. Use when a task needs commands beyond just check, just fix, or just test. |
Run just --list for the recipe inventory, then verify that a recipe's backing files exist before using it on v2. Treat pyproject.toml, source, tests, and existing scripts as authoritative when inherited recipes or workflows disagree.
uv sync # Base SDK and development dependencies
uv sync --extra cli # Optional CLI
uv sync --extra mcp # Optional native MCP server
uv sync --extra server # FastAPI server and database dependencies
uv sync --extra worker # Worker runtime
uv sync --extra otel # OpenTelemetry integrations
There is no v2 local extra, kitaru init command, or .kitaru/ project-marker setup.
just fix # Auto-fix formatting, lint, and YAML
just check # Format, lint, types, typos, YAML, actions, links
just test # Full pytest suite
just tests/cli
just tests/cli/test_app.py::test_help_version_schema_and_scaffold_skip_bootstrap
The full suite can be summarized without losing failure names:
just test 2>&1 | grep -E "FAILED|ERROR|passed|failed" | tail -20
just format-check
just lint
just typecheck
just typos
just yaml-check
just actions-lint
just zizmor
just audit
just links
just links-external
just example-coverage-audit
just migration-check # Requires docker compose up -d db
just build
just cli-artifact-smoke # Clean CLI wheel and source installs
just mcp-schema-check # Registry schemas, budgets, snapshots
just mcp-wheel-smoke # Clean base and [mcp] wheel installs
uv run --extra cli kitaru schema # Offline CLI command catalog
Do not copy MCP tool counts into this skill. Read tests/mcp/snapshots/metrics.json and run just mcp-schema-check.
CLI tests call src/kitaru/cli/app.py::main with explicit arguments and assert its returned integer code. They do not expect SystemExit(0).
These require Node 22+ and pnpm.
just docs # Preview at localhost:3000
just docs-build # Static export
just docs-validate # Validate export under /docs
scripts/generate_sdk_docs.py is the v2 SDK-reference generator: griffe extraction filtered to a PUBLIC_API allowlist (kitaru.client, kitaru.task and its evaluator/importer modules). It needs the fumapy bridge (uv pip install ./docs/node_modules/fumadocs-python, after pnpm install in docs/); just generate-docs runs generation plus MDX conversion. Edit the allowlist and tests/scripts/test_generate_sdk_docs.py together — a drift test compares the allowlist to each published module's __all__. scripts/generate_cli_docs.py generates the CLI reference from the kitaru schema JSON contract (run in-process, needs the cli extra); it hardcodes no command names, so CLI changes flow through on regeneration.
Read FRONTEND-TESTING.md before changing UI bundle, frontend smoke, Docker dashboard, or release UI behavior.
just ui-bundle # Download latest stable UI bundle
just UI_TAG=kitaru-ui-v0.2.0 ui-bundle # Pin a stable UI bundle
just UI_TAG=kitaru-ui-v0.3.0-rc.1 ui-bundle-prerelease
docker compose up -d db
just ui-serve # Serve the downloaded bundle from source
just ui-serve runs the API server from source against the local compose database and serves the bundle at http://localhost:8000.
The v2 Dockerfiles are docker/dev-client.Dockerfile, docker/dev-server.Dockerfile, docker/release-client.Dockerfile, and docker/release-server.Dockerfile. Follow docker/CLAUDE.md; do not use inherited v1 server-image recipes as v2 release evidence.
| Workflow | Current v2 role |
|---|---|
ci.yml | Pushes to develop and pull requests. Base, CLI, and MCP test matrices cover Python 3.11-3.14; separate jobs validate CLI artifacts, installed MCP wheels, migrations, Docker server startup, and UI wheel packaging. |
docs.yml | SDK reference build/deploy workflow: generates the reference via scripts/generate_sdk_docs.py, converts to MDX, builds the static export. PRs build only; deployment runs on main push or manual dispatch. |
release.yml | Validates source and built artifacts, then performs versioning, PyPI, GitHub Release, Docker/ECR, Helm, release-branch, and main updates. Normal dispatch releases develop, not the current feature branch. |
spellcheck.yml | Separate typo/spell checking. |
image-optimiser.yml | Compresses changed images on eligible pull requests. |
zizmor.yml | Audits GitHub Actions security. |
The inherited llm-integration.yml still references absent v1 provider tests. Do not use it or the missing tests/live/ marker suite as proof of v2 behavior.