cluster: 4 refactor/docs follow-ups from #49 / #60 IDD lifecycles

.claude-plugin/migration-report-2026-05-02.md

@@ -0,0 +1,65 @@
+# Migration Report — psychquant-claude-plugins
+
+**Date**: 2026-05-02
+**Mode**: Applied
+**Total plugins scanned**: 34
+**CHANGELOG.md created (or would be)**: 33
+**Skipped (already has CHANGELOG.md)**: 1
+**Failed**: 0
+
+## Generated CHANGELOG.md
+
+| Plugin | Segments | Dates resolved | Versions |
+|--------|----------|----------------|----------|
+| `agent-cacher` | 1 | 0/1 | 0.1.0 |
+| `ai-docs-guide` | 1 | 0/1 | 1.4.0 |
+| `archive-first` | 1 | 0/1 | 2.1.0 |
+| `changelog-tools` | 1 | 0/1 | 0.1.0 |
+| `che-apple-mail-mcp` | 1 | 1/1 | 2.9.0 |
+| `che-apple-notes-mcp` | 1 | 0/1 | 0.2.1 |
+| `che-archive-lines` | 1 | 0/1 | 1.0.0 |
+| `che-bot-toolkit` | 1 | 0/1 | 0.1.0 |
+| `che-creative-suite` | 1 | 0/1 | 0.1.0 |
+| `che-dropbox-ignore` | 1 | 0/1 | 2.1.0 |
+| `che-duckdb-mcp` | 1 | 0/1 | 2.2.1 |
+| `che-ical-mcp` | 1 | 0/1 | 1.7.2 |
+| `che-pixel-mcp` | 1 | 0/1 | 0.1.1 |
+| `che-svg-mcp` | 1 | 0/1 | 0.1.1 |
+| `che-telegram-mcp` | 1 | 0/1 | 1.3.0 |
+| `che-things-mcp` | 1 | 0/1 | 1.6.2 |
+| `che-word-mcp` | 15 | 15/15 | 3.17.8, 3.17.7, 3.17.6, 3.17.5, 3.17.4... |
+| `che-xcode-mcp` | 1 | 0/1 | 1.0.1 |
+| `che-zotero-mcp` | 1 | 0/1 | 1.0.2 |
+| `claude-switch` | 1 | 0/1 | 1.0.0 |
+| `cli-tools` | 1 | 0/1 | 1.1.1 |
+| `codex-batch` | 1 | 0/1 | 1.0.0 |
+| `gifthub` | 1 | 0/1 | 1.1.0 |
+| `lean-prover` | 1 | 0/1 | 1.1.0 |
+| `macdoc` | 1 | 0/1 | 1.1.0 |
+| `mcp-tools` | 1 | 0/1 | 1.15.1 |
+| `parallel-ai-agents` | 1 | 0/1 | 2.1.1 |
+| `perspective-writer` | 1 | 0/1 | 2.5.0 |
+| `plugin-tools` | 1 | 0/1 | 1.15.0 |
+| `postgresql-guide` | 1 | 0/1 | 1.0.0 |
+| `r-docs-guide` | 1 | 0/1 | 1.0.0 |
+| `r-shiny-debugger` | 1 | 0/1 | 1.0.0 |
+| `tool-finder` | 1 | 0/1 | 1.0.0 |
+
+## Skipped (existing CHANGELOG.md)
+
+- `issue-driven-dev`
+
+## Failed
+
+(none)
+
+## Manual review needed
+
+Generated CHANGELOG.md files use best-effort categorization. Review each for:
+
+1. Section assignment — `### Added` / `### Changed` / `### Fixed` etc. may need re-categorization
+2. `(date unknown — please fill in)` entries — manually fill from git tags / release notes / memory
+3. Sentence splitting in non-English content (Chinese punctuation `。` not split)
+4. Cross-referenced versions (mentioned multiple times) — content from later mentions absorbed into prior segment
+
+Run `/changelog-tools:changelog-validate <plugin-path>` on each plugin after review.

.claude/issue-driven-dev.local.md

@@ -0,0 +1,5 @@
+---
+github_repo: "PsychQuant/psychquant-claude-plugins"
+github_owner: "PsychQuant"
+attachments_release: "attachments"
+---

.gitignore

@@ -18,3 +18,6 @@
 
 # Local testing
 .local/
