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
- フォーク
- 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で見る