RE:CZ

CZON開発ノート:リンク規範と機能計画

技術ログ

👤 ソフトウェア開発者と技術ブログ著者、特にドキュメント管理とAI支援ツールに関心のある人々
本記事は、作者が2026年2月9日に記録した開発ノートです。作者はまず、薬を適切に服用しなかったため風邪が悪化した個人的な経験を反省し、その後CZON開発の技術問題に焦点を当てています:プロジェクトルートディレクトリに対する絶対パス参照の使用を全面的に拒否し、規範性を高めるために相対参照を堅持することを決定し、checkコマンドを通じて無効なリンクを検査・修正する計画を立てました。runOpenCodeタスクのタイムアウト問題については、promptAsync + polling statusメソッドを使用しても10分を超えると600秒タイムアウトエラーが発生し、これはOpenCode自体の問題として解決が必要と指摘しています。さらに、作者はTODO Summary機能を計画し、AIにブログ内のTODO項目を抽出させ、自動的に優先度をマークすることで作業効率を向上させることを目指しています。
  • ✨ CZONはプロジェクトルートディレクトリに対する絶対パス参照の使用を全面的に拒否し、相対参照を堅持すべき
  • ✨ checkコマンドを追加してドキュメントリンクの有効性を検査し、自動修復をサポートする計画
  • ✨ TODO Summary機能を計画し、AIにブログ内のTODOを抽出させ、自動的に優先度をマーク
📅 2026-02-09 · 1,288 文字 · 約 5 分で読めます
  • CZON
  • リンク参照
  • TODO機能
  • 開発ノート
  • AI応用

現在は2026年2月9日、午後です。

今日もまた少し体調が優れません。数日前に風邪気味だった時、すぐに薬を飲むべきでした。結果、ここ数日は疲れやすく、だるさが続いています。当時、風邪薬を飲まなかった理由は、飲むと眠くなり、時間が無駄になると思ったからです。しかし、損失を止めなかった結果はさらに深刻で、今回は賭けに負けてしまいました。

本題に戻ります。昨日、CZON + Opus 4.6 を使ってブログの要約を一通り作成しましたが、その中にはリンク切れのものがありました。根本的な原因は、私のプロンプトにバグがあり、正しい指示を与えていなかったことです。

しかし、AIがあなたのすべての指示を一度に完全に従うことを期待すべきではないと考えています。これは、AIの非強制協調という物理的特性によるものです。

最初は、CZONでプロジェクトルートディレクトリからの絶対パス参照をサポートすべきか考えていました。しかし、後になって、それはあまり適切ではないと感じました。なぜなら、私はすでに .czon/src/<lang>/ ディレクトリも完全に正当なフラクタルディレクトリであると決めており、その中のすべてのファイル間の相互参照は完全に有効であるべきで、画像やハイパーリンクも有効であるべきだからです。

したがって、CZONは、プロジェクトルートディレクトリからの絶対パス参照の使用を全面的に拒否し、相対参照を堅持すべきです。VSCodeはこのような参照方法をサポートできますが、これは規範的ではなく、参照の意味を正確に表現できないと考えます。これは信頼性の低い参照方法であり、廃止されるべきです。

この拒否は、いくつかの互換性の問題を引き起こします。例えば、古いドキュメントの中にはリンクが切れているものがあることに気づくでしょう。しかし、比較的良い解決策として、CZONがドキュメント内のリンクが有効かどうかをチェックするための check コマンドを提供することが考えられます。無効なリンクを発見した場合、警告を出し、修正提案を提供する、さらには自動修正 (--fix オプション) を実行することができます。修正提案は、AIエージェントに直接渡して修正を実行させることもできます。修正が完了したら、build コマンドを再実行すればよいのです。

また、長時間実行される runOpenCode タスクを実行すると、依然として600秒のタイムアウトエラーが発生します。私は promptAsync + polling status という短縮方法を使用していますが、タスクの実行時間が10分を超えると、やはり600秒のタイムアウトが発生します。これはOpenCode自体の問題だと考えており、次にこの問題の解決を試みるつもりです。

さらに、私はTODOサマリー機能が必要だと考えています。私のすべてのブログ記事からTODOを抽出し、TODOリストのドキュメントを生成して、一括して確認できるようにする機能です。これは非常に興味深い機能ポイントです。AIにすべてのブログコンテンツを読ませ、私のTODOが完了しているかどうかを判断させます。そして、私は毎日このTODOリストを確認して、今何をすべきかを把握できるようにします。

もう一つ面白いことがあります。AIがすでに私の心の中の価値観の順序付けを検討できるのであれば、これらのTODOの優先順位を自動的にマークしてくれると、素晴らしいと思いませんか?

See Also

Referenced By