+
+# Spectra app data
+.spectra/

.spectra.yaml

@@ -0,0 +1,32 @@
+# Spectra application config
+# See: https://github.com/spectra-app/spectra
+
+# OpenSpec directory path (relative to project root)
+# Changing this requires rebuilding the vector search index.
+# spec_dir: docs/specs
+
+# Language for AI-generated artifacts
+# locale: tw
+
+# Workflow toggles
+# tdd: true
+# audit: true
+# parallel_tasks: true
+
+# Claude slash commands (set true to also generate /spectra:X commands)
+# claude_slash_commands: true
+
+# Enable git worktree support for isolated change branches
+# worktree: true
+
+# Custom git worktrees directory
+# worktrees_dir: .spectra/worktrees
+
+# Claude Code skill effort levels (low/medium/high/max)
+# claude_effort:
+#   apply: high
+
+# AI tools to generate instruction files for
+# tools:
+#   - claude
+#   - cursor

CLAUDE.md

@@ -30,7 +30,6 @@ psychquant-claude-plugins/
 │   ├── che-things-mcp/          # Things 3 任務管理
 │   ├── che-word-mcp/            # Word 文件處理
 │   ├── che-xcode-mcp/           # Xcode / App Store Connect
-│   ├── claude-config-guide/     # [deprecated] → ai-docs-guide
 │   ├── claude-switch/           # Claude Code 多帳號管理
 │   ├── codex-batch/             # Codex CLI 批次生成
 │   ├── mcp-tools/               # MCP Server 開發工具集
@@ -115,13 +114,12 @@ psychquant-claude-plugins/
 **用途**: Auto-triggered Skills，自動 WebFetch Claude Code 和 OpenAI 官方文檔
 
 **Skills**:
-- `claude-docs-guide` — Claude Code CLI 設定（MCP、settings、hooks、skills）、Claude API/SDK
+- `claude-code-guide` — Claude Code CLI 設定（MCP、settings、hooks、skills）、Claude API/SDK
 - `openai-docs-guide` — OpenAI API（Responses API、Chat Completions、models）、Agents SDK、Realtime API
 
 **背景**:
 - OpenAI Docs MCP 的 `fetch_openai_doc` tool 壞掉（server-side bug），所有 URL 回 404
 - 此 plugin 繞過壞掉的 MCP fetch，直接 WebFetch `https://developers.openai.com/docs/...`
-- 取代了舊的 `claude-config-guide` plugin
 
 ### che-dropbox-ignore (scaffold)
 

README.md

@@ -2,6 +2,20 @@
 
 個人 Claude Code Plugin Marketplace，專注於學術研究與生產力工具。
 
