add-cli-command
Adds or changes a clickhousectl command, subcommand or flag, for local commands (`local ...`) or ClickHouse Cloud commands (`cloud ...`). Covers the clap definition, dispatch, handler, output, Cloud permissions, tests and help. Use when adding a command or flag, exposing a `clickhouse-cloud-api` method in the CLI, or changing what a command sends or prints.
来源信息
- 仓库
- ClickHouse/clickhousectl
- 最近来源活动
- 2026年10月14日 18:02
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 80
- Forks
- 9
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
3 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- add-cli-command
- description
- Adds or changes a clickhousectl command, subcommand or flag, for local commands (`local ...`) or ClickHouse Cloud commands (`cloud ...`). Covers the clap definition, dispatch, handler, output, Cloud permissions, tests and help. Use when adding a command or flag, exposing a `clickhouse-cloud-api` method in the CLI, or changing what a command sends or prints.
# Add a CLI command
Paths are relative to `crates/clickhousectl/`.
1. Follow the procedure for the kind of command:
- Local (`local ...`, runs on this machine): [references/local.md](references/local.md)
- Cloud (`cloud ...`, calls the Cloud API): [references/cloud.md](references/cloud.md)
2. Write help text with the `cli-help-text` skill (`.agents/skills/cli-help-text/SKILL.md`).
3. Finish with the steps below.
## Finish
- Add `Cli::try_parse_from` tests next to the clap definition for each new flag. Check the parsed value, the
default, whether it can repeat, and any conflicts with other flags.
- For each new source or test file, add an entry to both `scripts/classify-cloud-integration.py` and
`scripts/classify-install-integration.py`. CI fails on a file that is in neither.
- Update the relevant user guide or reference under `docs/` when users will see the change, following
`CONTRIBUTING.md`. Keep safety and behavioral details beside the affected task. Change the root `README.md`
only when its capability overview or representative examples need updating; do not add a flag catalog.
- Check documentation links/anchors and example commands against this branch's help and request definitions.
- Run the CLI commands from "Commands" in the root `AGENTS.md`. Both clippy configurations must pass.
Copy this checklist and tick it off as you go:
```
- [ ] Procedure steps (local.md or cloud.md)
- [ ] Help text follows the cli-help-text skill
- [ ] try_parse_from tests for new flags
- [ ] Both classifiers map new files
- [ ] Relevant guide/reference and any affected README example
- [ ] Documentation links and command examples checked
- [ ] fmt, both clippy configurations, tests
```
在 GitHub 查看