devlog-tracker 0.24.0 → 0.25.1

package/README.md

@@ -1,6 +1,6 @@
 # devlog-tracker
 
-**版本** 0.24.0
+**版本** 0.25.1
 
 在專案中維護一份 `.devlog/devlog.md`，把每一輪對話的請求、決策與結果寫成永久紀錄。對話一 `/clear` 或換 session 就沒了；這份檔案取代那個缺口，讓工作可以中斷再接。沒下過 `/devlog-tracker:start` 時，裝著也不會動任何檔案。
 
@@ -46,10 +46,12 @@ 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` 產生對應的專案 skill 到
+`.agents/skills/devlog-<名稱>/SKILL.md`，例如在 Codex 打 `$devlog-start`（或用 `/skills`
+選）啟動追蹤。舊版（0.25.0）寫到 `.codex/prompts/` 的檔案會在重跑 `init` 時清掉——
+Codex 不讀專案層級的 custom prompts。也會在專案根目錄的
+`AGENTS.md` 加上（或更新）一段以 `<!-- devlog-tracker:begin/end -->` 包住的 fallback
+說明。區塊外的內容不會動，重跑 `init` 只會換掉區塊本身；區塊裡只有相對路徑，可以 commit。
 
 裝完 Codex 之後，第一次還要在 Codex 裡核准這些 hook，否則不會記錄（見下方〈Codex（選用）〉的「hook 需要審核」）。
 
@@ -106,8 +108,8 @@ Codex 目前沒有對應「使用者中斷」（Claude Code 的 `PostToolUseFail
 Codex 上不會被標記成 `INTERRUPTED`；核心強制記錄機制（`Stop` 事件擋住未寫完的
 輪次）不受影響。
 
-Codex 沒有 `/devlog-tracker:*` slash 指令面；hooks 裝好後，請用與 Claude commands
-相同的腳本（`commands/*.md` 會優先讀 `CLAUDE_PLUGIN_ROOT`，否則讀
+Codex 使用 `$devlog-<名稱>`（例如 `$devlog-start`）執行指令；它們會讀與 Claude
+commands 相同的內容。若使用的 Codex 環境沒有載入專案 skills，仍可直接使用以下腳本（`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 指令是 \`.agents/skills/devlog-<名稱>/\` 底下的 skill，用 \`/skills\` 選或打 \`$devlog-<名稱>\` 執行；若 skill 不可用，請照下面對照做：
 
 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 | \`$devlog-start\`；\`commands/start.md\` |
+| 暫停 / pause | \`$devlog-pause\`；\`commands/pause.md\` |
+| 狀態 / status | \`$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,35 @@ 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 skill 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('$devlog-start'));
 });
 
-test('init --codex writes AGENTS.md; --cursor alone does not', async () => {
+test('init --codex writes AGENTS.md and project skills; --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 name = `devlog-${path.basename(file, '.md')}`;
+    const skill = fs.readFileSync(path.join(withCodex, '.agents', 'skills', name, 'SKILL.md'), 'utf8');
+    assert.match(skill, new RegExp(`^---\\nname: ${name}\\ndescription: ".+"\\n---\\n`));
+  }
+  assert.ok(!fs.existsSync(path.join(withCodex, '.codex', 'prompts')));
+
+  const upgraded = tmp();
+  const legacy = path.join(upgraded, '.codex', 'prompts');
+  fs.mkdirSync(legacy, { recursive: true });
+  fs.writeFileSync(path.join(legacy, 'devlog-start.md'), 'old');
+  fs.writeFileSync(path.join(legacy, 'mine.md'), 'keep');
+  await run(['--codex'], { repoRoot, targetDir: upgraded, version: '0.0.0' });
+  assert.ok(!fs.existsSync(path.join(legacy, 'devlog-start.md')));
+  assert.ok(fs.existsSync(path.join(legacy, 'mine.md')));
 
   const cursorOnly = tmp();
   await run(['--cursor'], { repoRoot, targetDir: cursorOnly, version: '0.0.0' });

package/cli/platforms/codex.js

@@ -1,15 +1,52 @@
 'use strict';
+const fs = require('fs');
 const path = require('path');
 const { mergeHooksTemplate } = require('../merge-hooks');
 const { upsertAgentsMd } = require('../agents-md');
 
+// Codex 只從 ~/.codex/prompts/ 讀 custom prompts（且已棄用），不會讀專案內的
+// .codex/prompts/；專案層級的指令要做成 .agents/skills/<name>/SKILL.md，以 $<name> 叫用。
+function parseCommand(text) {
+  const match = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/.exec(text);
+  if (!match) return { description: '', body: text };
+  const description = /^description:\s*(.*)$/m.exec(match[1]);
+  return { description: description ? description[1].trim() : '', body: match[2] };
+}
+
+// 0.25.0 曾把 prompts 寫到 .codex/prompts/devlog-*.md，Codex 讀不到；升級時清掉。
+function removeLegacyPrompts(targetDir) {
+  const promptsDir = path.join(targetDir, '.codex', 'prompts');
+  if (!fs.existsSync(promptsDir)) return;
+  for (const file of fs.readdirSync(promptsDir)) {
+    if (/^devlog-.*\.md$/.test(file)) fs.rmSync(path.join(promptsDir, file));
+  }
+  if (fs.readdirSync(promptsDir).length === 0) fs.rmdirSync(promptsDir);
+}
+
+function installSkills({ targetDir, vendorRoot }) {
+  const commandsDir = path.join(vendorRoot, 'commands');
+  for (const file of fs.readdirSync(commandsDir)) {
+    if (!file.endsWith('.md')) continue;
+    const name = `devlog-${path.basename(file, '.md')}`;
+    const { description, body } = parseCommand(fs.readFileSync(path.join(commandsDir, file), 'utf8'));
+    const skillDir = path.join(targetDir, '.agents', 'skills', name);
+    fs.mkdirSync(skillDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(skillDir, 'SKILL.md'),
+      `---\nname: ${name}\ndescription: ${JSON.stringify(description)}\n---\n\n${body.trim()}\n\n使用者提供的額外參數：請看觸發這個 skill 的使用者訊息。\n`
+    );
+  }
+  removeLegacyPrompts(targetDir);
+}
+
 function install({ repoRoot, targetDir, vendorRoot }) {
   mergeHooksTemplate({
     templatePath: path.join(repoRoot, 'codex', 'hooks.json'),
     targetPath: path.join(targetDir, '.codex', 'hooks.json'),
     vendorRoot,
   });
+  installSkills({ targetDir, vendorRoot });
   upsertAgentsMd(targetDir);
 }
 
-module.exports = { install };
+module.exports = { install, installSkills };

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/.agents/skills/devlog-start/SKILL.md" ] && echo "PASS: Codex start skill written" || { echo "FAIL: no Codex start skill"; 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.1",
   "description": "npx installer for the devlog-tracker Claude Code plugin's Cursor and Codex adapters.",
   "bin": {
     "devlog-tracker": "bin/devlog-tracker.js"