Question 1

TERM=dumb 環境や CI の pty で `tput clear` が失敗し、`set -e` が有効なために Bash ウィザードが即座に終了してしまう問題を修正するにはどうすればよいですか?

Accepted Answer

`tput`バイナリが存在するという理由だけで`tput clear`を選択してはいけません。`if`条件内で実行し、失敗した場合はANSIエスケープシーケンスにフォールバックしてください：

```bash
_clear() {
  if command -v tput >/dev/null 2>&1 && tput clear 2>/dev/null; then
    return 0
  fi
  printf '\033[2J\033[3J\033[H'
}
```

`if`条件内で失敗したコマンドは`errexit`をトリガーしないため、Bash 3.2を含め、`set -euo pipefail`を使用していても安全です。stderrをリダイレクトすることでterminfoエラーが抑制されます。パイプ経由ではなく、`TERM=dumb`などのPTY上で元の失敗を再現してください。TTY以外のstdoutでは`_clear`が早期にリターンする可能性があります。

Question 2

`write_env KEY VALUE` で値が env ファイルに書き込まれた後でも、なぜ `${KEY:-default}` はまだデフォルト値を使うのですか？

Accepted Answer

`mattpocock-skills` 1.2.3 では、`write_env` は `KEY=VALUE` を `$ENV_FILE` に upsert（追記または更新）するだけで、実行中のシェルには `KEY` を設定しません。そのため、`${KEY:-default}` を使用する後続のステージでは、変数が未設定とみなされてデフォルト値が使われます。`ask` や `ask_secret` と同様に、`printf -v` で変数を代入するように `skills/engineering/wizard/template.sh` を修正してください:

```bash
write_env() {
  local key="$1" value="$2" tmp
  touch "$ENV_FILE"
  tmp=$(mktemp)
  grep -vE "^${key}=" "$ENV_FILE" > "$tmp" || true
  printf '%s=%s
' "$key" "$value" >> "$tmp"
  mv "$tmp" "$ENV_FILE"

printf -v "$key" '%s' "$value"

WRITTEN_ENV+=("$key")
  printf '  %s✓ wrote%s %s → %s
' "$GREEN" "$RESET" "$key" "$ENV_FILE"
}
```

すでに生成済みのウィザードに対する即時の回避策としては、書き込み後に値を明示的に代入します（例: `WRITE_KEY_NAME="dealsplash-import-write"`）。あるいは、後続のステージが読み取る前に env ファイルを source するか再読み込みしてください。

Question 3

wizard スキルが生成したスクリプト内の未使用の RED 変数に対する ShellCheck SC2034 を修正するにはどうすればよいですか？

Accepted Answer

`skills/engineering/wizard/template.sh` から、カラー分岐とno-color分岐の両方にある未使用の `RED` 代入を削除してください。例えば `RED=$(tput setaf 1)` や、それに対応する `RED=''` のようなno-color代入です。ウィザードスクリプトを再生成してください。`grep -n RED skills/engineering/wizard/` で確認し（何も返されないはずです）、生成されたスクリプトに対して `shellcheck` を実行して `SC2034` がなくなったことを確認してください。すぐにテンプレートを更新できない場合は、回避策として生成されたスクリプトから未使用の `RED` 宣言を削除してください。

Question 4

Bashスクリプトがreadプロンプトで待機している最中にそのスクリプトを編集すると、なぜ「syntax error near unexpected token」というエラーが発生するのですか？

Accepted Answer

Bash は、スクリプトファイル全体を最初に読み込むのではなく、バイトオフセットを使って逐次的に読み込みます。スクリプトがプロンプトで一時停止している間にファイルが変更されると、Bash は変更後の内容に対して古いオフセットの位置から読み込みを再開するため、`syntax error near unexpected token '('` のような誤った構文エラーが発生することがあります。

これを修正するには、ウィザードの実行可能なステージコードを単一の関数でラップし、その関数を最終行でのみ呼び出して、続けて `exit` を記述します。Bash は関数を実行する前に全体を解析するため、プロンプトの最中に変更されつつあるスクリプトファイルを読み込むことがなくなります。

```bash
run_wizard() {
  TOTAL_STAGES=1

banner "Setup"
  # stage prompts and logic here
  finish
}

run_wizard "$@"; exit
```

ステージマーカーより上にある共有ライブラリコードは変更せず、すべてのステージロジックを `run_wizard` の中に収め、最後の呼び出し行はそのままにしてください。次のコマンドで確認します:

```bash
bash -n template.sh
```

この修正は Bash 3.2 と Bash 5.3 で検証されました。一時的な回避策として、ウィザードスクリプトの実行中に、保存、再生成、`git pull`、またはその他の方法でスクリプトを変更しないでください。代わりに、変更不可能なコピーを実行してください。

Question 5

会話中にAIアシスタントに私のプロジェクトのUbiquitous Languageを使用させるにはどうすればよいですか？

Accepted Answer

ユビキタス言語スキルが /grill-me-docs コマンドに統合されました。そのコマンドを実行して、AI をあなたの用語に合わせてください。プロジェクト用語を含む CONTEXT.md ファイルを作成するには、/grill-with-docs を繰り返し使用してください。

skills

概要

README プレビュー

FAQ (5)

同类型项目

hermes-agent

firecrawl

go

markitdown