devlog-tracker 0.24.0 → 0.25.0

package/README.md

@@ -1,6 +1,6 @@
 # devlog-tracker
 
-**版本** 0.24.0
+**版本** 0.25.0
 
 在專案中維護一份 `.devlog/devlog.md`，把每一輪對話的請求、決策與結果寫成永久紀錄。對話一 `/clear` 或換 session 就沒了；這份檔案取代那個缺口，讓工作可以中斷再接。沒下過 `/devlog-tracker:start` 時，裝著也不會動任何檔案。
 
@@ -46,10 +46,10 @@ npx devlog-tracker init --codex --cursor
 其他工具已設定的 hook）。重新執行 `npx devlog-tracker init` 可以升級到套件目前的
 版本；`npx devlog-tracker status` 可以查目前裝的版本是否落後。
 
-裝 Codex 時，`init` 還會在專案根目錄的 `AGENTS.md` 加上（或更新）一段以
-`<!-- devlog-tracker:begin/end -->` 包住的說明，告訴 Codex 沒有 slash 指令時該讀
-`.devlog-tracker/commands/*.md`。區塊外的內容不會動，重跑 `init` 只會換掉區塊本身；
-區塊裡只有相對路徑，可以 commit。
+裝 Codex 時，`init` 會從 `.devlog-tracker/commands/*.md` 產生對應的專案指令到
+`.codex/prompts/`，例如以 `/prompts:devlog-start` 啟動追蹤。也會在專案根目錄的
+`AGENTS.md` 加上（或更新）一段以 `<!-- devlog-tracker:begin/end -->` 包住的 fallback
+說明。區塊外的內容不會動，重跑 `init` 只會換掉區塊本身；區塊裡只有相對路徑，可以 commit。
 
 裝完 Codex 之後，第一次還要在 Codex 裡核准這些 hook，否則不會記錄（見下方〈Codex（選用）〉的「hook 需要審核」）。
 
