🥾

Claude Codeのコマンドの補完が動かなくなった

に公開

背景

いつものようにClaude Codeを起動して、定型作業のためのskillを呼び出そうとしたら動作しなくなりました。

具体的な問題としては、以下のようにfuzzy-searchが動作せずに、フォーカスがずっと変わらない。ただし、正確にマッチしたときにはシステムプロンプトでコマンドの色が変わります。

fuzzy-searchが動作しない様子
fuzzy-searchが動作しない様子

また、システムプロンプトに入れた内容も無視されてしまい候補としてフォーカスの当たっているコマンドが実行されてしまいます。
clearを実行したいのにrewindが実行される様子
/clearを実行したいのに/rewindが実行される様子

原因

原因は、直前に行っていて(途中状態で放置していた)skillの作成でした。このskillのYAML frontmatter部分と先頭の一部は以下のようになっていました。

---
name: wip-skill
description: [TODO: Complete and informative explanation of what the skill does and when to use it. Include WHEN to use this skill - specific scenarios, file types, or tasks that trigger it.]
---

# WIP Skill

## Overview

[TODO: 1-2 sentences explaining what this skill enables]

YAMLパーサーの気持ちになると、角括弧は配列を示す構文であり、パースに失敗します。その後のエラーハンドリングが不十分で、JavaScriptのObjectとしてこのdescriptionが保持されることで、システムプロンプトに直接[object Object]という文字列が表示されます。

skillの説明に意図しない文字列が入っている様子
skillの説明に意図しない文字列が入っている様子

そのため、このようなYAMLでパースできない文字列を指定していると正しくClaude Codeによって解釈されずに結果的に補完機能全体に影響を与えます。

なぜこの問題が起きるのか?

さて、なぜこの問題が発生するかについて考えていきましょう。

Claude Code自体は公開されているリポジトリにはコードはホストされておらず、直接的にコードを見て確認することはできません。しかし、難読化されているコードの一部を読むことで問題を断片的に推測することはできます。minifyされているコードの一部を概念的に書き換えると以下のようになります。

function zmA(T, R) {
  // T = 入力テキスト(例: "/hello"), R = 全コマンドの配列
  if (!Gv(T)) return [];   // "/"で始まらなければ空配列
  if (Cj8(T)) return [];   // 引数付きコマンドなら空配列

  let A = T.slice(1).toLowerCase().trim();  // "/"を除去

  if (A === "") {
    // "/" だけ入力された場合 → 全コマンド一覧を返す(ここは問題なし)
    // code snip...
  }

  let _ = R.filter((H) => !H.isHidden).map((H) => {
    let q = H.userFacingName();
    let O = q.split(Gj8).filter(Boolean); 
    return {
      nameKey: q,
      descriptionKey: H.description.split(" ")   // ←ここでクラッシュする
                        .map((G) => Qj8(G))
                        .filter(Boolean),
      partKey: O.length > 1 ? O : void 0,
      commandName: q,
      command: H,
      aliasKey: H.aliases
    };
  });

  // Fuse.js による fuzzy search
  return [...new VZ(_, {
    includeScore: true,
    threshold: 0.3,
    keys: [
      { name: "commandName", weight: 3 },
      { name: "partKey", weight: 2 },
      { name: "aliasKey", weight: 2 },
      { name: "descriptionKey", weight: 0.5 }
    ]
  }).search(A)].sort(/* ソートロジック */);
}

function zmA(T, R)はおそらくスラッシュから始まるスキルの検索を行う関数です。システムプロンプトの文中で / を入力すると発火するようになっていそうです。この引数のRは全部のスキルがロードされていると考えて良いでしょう。

ある行で、descriptionを" "でsplitしている箇所があります。

descriptionKey: H.description.split(" ")
                        .map((G) => Qj8(G))
                        .filter(Boolean),

この時、YAMLのパースに失敗している SKILL があるとそれは内部的にはObjectとして持っている都合上、Objectをsplitしようとしてしまいます。普通はこのような操作はできないので、クラッシュしてしまうようです。

つまり、descriptionとして定義されたものをString相当のものとして明確に扱えておらずTypeErrorで失敗するようです。

クラッシュしないケースでもこの動作が影響してfuzzy search自体がうまく実行されずリストが更新されないという挙動になっていると考えてよいでしょう。

おわりに

この問題自体はIssueには起票されているため、優先度が上がれば解消されることでしょう。
https://github.com/anthropics/claude-code/issues/18898
Claude Code自体は日々大量に機能更新・bugfixが行われているため、単に優先度が上がっていないか、機能の構造をなにか変えようとしているのかもしれません。個人的には、抜本的に、YAMLフォーマットでパース失敗するSKILL自体が単体でロードされない or なんらかユーザにこの状態を示してくれるようになるといいなと思います。

Discussion