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

[Bug]: check-prerequisites.sh --paths-only still runs branch validation, contradicting --help

Đang mở Phù hợp với người mới
#2,477 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đá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
86/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
bash, git, powershell
Lĩnh vực
cli, tooling

Hướng nghiên cứu

Bắt đầu với scripts/bash/check-prerequisites.sh và luồng --paths-only được mô tả trong issue, sau đó so sánh thứ tự của luồng này với scripts/powershell/check-prerequisites.ps1 và phần kiểm tra branch trong common.sh. Tái hiện trên một branch không phải feature với --paths-only và --json; hoàn tất khi các biến đường dẫn được xuất ra và lệnh chạy thành công mà không cần xác thực branch.

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

Mô tả

stale

Bug Description

scripts/bash/check-prerequisites.sh --paths-only is documented as "no validation" / "no prerequisite validation", but the script runs check_feature_branch before the --paths-only early exit. The result: when the current branch does not match the feature-branch naming convention, --paths-only exits non-zero with a branch-format error, even though the caller asked for paths only and explicitly opted out of validation.

Source: https://github.com/github/spec-kit/blob/main/scripts/bash/check-prerequisites.sh#L81-L113

# Get feature paths and validate branch
_paths_output=$(get_feature_paths) || { ... ; exit 1; }
eval "$_paths_output"
unset _paths_output
check_feature_branch "$CURRENT_BRANCH" "$HAS_GIT" || exit 1   # ← runs even with --paths-only

# If paths-only mode, output paths and exit (support JSON + paths-only combined)
if \$PATHS_ONLY; then
    ...
    exit 0
fi

The header documentation (line 14) says: `--paths-only Only output path variables (no validation)` and `--help` (line 54) says `(no prerequisite validation)`. Branch validation is the most user-visible form of validation, so this contradicts the documented behavior.

Steps to Reproduce

  1. Initialize a Spec Kit project: `specify init test-paths-only --integration claude`
  2. Switch to a non-feature branch: `git checkout -b chore/some-cleanup`
  3. Run paths-only: `./.specify/scripts/bash/check-prerequisites.sh --paths-only`

Expected Behavior

`--paths-only` succeeds and emits `REPO_ROOT`, `BRANCH`, `FEATURE_DIR`, etc., regardless of branch name (the caller asked for paths, not validation).

Actual Behavior

Exit 1 with branch-validation error (the message produced by `check_feature_branch` in `common.sh`), no path variables emitted.

Specify CLI Version

0.7.4.dev0

AI Agent

Claude Code

Suggested Fix

Move `check_feature_branch` after the `if $PATHS_ONLY; then ... exit 0; fi` block so `--paths-only` truly skips validation. Same source ordering already exists in `scripts/powershell/check-prerequisites.ps1` — please verify both are aligned.

Context

Surfaced while bulk-installing Spec Kit across 20 internal projects. `/speckit-tasks` and similar commands invoke `check-prerequisites.sh --paths-only --json` from non-feature chore branches and unexpectedly fail with branch-format errors despite the documented opt-out.

Ngôn ngữ chính
Python
Star
138k
Fork
12.4k
Merge trung bình
3 ngày 4 giờ
Pull request đã merge (30 ngày)
154

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

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 github/spec-kit

Tất cả issue của github/spec-kit

Issue tương tự

Thêm issue về Python

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.