菜单
Kiloforge CLI tools reference and shared documentation hub. Lists available tools, provides runtime environment info, and hosts reference docs used by other kf-* skills.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Receive a track ID, validate it is an active unclaimed track, then implement it following the kiloforge workflow.
Product strategy advisor: research the codebase and competitive landscape to provide product design, branding, feature prioritization, and competitive analysis advice. Produces actionable reports to .agent/kf/_reports/product-advisor/ designed for handoff to /kf-architect.
Project architect: research the codebase and distill feature requests into well-scoped kiloforge tracks with specs and implementation plans. Splits large work into multiple tracks (including BE/FE splits). Merges track artifacts to the primary branch so developer workers can claim them.
Resolve git merge conflicts during push or pull sync operations. Fetches remote changes, merges, resolves conflicts (or escalates), and completes the sync.
Interactive project bootstrapper with platform-aware defaults. Guides users through project creation decisions, generates a blueprint, scaffolds the project, and invokes kf-setup with pre-populated answers.
Manage track lifecycle: archive, bulk-archive, compact, restore, delete, rename, and cleanup
| name | kf-bin |
| description | Kiloforge CLI tools reference and shared documentation hub. Lists available tools, provides runtime environment info, and hosts reference docs used by other kf-* skills. |
Reference for CLI tools installed to ~/.kf/bin/ and shared documentation used by other kf-* skills.
references/ (e.g., merge protocol, data guardian)All CLI tools require the Kiloforge venv at ~/.kf/.venv (auto-created during /kf-setup).
NEVER install packages globally. All dependencies go into ~/.kf/.venv only.
Scripts are activated via preflight, which every skill evals at startup:
eval "$(~/.kf/bin/kf-preflight.py)"
For platform-specific Python setup, see references/python-setup.md.
| Tool | Description |
|---|---|
kf-preflight.py | Pre-flight check: verifies metadata, sets PRIMARY_BRANCH |
kf-primary-branch.py | Resolves primary branch from config.yaml |
kf-track.py | Track registry (add, list, update, claim, deps, conflicts, spec) |
kf-track-content.py | Track content (init, show, spec fields, plan, task, progress) |
kf-merge.py | Merge protocol (lock, rebase, verify, merge, release) |
kf-merge-lock.py | Cross-worktree branch lock (acquire, release, heartbeat) |
kf-claim.py | Per-worktree track claim (acquire, release, list, find) |
kf-dispatch.py | Dispatch assignments for idle developer worktrees |
kf-worktree-env.py | Detect worktree context, export env vars |
kf-status.py | Full project status (workers, tracks, spec, dispatch) |
kf-install.py | Install/update CLI tools (venv, scripts, shebangs) |
kf-conductor.py | Tmux multi-agent orchestration (spawn, dispatch, status) |
| Document | Used by | Description |
|---|---|---|
references/merge-protocol.md | kf-architect, kf-developer | Lock → rebase → verify → merge protocol |
references/data-schema.md | all kf-* skills | Authoritative data schema for all .agent/kf/ files |
references/data-guardian.md | kf-repair, kf-validate | Corruption detection heuristics and response |
references/implement-workflow.md | kf-developer | TDD task execution loop details |
references/new-track-interactive.md | kf-architect | Interactive Q&A track creation flow |
references/bulk-archive.md | kf-manage | Bulk archive workflow |
references/compact-archive.md | kf-manage | Compact archive workflow |
references/cli-tools.md | (this skill) | Extended CLI tool descriptions |
references/python-setup.md | kf-setup | Platform-specific Python installation |
When invoked, display the tools table. If a tool name is given as argument:
~/.kf/bin/{tool}.py --help
If tools are not installed, suggest /kf-setup.