Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Skills hardcode `~/.plannotator`: `plannotator-compound` ignores `$XDG_DATA_HOME` and can silently switch the data directory

クローズ
#2,305 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

関連するプルリクエストがすでにマージされています。

  • #2411 @backnotprop による — マージ済み

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
53/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
活発
技術スタック
typescript

調査の方向性

Start with packages/shared/data-dir.ts to confirm the directory resolution order, then read the listed plannotator-compound skill files and apps/skills/core/plannotator/SKILL.md. Check how skill commands are exposed before assessing the proposed plannotator data-dir approach. Done means the skills use the resolved directory consistently, including XDG-only installs, and document the behavior.

索引モデルが issue の本文から書いたものです。

説明

Problem
getPlannotatorDataDir() (packages/shared/data-dir.ts) resolves the data directory as:

  1. PLANNOTATOR_DATA_DIR
  2. an existing ~/.plannotator
  3. $XDG_DATA_HOME/plannotator (absolute path)
  4. ~/.plannotator

The skills still describe and use the pre-XDG default:

  • apps/skills/extra/plannotator-compound/SKILL.md lines 25, 58 and 522 (v0.28.30 and main):
    ${PLANNOTATOR_DATA_DIR:-~/.plannotator}, to read plans/ and to create
    hooks/compound/enterplanmode-improve-hook.txt;
  • apps/skills/extra/plannotator-compound/references/claude-code-fallback.md;
  • apps/skills/core/plannotator/SKILL.md: the variable table says "default ~/.plannotator".

Impact (derived from reading the code at v0.28.30 and main; I have not run the skill end to end)
On an XDG-only install (no ~/.plannotator):

  • the skill does not find the plan archive and falls back to the Claude Code mode or asks the user;
  • if the improvement hook is enabled, the skill creates ~/.plannotator/hooks/compound/;
    that makes ~/.plannotator exist, so rank 2 of the resolution wins and the binary silently
    switches to it, leaving plans, history, feedback and drafts under $XDG_DATA_HOME/plannotator
    unreachable.

Proposal
Add a command that prints the resolved directory (for example plannotator data-dir) and have the
skills call it instead of re-implementing the resolution. At minimum, document the four-step order
in the skills.

Related: #1051.

主要言語
TypeScript
スター
8.7k
フォーク
649
平均マージ
10時間 3分
マージ済み PR(30日)
618

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

backnotprop/plannotator のほかの issue

backnotprop/plannotator の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。