@@ -106,8 +106,9 @@ Codex 目前沒有對應「使用者中斷」（Claude Code 的 `PostToolUseFail
 Codex 上不會被標記成 `INTERRUPTED`；核心強制記錄機制（`Stop` 事件擋住未寫完的
 輪次）不受影響。
 
-Codex 沒有 `/devlog-tracker:*` slash 指令面；hooks 裝好後，請用與 Claude commands
-相同的腳本（`commands/*.md` 會優先讀 `CLAUDE_PLUGIN_ROOT`，否則讀
+Codex 使用 `/prompts:devlog-<名稱>`（例如 `/prompts:devlog-start`）執行指令；它們會
+讀與 Claude commands 相同的內容。若使用的 Codex 環境沒有載入 custom prompts，仍可直接
+使用以下腳本（`commands/*.md` 會優先讀 `CLAUDE_PLUGIN_ROOT`，否則讀
 `DEVLOG_TRACKER_ROOT`）：
 
 ```bash

package/cli/agents-md.js

@@ -8,16 +8,16 @@ const END = '<!-- devlog-tracker:end -->';
 const BLOCK = `${BEGIN}
 ## devlog-tracker
 
-這個專案用 devlog-tracker 在 \`.devlog/devlog.md\` 維護逐輪紀錄（Claude Code 與 Codex 共用同一份）。Codex 沒有 \`/devlog-tracker:*\` slash 指令，請照下面對照做：
+這個專案用 devlog-tracker 在 \`.devlog/devlog.md\` 維護逐輪紀錄（Claude Code 與 Codex 共用同一份）。Codex 指令在 \`.codex/prompts/\`，以 \`/prompts:devlog-<名稱>\` 執行；若 slash command 不可用，請照下面對照做：
 
 1. 先 \`source .devlog-tracker/env.sh\`（設定 \`DEVLOG_TRACKER_ROOT\`）。
 2. 依使用者意圖讀對應的 \`.devlog-tracker/commands/<名稱>.md\`，照裡面的步驟做（腳本在 \`.devlog-tracker/hooks/scripts/\`，執行時 \`CLAUDE_PROJECT_DIR\` 設成專案根目錄）。
 
 | 使用者說 | 讀這份 |
 |---|---|
-| 開始追蹤 / start | \`commands/start.md\` |
-| 暫停 / pause | \`commands/pause.md\` |
-| 狀態 / status | \`commands/status.md\` |
+| 開始追蹤 / start | \`/prompts:devlog-start\`；\`commands/start.md\` |
+| 暫停 / pause | \`/prompts:devlog-pause\`；\`commands/pause.md\` |
+| 狀態 / status | \`/prompts:devlog-status\`；\`commands/status.md\` |
 | 接續上一題 / continue（換過工具或 \`/clear\` 之後） | \`commands/continue.md\` |
 | 歸檔 / compact | \`commands/compact.md\` |
 | 清空重編 / clean（不可復原，先問使用者確認） | \`commands/clean.md\` |

package/cli/agents-md.test.js

@@ -40,19 +40,27 @@ test('is idempotent and replaces the block in place', () => {
   assert.equal(once.split(BEGIN).length, 2);
 });
 
-test('block mentions every command doc so Codex has an entry for each', () => {
+test('block mentions every command doc and Codex prompt naming convention', () => {
   const commandsDir = path.join(__dirname, '..', 'commands');
   const text = fs.readFileSync(upsertAgentsMd(tmp()), 'utf8');
   for (const file of fs.readdirSync(commandsDir).filter((f) => f.endsWith('.md'))) {
     assert.ok(text.includes(`commands/${file}`), `AGENTS.md block is missing commands/${file}`);
   }
+  assert.ok(text.includes('/prompts:devlog-start'));
 });
 
-test('init --codex writes AGENTS.md; --cursor alone does not', async () => {
+test('init --codex writes AGENTS.md and custom prompts; --cursor alone does not', async () => {
   const repoRoot = path.join(__dirname, '..');
   const withCodex = tmp();
   await run(['--codex'], { repoRoot, targetDir: withCodex, version: '0.0.0' });
   assert.ok(fs.existsSync(path.join(withCodex, 'AGENTS.md')));
+  for (const file of fs.readdirSync(path.join(repoRoot, 'commands')).filter((file) => file.endsWith('.md'))) {
+    const prompt = fs.readFileSync(
+      path.join(withCodex, '.codex', 'prompts', `devlog-${path.basename(file, '.md')}.md`),
+      'utf8'
+    );
+    assert.match(prompt, /\$ARGUMENTS/);
+  }
 
   const cursorOnly = tmp();
   await run(['--cursor'], { repoRoot, targetDir: cursorOnly, version: '0.0.0' });

package/cli/platforms/codex.js

@@ -1,15 +1,33 @@
 'use strict';
+const fs = require('fs');
 const path = require('path');
 const { mergeHooksTemplate } = require('../merge-hooks');
 const { upsertAgentsMd } = require('../agents-md');
 
+function installPrompts({ targetDir, vendorRoot }) {
+  const commandsDir = path.join(vendorRoot, 'commands');
+  const promptsDir = path.join(targetDir, '.codex', 'prompts');
+  fs.mkdirSync(promptsDir, { recursive: true });
+  for (const file of fs.readdirSync(commandsDir)) {
+    if (!file.endsWith('.md')) continue;
+    const command = path.basename(file, '.md');
+    const source = path.join(commandsDir, file);
+    const destination = path.join(promptsDir, `devlog-${command}.md`);
+    fs.writeFileSync(
+      destination,
+      `${fs.readFileSync(source, 'utf8').trimEnd()}\n\n使用者提供的額外參數：$ARGUMENTS\n`
+    );
+  }
+}
+
 function install({ repoRoot, targetDir, vendorRoot }) {
   mergeHooksTemplate({
     templatePath: path.join(repoRoot, 'codex', 'hooks.json'),
     targetPath: path.join(targetDir, '.codex', 'hooks.json'),
     vendorRoot,
   });
+  installPrompts({ targetDir, vendorRoot });
   upsertAgentsMd(targetDir);
 }
 
-module.exports = { install };
+module.exports = { install, installPrompts };

package/hooks/scripts/tests/test-cli-init-e2e.sh

@@ -19,6 +19,7 @@ NODE_BIN="$(command -v node)"
 [ -f "$PROJECT/.devlog-tracker/VERSION" ] && echo "PASS: vendored VERSION exists" || { echo "FAIL: no VERSION"; FAIL=1; }
 [ -f "$PROJECT/.devlog-tracker/env.sh" ] && echo "PASS: vendored env.sh exists" || { echo "FAIL: no env.sh"; FAIL=1; }
 [ -f "$PROJECT/.codex/hooks.json" ] && echo "PASS: .codex/hooks.json written" || { echo "FAIL: no .codex/hooks.json"; FAIL=1; }
+[ -f "$PROJECT/.codex/prompts/devlog-start.md" ] && echo "PASS: Codex start prompt written" || { echo "FAIL: no Codex start prompt"; FAIL=1; }
 [ -f "$PROJECT/.cursor/hooks.json" ] && echo "PASS: .cursor/hooks.json written" || { echo "FAIL: no .cursor/hooks.json"; FAIL=1; }
 
 # re-running must not duplicate entries

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devlog-tracker",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "npx installer for the devlog-tracker Claude Code plugin's Cursor and Codex adapters.",
   "bin": {
     "devlog-tracker": "bin/devlog-tracker.js"