Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

docs: flags and behaviour in Command Reference/FAQ/claude-skill don't match the binary (-y, --since, --yaml, envelope, --set, kg)

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#369 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 2 ngày

@BlueLabelscotch đang làm issue này rồi.

Từ ngày 28/10/2026.

  • #372 của @BlueLabelscotch — đang mở
  • #373 của @BlueLabelscotch — đang mở

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
72/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Lĩnh vực
cli, documentation

Hướng nghiên cứu

Các điểm không khớp nằm trong Command Reference, FAQ và docs/claude-skill.md, với docs/mutation.md là tài liệu tham chiếu cho việc danh từ nào chấp nhận --set. Xác nhận từng khẳng định bằng cách chạy đầu ra --help cho các lệnh được nêu tên (delete trigger, list audit_event, get pipeline, get service, update pipeline, list module) và so sánh nó với văn bản. Hoàn tất nghĩa là mỗi mục trong sáu mục khớp với đầu ra trợ giúp của binary, với quy tắc gating kg được nêu giống nhau trên cả hai trang.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Summary

While testing the CLI as the default tool for coding agents (instead of the Harness MCP), several places in the docs (Command Reference, FAQ, docs/claude-skill.md) describe flags and behaviour that don't match the binary. Each item below was re-checked against current main (3.10.2-dev). All are read-only observations.

Mismatches

1. Delete confirmation: --force, not -y

Docs say delete flows use "interactive confirm; use -y to skip".

harness delete trigger <pipeline>/<trigger> -y     # unknown shorthand flag: 'y' in -y
harness delete trigger <pipeline>/<trigger>        # Request canceled: stdin is not a terminal; re-run with --force to skip this prompt

harness delete trigger --help only lists --force. Same for input_set, template_version, connector, pipeline. Fix: replace -y with --force.

2. list audit_event --since does not exist

FAQ example harness list audit_event --since 24h fails with unknown flag: --since. Actual filters: --action, --module, --resource_type. Fix: change the example (a time-window filter would be a separate feature request).

3. get --yaml is not available on every noun

Cheat sheet describes yaml on get as the envelope-stripped body for update -f / create -f. harness get pipeline --help offers --format: text, json (no --yaml); harness get service --help offers text, json, yaml and --yaml. Fix: document the supported formats per noun, or add --yaml consistently.

4. Default --format json is not "envelope included"

docs/claude-skill.md ("Output formats") says json includes the full envelope. In practice the envelope is only present with --raw (--raw is "only with --format json"). Default get pipeline --format json returns just the pipeline and url keys. Fix: say the envelope requires --raw.

5, 6. Moved
  • --set not on every create/update: #370
  • kg module visibility: #371

Out of scope

Behaviour/ergonomics gaps from the same review (get noun field names vs JSON keys, no paging indicator in JSON output, inconsistent JSON key casing, matrix JSON types, structured JSON errors, scope error messages, epoch timestamps) will be filed separately.

Ngôn ngữ chính
Go
Star
28
Fork
16
Merge trung bình
2 ngày 14 giờ
Pull request đã merge (30 ngày)
65

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của harness/cli

Tất cả issue của harness/cli

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.