+> ## 📦 IDD has moved
+>
+> **`issue-driven-dev` 從本 marketplace 搬到 [`PsychQuant/issue-driven-development`](https://github.com/PsychQuant/issue-driven-development) 自立門戶（自 2026-05-02）。**
+>
+> 既有 install 需重新指 source：
+>
+> ```bash
+> claude plugin uninstall issue-driven-dev@psychquant-claude-plugins
+> claude plugin marketplace add PsychQuant/issue-driven-development
+> claude plugin install issue-driven-dev@issue-driven-development
+> ```
+>
+> 設定（`.claude/issue-driven-dev.local.json`、`.claude/.idd/`）在 project repo 裡，不用搬。
+
 ## 安裝
 
 ```bash
@@ -26,7 +40,6 @@
 | **mcp-tools** | MCP Server 開發工具集 | - |
 | **r-shiny-debugger** | R Shiny App 功能測試 | - |
 | **ai-docs-guide** | Claude Code + OpenAI 文檔查詢助手 | - |
-| **claude-config-guide** | ~~Claude Code 設定查詢~~ (已被 ai-docs-guide 取代) | - |
 | **postgresql-guide** | PostgreSQL 文檔查詢助手 | - |
 | **che-dropbox-ignore** | Dropbox 同步排除管理 | - |
 | **claude-switch** | Claude Code 模型切換 | - |
@@ -152,17 +165,11 @@ MCP Server 開發必備工具，提供完整的除錯與測試流程。
 Claude Code + OpenAI 文檔查詢助手。整合兩個 Auto-triggered Skills，自動根據問題類型 WebFetch 對應官方文檔。
 
 **包含 Skills**:
-- `claude-docs-guide` — Claude Code CLI / API / SDK 文檔
+- `claude-code-guide` — Claude Code CLI / API / SDK 文檔
 - `openai-docs-guide` — OpenAI API / SDK / Models 文檔
 
 **特點**: 繞過 OpenAI Docs MCP 壞掉的 `fetch_openai_doc` tool，直接 WebFetch 官方文檔 URL。
 
----
-
-### claude-config-guide (deprecated)
-
-> **已被 `ai-docs-guide` 取代**。功能完全包含在 `ai-docs-guide` 的 `claude-docs-guide` skill 中。
-
 ## License
 
 MIT

docs/codex-calling-convention.md

@@ -0,0 +1,80 @@
+# Codex 呼叫原則
+
+Plugin 中呼叫 Codex CLI 的標準做法。
+
+## 一次性任務（預設選擇）
+
+```bash
+codex exec --full-auto \
+  -c 'model_reasoning_effort="xhigh"' \
+  -o output.md \
+  "prompt"
+```
+
+- `--full-auto`：workspace-write sandbox + auto approval
+- `-c 'model_reasoning_effort="..."'`：`none | minimal | low | medium | high | xhigh`
+- `-o FILE`：最後一條 message 直接寫入檔案（不怕 stdout 截斷）
+- `-C DIR`：指定工作目錄
+- `--add-dir DIR`：額外可寫目錄
+- stdin 傳 prompt：`cat prompt.txt | codex exec --full-auto -`
+
+適用：ensemble review 的 Codex 盲驗、單次 delegation、code review。
+
+## 需要 job management 時（罕見）
+
+```bash
+node codex-companion.mjs task --write --effort xhigh "prompt"
+node codex-companion.mjs status --all
+node codex-companion.mjs result $JOB_ID
+node codex-companion.mjs cancel $JOB_ID
+```
+
+- 必須加 `--write`，否則預設 read-only sandbox
+- companion 路徑會隨版本更新，不要硬編
+
+適用：多個並行 background jobs 且需要 status/cancel 管理。
+
+## 不要做的事
+
+- **不加 `--write` 的 companion** — 預設 read-only，Codex 無法寫檔或跑 R
+- **硬編 companion 路徑** — 版本號（如 `1.0.1`）會過時：
+  ```bash
+  # 不好
+  node "$HOME/.claude/plugins/cache/openai-codex/codex/1.0.1/scripts/codex-companion.mjs"
+
+  # 較好（如果必須用 companion）
+  node "$HOME/.claude/plugins/marketplaces/openai-codex/plugins/codex/scripts/codex-companion.mjs"
+  ```
+- **用 `-m o3` 替代 effort 設定** — 不同模型用途不同；effort 控制的是思考深度
+
+## 對照表
+
+| | `codex exec` | `codex-companion.mjs` |
+|---|---|---|
+| 寫入權限 | `--full-auto` | `--write` |
+| Effort | `-c 'model_reasoning_effort="xhigh"'` | `--effort xhigh` |
+| 輸出 | `-o file.md` | stdout（可能截斷） |
+| Job 管理 | 無（一次性） | status / result / cancel |
+| Session 恢復 | `codex exec resume` | `--resume` |
+| 架構 | 直接跑 CLI | 透過 app-server WebSocket |
+
+## 範例：ensemble review 的 Codex 盲驗
+
+```bash
+codex exec --full-auto \
+  -c 'model="gpt-5.5"' \
+  -c 'model_reasoning_effort="xhigh"' \
+  -c 'service_tier="fast"' \
+  -o reviews/codex-review.md \
+  "審閱 solution.tex，從 methodology/writing/references 三角度。用繁體中文。"
+```
+
+## 範例：仲裁兩份解答
+
+```bash
+cat arbitration-prompt.txt | codex exec --full-auto \
+  -c 'model_reasoning_effort="xhigh"' \
+  --add-dir "$(pwd)/reviews" \
+  -o reviews/arbitration-codex.md \
+  -
+```

openspec/changes/archive/2026-04-17-archive-mail-downloads-and-routing/.openspec.yaml

@@ -0,0 +1,6 @@
+schema: spec-driven
+created: 2026-04-16
+created_by: che cheng <kiki830621@gmail.com>
+created_with: claude
+archived_by: che cheng <kiki830621@gmail.com>
+archived_at: 2026-04-17