adspecs 0.1.26 → 0.1.28

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "adspecs",
       "description": "AI Coding研发协同开发插件",
-      "version": "0.1.26",
+      "version": "0.1.28",
       "source": "./",
       "author": {
         "name": "Qingwen Chen",

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "adspecs",
   "displayName": "adspecs AI Plugin",
   "description": "AI first工程规范驱动开发插件",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "author": {
     "name": "Qingwen Chen",
     "email": "cqinwn@qq.com",

package/.qoder-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "adspecs",
   "displayName": "adspecs AI 工程规范驱动开发插件",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
   "descriptionZh": "AI优先的工程规范驱动开发插件，覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
   "author": {
@@ -25,7 +25,6 @@
     "documentation"
   ],
   "skills": "./skills/",
-  "rules": "./rules/",
   "hooks": "./hooks/hooks.json",
   "preserveUpstreamMetadata": true
 }

package/CLAUDE.md

@@ -96,22 +96,27 @@ Skills check for `.adspecs/extensions.yml` in the target project root, supportin
 
 ## Hooks System
 
-Hooks are configured in `hooks/hooks.json` and run as Node.js scripts:
+Hooks are configured in `hooks/hooks.json` and run as Node.js scripts. A shared platform detection module (`hooks/platform.js`) provides cross-platform compatibility between Claude Code and Qoder:
 
 | Event                                             | Script                    | Purpose                                                                                   |
 | ------------------------------------------------- | ------------------------- | ----------------------------------------------------------------------------------------- |
-| `SessionStart`                                    | `session-start.js`        | Injects `skills/using-saeplugin/SKILL.md` as agent context (no-op if skill doesn't exist) |
-| `SessionStart`                                    | `wiki-queue.js init`      | Initialize wiki update queue file in `.claude/`                                           |
-| `SessionStart`                                    | `commit-queue.js init`    | Initialize commit candidates queue file in `.claude/`                                     |
+| `SessionStart`                                    | `session-start.js`        | Injects `skills/using-adspecs/SKILL.md` as agent context (no-op if skill doesn't exist) |
+| `SessionStart`                                    | `wiki-queue.js init`      | Initialize wiki update queue file in state dir                                            |
+| `SessionStart`                                    | `commit-queue.js init`    | Initialize commit candidates queue file in state dir                                      |
 | `SessionStart`                                    | `session-logger.js init`  | Detect unsaved previous session → inject recovery reminder or normal guidance              |
-| `PreCompact`                                      | `session-logger.js mark`  | Context compaction imminent → inject urgent save reminder for Claude to write log          |
-| `PostToolUse` (Write/Edit on code/doc files)      | `wiki-queue.js enqueue`   | Track changed files for wiki sync                                                         |
-| `PostToolUse` (Write on `pipeline-manifest.json`) | `commit-queue.js enqueue` | Track completed features for commit                                                       |
+| `PreCompact`                                      | `session-logger.js mark`  | Context compaction imminent → inject urgent save reminder for agent to write log           |
+| `PostToolUse` (Write/Edit/SearchReplace on code/doc files) | `wiki-queue.js enqueue` | Track changed files for wiki sync                                              |
+| `PostToolUse` (Write/SearchReplace on `pipeline-manifest.json`) | `commit-queue.js enqueue` | Track completed features for commit                                        |
 | `Stop`                                            | `wiki-queue.js report`    | Suggest wiki sync at session end                                                          |
 | `Stop`                                            | `commit-queue.js report`  | Suggest commit at session end                                                             |
 | `Stop`                                            | `session-logger.js report`| Mark session as missed if log not saved → recovery at next SessionStart                    |
 
-Hook scripts use `__dirname` for path resolution (not CWD). Queue files stored in `.claude/` (`.commit-candidates`, `.wiki-update-queue`, `.session-save-marker`).
+### Platform Detection (`hooks/platform.js`)
+
+- Detects platform via `ADSPECS_PLATFORM` env var, or platform-specific env vars (`CLAUDE_PLUGIN_ROOT` / `QODER_PLUGIN_ROOT`)
+- State directory: `.claude/` for Claude Code, `.qoder/` for Qoder
+- Tool output files: reads `CLAUDE_TOOL_OUTPUT_FILES` or `QODER_TOOL_OUTPUT_FILES`
+- Output protocol: unified `hookSpecificOutput.additionalContext` JSON stdout format
 
 ## Path Configuration
 
@@ -209,9 +214,12 @@ npm publish --registry=https://registry.npmjs.org
 ## Installation & Distribution
 
 ```bash
-# Register marketplace
+# Claude Code: Register marketplace + install
 claude plugins marketplace add <path-to>/.claude-plugin --scope user|project
-
-# Install plugin
 claude plugins install adspecs --scope user|project
+
+# Qoder: CLI install
+adspecs plugin install --platform qoder --scope user|project
+
+# Qoder: Manual — ensure .qoder-plugin/plugin.json is accessible to Qoder
 ```

package/INSTALL.md

@@ -2,7 +2,7 @@
 
 ## 环境准备
 
-### 1. 安装 superpowers 插件（前置依赖）
+### 1. 安装 superpowers 插件（前置依赖，仅 Claude Code）
 
 adspecs 的编码阶段依赖 `superpowers` 插件提供的 `subagent-driven-development`、`test-driven-development` 等通用 Skill，必须先安装：
 
@@ -22,7 +22,55 @@ adspecs 的编码阶段依赖 `superpowers` 插件提供的 `subagent-driven-dev
 /plugin install superpowers@superpowers-marketplace
 ```
 
-### 2. 安装 AdSpecs 插件
+> **注意**：Qoder 平台无需安装 superpowers，adspecs 的 Skills 在 Qoder 中可独立运行。
+
+---
+
+## 在 Qoder 中安装
+
+adspecs 通过 `.qoder-plugin/plugin.json` 提供 Qoder 原生插件支持。
+
+### 方式 A：CLI 自动安装（推荐）
+
+```bash
+# 全局安装 adspecs CLI
+npm install -g adspecs
+
+# 注册为 Qoder 插件（自动检测平台）
+adspecs plugin install --platform qoder
+
+# 或指定项目级安装
+adspecs plugin install --platform qoder --scope project
+```
+
+### 方式 B：手动安装
+
+1. 将 adspecs 插件目录放置到 Qoder 可访问的路径
+2. 确保目录中包含 `.qoder-plugin/plugin.json`
+3. 在 Qoder 插件设置中添加该目录路径
+4. 重启 Qoder 使插件生效
+
+### 方式 C：项目级安装（团队协作）
+
+```bash
+# 进入项目根目录
+cd /path/to/your/project
+
+# 注册为项目级 Qoder 插件
+adspecs plugin install --platform qoder --scope project
+```
+
+此命令会在项目中创建 `.qoder-plugin/` 链接，使插件随项目版本控制。
+
+### 卸载
+
+```bash
+adspecs plugin uninstall --platform qoder --scope project
+```
+
+---
+
+## 在 Claude Code 中安装
 
 adspecs 插件提供**用户级**和**项目级**两种安装方式，按需选择：
 
@@ -129,6 +177,18 @@ claude plugins update adspecs --scope project
 - **团队协作，需要统一插件版本** → 选**项目级**，插件随代码版本控制
 - **同时存在两种需求** → 两种可同时安装，项目级优先于用户级（就近原则）
 
-> **注意**：安装完成后，建议重启 Claude Code 以确保所有 Skill 被正确加载。如遇到 Skill 未生效，可执行 `/plugins` 查看当前已加载的插件列表。
+> **注意**：安装完成后，建议重启 AI 平台（Claude Code / Qoder）以确保所有 Skill 被正确加载。如遇到 Skill 未生效，可执行 `/plugins` 查看当前已加载的插件列表。
 
 ---
+
+## 跨平台环境变量
+
+adspecs hooks 支持通过环境变量控制平台行为：
+
+| 环境变量 | 说明 | 可选值 |
+|----------|------|--------|
+| `ADSPECS_PLATFORM` | 显式指定运行平台 | `claude` / `qoder` |
+| `CLAUDE_PLUGIN_ROOT` | Claude Code 注入的插件根路径 | 自动 |
+| `QODER_PLUGIN_ROOT` | Qoder 注入的插件根路径（如适用） | 自动 |
+
+通常无需手动设置，平台会自动注入。若 hooks 执行异常，可尝试设置 `ADSPECS_PLATFORM=qoder`。

package/bin/adspecs.js

@@ -44,12 +44,13 @@ program
 // ============ plugin 命令组 ============
 const pluginCmd = program
   .command('plugin')
-  .description('Claude Code 插件管理');
+  .description('AI 平台插件管理（支持 Claude Code / Qoder）');
 
 pluginCmd
   .command('install')
-  .description('注册当前 adspecs 为 Claude Code 插件')
+  .description('注册当前 adspecs 为 AI 平台插件')
   .option('--scope <scope>', '安装范围: user|project', 'user')
+  .option('--platform <platform>', '目标平台: claude|qoder（默认自动检测）')
   .action(async (options) => {
     try {
       const pluginCmd = require('../src/commands/plugin');
@@ -63,8 +64,9 @@ pluginCmd
 
 pluginCmd
   .command('uninstall')
-  .description('从 Claude Code 中卸载 adspecs 插件')
+  .description('从 AI 平台中卸载 adspecs 插件')
   .option('--scope <scope>', '卸载范围: user|project', 'user')
+  .option('--platform <platform>', '目标平台: claude|qoder（默认自动检测）')
   .action(async (options) => {
     try {
       const pluginCmd = require('../src/commands/plugin');
@@ -114,9 +116,10 @@ program.addHelpText('after', `
   $ adspecs init --mode simple                # 快速初始化（交互选择其余参数）
   $ adspecs init --non-interactive            # 完全非交互（使用默认值）
   $ adspecs init --project-name "我的项目" --mode full --front-demo antd
-  $ adspecs plugin install                    # 注册为 Claude Code 插件（默认 user 范围）
+  $ adspecs plugin install                    # 注册为 AI 平台插件（自动检测平台）
+  $ adspecs plugin install --platform qoder   # 注册为 Qoder 插件
+  $ adspecs plugin install --platform claude  # 注册为 Claude Code 插件
   $ adspecs plugin install --scope project    # 仅注册到当前项目
-  $ adspecs plugin install --scope user       # 注册到当前用户（全局可用）
   $ adspecs plugin uninstall --scope project  # 从当前项目卸载
   $ adspecs doctor                            # 检查环境依赖
   $ adspecs update                            # 升级到最新版本

package/hooks/commit-queue.js

@@ -6,6 +6,7 @@
  * 在 SessionStart / PostToolUse / Stop 三个 Hook 事件中管理 .commit-candidates 队列文件。
  * 当检测到 pipeline-manifest.json 写入（且 status=completed + mvn_compile=pass），
  * 自动将 feature 信息加入提交候选队列，Stop 时提示用户执行提交。
+ * 支持 Claude Code 和 Qoder 双平台。
  *
  * 用法:
  *   node hooks/commit-queue.js init      — SessionStart: 创建队列文件
@@ -15,13 +16,13 @@
 
 const fs = require('fs');
 const path = require('path');
+const platform = require('./platform');
 
 // ── 配置 ──────────────────────────────────────────────
-// 队列文件放在目标项目根目录的 .claude/ 下。
-// 使用 process.cwd() 获取目标项目根目录（Claude Code 运行 hook 时 CWD 即为目标项目）。
-// 注意：不能用 __dirname，因为 __dirname 指向的是插件安装目录，而非用户的目标项目。
-const PROJECT_ROOT = process.cwd();
-const QUEUE_DIR = path.join(PROJECT_ROOT, '.claude');
+// 队列文件放在目标项目根目录的平台状态目录下。
+// 使用 process.cwd() 获取目标项目根目录（平台运行 hook 时 CWD 即为目标项目）。
+const PROJECT_ROOT = platform.getProjectRoot();
+const QUEUE_DIR = platform.getStateDir(PROJECT_ROOT);
 const QUEUE_FILE = path.join(QUEUE_DIR, '.commit-candidates');
 
 // ── 工具函数 ──────────────────────────────────────────
@@ -230,8 +231,8 @@ switch (action) {
     break;
 
   case 'enqueue':
-    // CLAUDE_TOOL_OUTPUT_FILES 由 Claude Code Hook 运行时注入为环境变量
-    enqueueFromManifests(process.env.CLAUDE_TOOL_OUTPUT_FILES || '');
+    // 工具输出文件由平台 Hook 运行时注入为环境变量（兼容 Claude Code / Qoder）
+    enqueueFromManifests(platform.getToolOutputFiles());
     break;
 
   case 'report':

package/hooks/hooks.json

@@ -1,4 +1,5 @@
 {
+  "_comment": "跨平台 Hook 配置 — 同时支持 Claude Code 和 Qoder。${CLAUDE_PLUGIN_ROOT} 由平台在加载插件时注入（Qoder 兼容此变量或设置 ADSPECS_PLATFORM=qoder）。",
   "hooks": {
     "SessionStart": [
       {
@@ -35,7 +36,7 @@
     "PreToolUse": [],
     "PostToolUse": [
       {
-        "matcher": "Write|Edit",
+        "matcher": "Write|Edit|SearchReplace",
         "hooks": [
           {
             "type": "command",
@@ -43,11 +44,11 @@
           }
         ],
         "conditions": {
-          "filePattern": "\\.(java|py|ts|js|go|rs|cs|md)$"
+          "filePattern": "\\.(java|py|ts|js|go|rs|cs|md|vue|tsx|jsx)$"
         }
       },
       {
-        "matcher": "Write",
+        "matcher": "Write|SearchReplace",
         "hooks": [
           {
             "type": "command",

package/hooks/platform.js

@@ -0,0 +1,141 @@
+'use strict';
+
+/**
+ * Platform Detection — 跨 AI 平台兼容工具模块
+ *
+ * 为 hooks 脚本提供统一的平台检测、路径解析和输出协议，
+ * 同时支持 Claude Code 和 Qoder 两种 AI 编码平台。
+ *
+ * 检测优先级：
+ *   1. 环境变量 ADSPECS_PLATFORM 显式指定（'claude' | 'qoder'）
+ *   2. Qoder 特征环境变量（QODER_PLUGIN_ROOT 等）
+ *   3. Claude Code 特征环境变量（CLAUDE_PLUGIN_ROOT 等）
+ *   4. 默认回退到 claude（向后兼容）
+ */
+
+const path = require('path');
+
+// ── 平台检测 ──────────────────────────────────────────────
+
+/**
+ * 检测当前运行的 AI 平台
+ * @returns {'claude'|'qoder'}
+ */
+function detectPlatform() {
+  // 1. 显式指定
+  var explicit = (process.env.ADSPECS_PLATFORM || '').toLowerCase();
+  if (explicit === 'qoder' || explicit === 'claude') {
+    return explicit;
+  }
+
+  // 2. Qoder 特征
+  if (process.env.QODER_PLUGIN_ROOT || process.env.QODER_SESSION_ID) {
+    return 'qoder';
+  }
+
+  // 3. Claude Code 特征
+  if (process.env.CLAUDE_PLUGIN_ROOT || process.env.CLAUDE_SESSION_ID) {
+    return 'claude';
+  }
+
+  // 4. 默认回退
+  return 'claude';
+}
+
+/** 当前平台（模块加载时确定） */
+var PLATFORM = detectPlatform();
+
+// ── 路径解析 ──────────────────────────────────────────────
+
+/**
+ * 获取插件根目录
+ * 优先使用平台环境变量，回退到 __dirname 相对路径推导
+ *
+ * @param {string} hooksDir - 调用方的 __dirname（即 hooks/ 目录绝对路径）
+ * @returns {string} 插件根目录绝对路径
+ */
+function getPluginRoot(hooksDir) {
+  // 平台环境变量优先
+  var envRoot = process.env.CLAUDE_PLUGIN_ROOT || process.env.QODER_PLUGIN_ROOT;
+  if (envRoot) {
+    return path.resolve(envRoot);
+  }
+  // 回退：hooks/ 的上级目录即插件根
+  return path.resolve(hooksDir, '..');
+}
+
+/**
+ * 获取目标项目根目录
+ * 两种平台均使用 process.cwd()（运行时 CWD 即为目标项目）
+ *
+ * @returns {string}
+ */
+function getProjectRoot() {
+  return process.cwd();
+}
+
+/**
+ * 获取项目内的插件状态目录（用于存放队列文件、marker 等）
+ * - Claude Code: {project}/.claude/
+ * - Qoder:       {project}/.qoder/（若不存在则回退 .claude/ 保持兼容）
+ *
+ * @param {string} projectRoot - 项目根目录
+ * @returns {string}
+ */
+function getStateDir(projectRoot) {
+  if (PLATFORM === 'qoder') {
+    return path.join(projectRoot, '.qoder');
+  }
+  return path.join(projectRoot, '.claude');
+}
+
+// ── 环境变量适配 ──────────────────────────────────────────
+
+/**
+ * 获取工具输出文件列表（PostToolUse 时由平台注入）
+ * - Claude Code: CLAUDE_TOOL_OUTPUT_FILES
+ * - Qoder:       QODER_TOOL_OUTPUT_FILES 或 CLAUDE_TOOL_OUTPUT_FILES（兼容）
+ *
+ * @returns {string} 换行分隔的文件路径列表
+ */
+function getToolOutputFiles() {
+  return (
+    process.env.QODER_TOOL_OUTPUT_FILES ||
+    process.env.CLAUDE_TOOL_OUTPUT_FILES ||
+    ''
+  );
+}
+
+// ── 输出协议 ──────────────────────────────────────────────
+
+/**
+ * 输出 Hook 上下文到 stdout（供 AI 平台读取注入 Agent 上下文）
+ *
+ * 两种平台当前均使用相同的 JSON stdout 协议：
+ * { "hookSpecificOutput": { "hookEventName": "...", "additionalContext": "..." } }
+ *
+ * @param {string} eventName - Hook 事件名称
+ * @param {string} contextText - 要注入的上下文文本
+ */
+function outputContext(eventName, contextText) {
+  var output = {
+    hookSpecificOutput: {
+      hookEventName: eventName,
+      additionalContext: contextText,
+    },
+  };
+  process.stdout.write(JSON.stringify(output));
+}
+
+// ── 导出 ──────────────────────────────────────────────────
+
+module.exports = {
+  /** 当前检测到的平台: 'claude' | 'qoder' */
+  platform: PLATFORM,
+  detectPlatform: detectPlatform,
+  getPluginRoot: getPluginRoot,
+  getProjectRoot: getProjectRoot,
+  getStateDir: getStateDir,
+  getToolOutputFiles: getToolOutputFiles,
+  outputContext: outputContext,
+};

package/hooks/session-logger.js

@@ -4,7 +4,8 @@
  * Session Logger — AI 会话日志自动保存 Hook
  *
  * 在 SessionStart / PreCompact / Stop 三个事件中管理会话保存状态，
- * 通过 additionalContext 引导 Claude 自行生成并写入结构化日志文件。
+ * 通过 additionalContext 引导 AI Agent 自行生成并写入结构化日志文件。
+ * 支持 Claude Code 和 Qoder 双平台。
  *
  * 用法:
  *   node hooks/session-logger.js init   — SessionStart: 检测恢复 / 注入引导
@@ -14,12 +15,13 @@
 
 const fs = require('fs');
 const path = require('path');
+const platform = require('./platform');
 
 // ── 路径解析 ──────────────────────────────────────────────
 // 使用 process.cwd() 定位目标项目（不用 __dirname，因为 __dirname 指向插件目录）
-const PROJECT_ROOT = process.cwd();
-const CLAUDE_DIR = path.join(PROJECT_ROOT, '.claude');
-const MARKER_FILE = path.join(CLAUDE_DIR, '.session-save-marker');
+const PROJECT_ROOT = platform.getProjectRoot();
+const STATE_DIR = platform.getStateDir(PROJECT_ROOT);
+const MARKER_FILE = path.join(STATE_DIR, '.session-save-marker');
 const CONFIG_FILE = path.join(PROJECT_ROOT, '.adspecs', 'session-logger.json');
 const PATHS_FILE = path.join(PROJECT_ROOT, '.adspecs', 'paths.json');
 const FEATURE_FILE = path.join(PROJECT_ROOT, '.adspecs', 'feature.json');
@@ -112,7 +114,7 @@ function readMarker() {
 
 /** 写入 marker 文件（覆盖写，单行最新态） */
 function writeMarker(data) {
-  fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+  fs.mkdirSync(STATE_DIR, { recursive: true });
   fs.writeFileSync(MARKER_FILE, JSON.stringify(data) + '\n', 'utf8');
 }
 
@@ -135,15 +137,9 @@ function formatTimestamp(date) {
   return yyyy + MM + dd + '-' + HH + mm + ss;
 }
 
-/** 输出 additionalContext 到 stdout（供 Claude 读取） */
+/** 输出 additionalContext 到 stdout（供 AI 平台读取，使用平台统一协议） */
 function outputContext(eventName, contextText) {
-  var output = {
-    hookSpecificOutput: {
-      hookEventName: eventName,
-      additionalContext: contextText,
-    },
-  };
-  process.stdout.write(JSON.stringify(output));
+  platform.outputContext(eventName, contextText);
 }
 
 /** 计算两个 ISO 时间戳之间的分钟数 */

package/hooks/session-start.js

@@ -4,18 +4,19 @@
  * SessionStart Hook — 注入 using-adspecs 技能引导内容
  *
  * 在每次会话启动时，读取 using-adspecs/SKILL.md 并输出为
- * Claude Code hook additionalContext，确保 Agent 在任何任务开始前
+ * hook additionalContext，确保 Agent 在任何任务开始前
  * 都知道需要检查并使用 ADSpecs 技能。
  *
- * 机制参考：Superpowers hooks/session-start
+ * 跨平台兼容：Claude Code / Qoder
  */
 
 const fs = require('fs');
 const path = require('path');
+const platform = require('./platform');
 
 // ── 路径解析 ──────────────────────────────────────────
-// hooks/ 在项目根下，__dirname 总是指向 hooks/ 目录
-const PLUGIN_ROOT = path.join(__dirname, '..');
+// 使用平台工具解析插件根目录（兼容环境变量和 __dirname 回退）
+const PLUGIN_ROOT = platform.getPluginRoot(__dirname);
 const SKILL_PATH = path.join(PLUGIN_ROOT, 'skills', 'using-adspecs', 'SKILL.md');
 
 // ── 读取技能内容 ──────────────────────────────────────
@@ -32,13 +33,8 @@ if (!skillContent || skillContent.trim() === '') {
 }
 
 // ── 输出 Hook Context ─────────────────────────────────
-// Claude Code hook command 输出 JSON 到 stdout，
-// hookSpecificOutput.additionalContext 会被注入到 Agent 上下文
-var output = {
-  hookSpecificOutput: {
-    hookEventName: 'SessionStart',
-    additionalContext: '<EXTREMELY-IMPORTANT>\n' + skillContent + '\n</EXTREMELY-IMPORTANT>'
-  }
-};
-
-process.stdout.write(JSON.stringify(output));
+// 使用平台统一输出协议（hookSpecificOutput.additionalContext）
+platform.outputContext(
+  'SessionStart',
+  '<EXTREMELY-IMPORTANT>\n' + skillContent + '\n</EXTREMELY-IMPORTANT>'
+);

package/hooks/wiki-queue.js

@@ -5,6 +5,7 @@
  *
  * 在 SessionStart / PostToolUse / Stop 三个 Hook 事件中管理 .wiki-update-queue 队列文件。
  * 使用 Node.js（而非平台特定 Shell）确保 Windows / macOS / Linux 三平台兼容。
+ * 支持 Claude Code 和 Qoder 双平台。
  *
  * 用法:
  *   node hooks/wiki-queue.js init      — SessionStart: 创建队列文件
@@ -14,13 +15,13 @@
 
 const fs = require('fs');
 const path = require('path');
+const platform = require('./platform');
 
 // ── 配置 ──────────────────────────────────────────────
-// 队列文件放在目标项目根目录的 .claude/ 下。
-// 使用 process.cwd() 获取目标项目根目录（Claude Code 运行 hook 时 CWD 即为目标项目）。
-// 注意：不能用 __dirname，因为 __dirname 指向的是插件安装目录，而非用户的目标项目。
-const PROJECT_ROOT = process.cwd();
-const QUEUE_DIR = path.join(PROJECT_ROOT, '.claude');
+// 队列文件放在目标项目根目录的平台状态目录下。
+// 使用 process.cwd() 获取目标项目根目录（平台运行 hook 时 CWD 即为目标项目）。
+const PROJECT_ROOT = platform.getProjectRoot();
+const QUEUE_DIR = platform.getStateDir(PROJECT_ROOT);
 const QUEUE_FILE = path.join(QUEUE_DIR, '.wiki-update-queue');
 
 // ── 工具函数 ──────────────────────────────────────────
@@ -112,8 +113,8 @@ switch (action) {
     break;
 
   case 'enqueue':
-    // CLAUDE_TOOL_OUTPUT_FILES 由 Claude Code Hook 运行时注入为环境变量
-    appendToQueue(process.env.CLAUDE_TOOL_OUTPUT_FILES || '');
+    // 工具输出文件由平台 Hook 运行时注入为环境变量（兼容 Claude Code / Qoder）
+    appendToQueue(platform.getToolOutputFiles());
     break;
 
   case 'report':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adspecs",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "AI first 工程规范驱动开发插件 — 支持 npm 安装和 CLI 初始化",
   "bin": {
     "adspecs": "bin/adspecs.js"
@@ -42,6 +42,7 @@
   "keywords": [
     "adspecs",
     "claude-code",
+    "qoder",
     "plugin",
     "scaffold",
     "cli",

package/scripts/postinstall.js

@@ -2,7 +2,7 @@
 'use strict';
 
 /**
- * npm 安装/更新后自动刷新 Claude Code 插件注册
+ * npm 安装/更新后自动刷新 AI 平台插件注册
  *
  * 触发时机：
  * - `npm install -g adspecs`        → 首次安装
@@ -10,9 +10,9 @@
  * - `npm install adspecs` (本地)    → 作为项目依赖安装
  *
  * 行为：
- * - 检查 claude CLI 是否可用
- * - 检查 adspecs 插件是否已在 Claude Code 中注册
- * - 若已注册 → 静默重新安装以刷新版本（让 Claude Code 感知新版本）
+ * - 检查 AI 平台 CLI 是否可用（Claude Code / Qoder）
+ * - 检查 adspecs 插件是否已在平台中注册
+ * - 若已注册 → 静默重新安装以刷新版本
  * - 若未注册 → 不做任何事（首次安装应由用户主动 `adspecs plugin install`）
  *
  * 关键约束：
@@ -33,17 +33,22 @@ const timer = setTimeout(() => {
 if (timer.unref) timer.unref();
 
 try {
-  // 1. 检查 claude CLI 是否可用
+  // 1. 检测可用的 AI 平台
+  var hasClaudeCli = false;
   try {
     execSync('claude --version', { stdio: 'ignore', timeout: 1000 });
+    hasClaudeCli = true;
   } catch {
-    // claude CLI 未安装 → 静默退出
+    // claude CLI 未安装
+  }
+
+  // 如果没有任何平台 CLI 可用，静默退出
+  // Qoder 作为 IDE 插件不需要 CLI 刷新（通过 .qoder-plugin/ 自动发现）
+  if (!hasClaudeCli) {
     process.exit(0);
   }
 
   // 2. 判断是否是全局安装
-  // npm 在全局安装时会设置 npm_config_global 或 initInstalled 等环境变量
-  // 也可通过检查安装路径是否包含 node_modules/adspecs 判断
   const installDir = path.resolve(__dirname, '..');
   const isGlobal =
     process.env.npm_config_global === 'true' ||
@@ -75,8 +80,6 @@ try {
   }
 
   // 4. 已注册 → 重新安装以刷新版本
-  // 使用异步 spawn 避免阻塞 npm install 流程
-  const pluginDir = installDir;
   const child = spawn(
     'claude',
     ['plugins', 'install', 'adspecs', '--scope', 'user'],
@@ -97,7 +100,7 @@ try {
       fs.readFileSync(path.join(installDir, 'package.json'), 'utf8')
     );
     console.log(
-      `\n🔄 adspecs@${pkg.version} — Claude Code 插件注册已自动刷新\n`
+      `\n🔄 adspecs@${pkg.version} — AI 平台插件注册已自动刷新\n`
     );
   }
 } catch {

package/src/commands/plugin.js

@@ -25,42 +25,151 @@ function checkClaudeCli() {
 }
 
 /**
- * 读取 plugin.json 获取插件名
+ * 读取 plugin.json 获取插件名（根据平台选择对应清单）
+ * @param {string} platform - 'claude' | 'qoder'
  */
-function getPluginName() {
-  const pluginJsonPath = path.join(PLUGIN_DIR, '.claude-plugin', 'plugin.json');
+function getPluginName(platform) {
+  var manifestDir = platform === 'qoder' ? '.qoder-plugin' : '.claude-plugin';
+  const pluginJsonPath = path.join(PLUGIN_DIR, manifestDir, 'plugin.json');
   if (!fs.existsSync(pluginJsonPath)) {
-    throw new Error(`未找到插件清单文件: ${pluginJsonPath}`);
+    // 回退到 .claude-plugin
+    const fallbackPath = path.join(PLUGIN_DIR, '.claude-plugin', 'plugin.json');
+    if (!fs.existsSync(fallbackPath)) {
+      throw new Error(`未找到插件清单文件: ${pluginJsonPath}`);
+    }
+    const pluginJson = JSON.parse(fs.readFileSync(fallbackPath, 'utf8'));
+    return pluginJson.name || 'adspecs';
   }
   const pluginJson = JSON.parse(fs.readFileSync(pluginJsonPath, 'utf8'));
   return pluginJson.name || 'adspecs';
 }
 
+/**
+ * 检测当前可用的 AI 平台
+ * @returns {'claude'|'qoder'}
+ */
+function detectInstalledPlatform() {
+  // 显式环境变量优先
+  var explicit = (process.env.ADSPECS_PLATFORM || '').toLowerCase();
+  if (explicit === 'qoder' || explicit === 'claude') {
+    return explicit;
+  }
+  // 检测 claude CLI
+  if (checkClaudeCli()) {
+    return 'claude';
+  }
+  // 默认回退 qoder（当前运行环境）
+  return 'qoder';
+}
+
 /**
  * 安装（注册）插件到 Claude Code
  *
- * Claude Code 的 marketplace 命令期望路径指向包含 `.claude-plugin/marketplace.json`
- * 的目录，因此传入 PLUGIN_DIR（而非 PLUGIN_DIR/.claude-plugin）。
- *
  * @param {object} options
  * @param {string} options.scope - 安装范围: user|project
+ * @param {string} options.platform - 目标平台: claude|qoder（可选，自动检测）
  */
 exports.install = async function install(options) {
   const scope = options.scope || 'user';
-  const pluginName = getPluginName();
-
-  // marketplace.json 必须存在，否则无法注册
-  const marketplaceJson = path.join(PLUGIN_DIR, '.claude-plugin', 'marketplace.json');
-  if (!fs.existsSync(marketplaceJson)) {
-    throw new Error(`未找到 marketplace 清单: ${marketplaceJson}`);
-  }
+  const platform = options.platform || detectInstalledPlatform();
+  const pluginName = getPluginName(platform);
 
   console.log(chalk.cyan('🔌 adspecs 插件注册'));
   console.log('');
   console.log(`   插件目录:  ${PLUGIN_DIR}`);
   console.log(`   插件名称:  ${pluginName}`);
   console.log(`   安装范围:  ${scope}`);
+  console.log(`   目标平台:  ${platform}`);
+  console.log('');
+
+  if (platform === 'qoder') {
+    await installForQoder(pluginName, scope);
+  } else {
+    await installForClaude(pluginName, scope);
+  }
+};
+
+/**
+ * Qoder 平台安装
+ * Qoder 通过 .qoder-plugin/plugin.json 自动发现插件，
+ * 安装即确保插件目录可被 Qoder 访问。
+ */
+async function installForQoder(pluginName, scope) {
+  const qoderManifest = path.join(PLUGIN_DIR, '.qoder-plugin', 'plugin.json');
+  if (!fs.existsSync(qoderManifest)) {
+    throw new Error(`未找到 Qoder 插件清单: ${qoderManifest}`);
+  }
+
+  if (scope === 'project') {
+    // 项目级：在当前项目创建 .qoder-plugin 符号链接或复制
+    const targetDir = path.join(process.cwd(), '.qoder-plugin');
+    if (fs.existsSync(targetDir)) {
+      console.log(chalk.yellow('   ⏭ 当前项目已存在 .qoder-plugin/，跳过'));
+    } else {
+      try {
+        // 尝试创建符号链接（节省空间）
+        fs.symlinkSync(
+          path.join(PLUGIN_DIR, '.qoder-plugin'),
+          targetDir,
+          'junction' // Windows 使用 junction
+        );
+        console.log(chalk.green('   ✅ 已创建 .qoder-plugin 符号链接'));
+      } catch (_err) {
+        // 符号链接失败，复制清单文件
+        fs.mkdirSync(targetDir, { recursive: true });
+        fs.copyFileSync(qoderManifest, path.join(targetDir, 'plugin.json'));
+        console.log(chalk.green('   ✅ 已复制 .qoder-plugin/plugin.json 到项目'));
+      }
+    }
+
+    // 确保 skills 可被访问
+    const targetSkills = path.join(process.cwd(), 'skills');
+    if (!fs.existsSync(targetSkills)) {
+      try {
+        fs.symlinkSync(path.join(PLUGIN_DIR, 'skills'), targetSkills, 'junction');
+        console.log(chalk.green('   ✅ 已创建 skills/ 符号链接'));
+      } catch (_err) {
+        console.log(chalk.yellow('   ⚠ skills/ 链接创建失败，请手动确保 Qoder 可访问插件 skills 目录'));
+      }
+    }
+
+    // 确保 hooks 可被访问
+    const targetHooks = path.join(process.cwd(), 'hooks');
+    if (!fs.existsSync(targetHooks)) {
+      try {
+        fs.symlinkSync(path.join(PLUGIN_DIR, 'hooks'), targetHooks, 'junction');
+        console.log(chalk.green('   ✅ 已创建 hooks/ 符号链接'));
+      } catch (_err) {
+        console.log(chalk.yellow('   ⚠ hooks/ 链接创建失败，请手动确保 Qoder 可访问插件 hooks 目录'));
+      }
+    }
+  } else {
+    // 用户级：输出指引
+    console.log(chalk.gray('   → Qoder 用户级插件安装...'));
+    console.log('');
+    console.log(chalk.green('   ✅ Qoder 插件清单已就绪: ' + qoderManifest));
+    console.log('');
+    console.log('   Qoder 用户级安装方式：');
+    console.log('   1. 将本插件目录路径添加到 Qoder 插件搜索路径');
+    console.log('   2. 或在 Qoder 设置中配置插件目录指向: ' + PLUGIN_DIR);
+    console.log('   3. 重启 Qoder 使插件生效');
+  }
+
+  console.log('');
+  console.log(chalk.green.bold(`✅ adspecs 插件已配置到 Qoder (scope=${scope})`));
   console.log('');
+  printSkillList();
+}
+
+/**
+ * Claude Code 平台安装（原有逻辑）
+ */
+async function installForClaude(pluginName, scope) {
+  // marketplace.json 必须存在，否则无法注册
+  const marketplaceJson = path.join(PLUGIN_DIR, '.claude-plugin', 'marketplace.json');
+  if (!fs.existsSync(marketplaceJson)) {
+    throw new Error(`未找到 marketplace 清单: ${marketplaceJson}`);
+  }
 
   // 1. 检查 claude CLI
   if (!checkClaudeCli()) {
@@ -74,7 +183,6 @@ exports.install = async function install(options) {
   }
 
   // 2. 注册 marketplace
-  //    注意：传入 PLUGIN_DIR，claude 会去找 <PLUGIN_DIR>/.claude-plugin/marketplace.json
   console.log(chalk.gray('   → 注册 marketplace...'));
   let marketplaceRegistered = false;
   try {
@@ -90,15 +198,13 @@ exports.install = async function install(options) {
     const combined = stderr + stdout;
     if (combined.includes('already exists') || combined.includes('already registered')) {
       console.log(chalk.yellow('   ⏭ marketplace 已存在，跳过'));
-      marketplaceRegistered = true; // 已存在也视为可用
+      marketplaceRegistered = true;
     } else {
-      // 把真实错误输出，方便排查，不再静默吞掉
       console.log(chalk.red(`   ❌ marketplace 注册失败: ${combined.trim() || err.message}`));
     }
   }
 
   // 3. 安装插件
-  //    只有 marketplace 注册成功（或已存在）时，才能按名称安装
   console.log(chalk.gray('   → 安装插件...'));
   if (!marketplaceRegistered) {
     throw new Error('marketplace 未注册成功，无法按名称安装插件，请检查上方错误');
@@ -122,28 +228,62 @@ exports.install = async function install(options) {
   console.log('');
   console.log(chalk.green.bold(`✅ adspecs 插件已注册到 Claude Code (scope=${scope})`));
   console.log('');
-  console.log('   现在可以在 Claude Code 中使用以下技能：');
+  printSkillList();
+}
+
+/**
+ * 打印可用技能列表
+ */
+function printSkillList() {
+  console.log('   现在可以使用以下技能：');
   console.log('   /adspecs-prd          — 生成 PRD');
   console.log('   /adspecs-plan         — 后端系统设计');
   console.log('   /adspecs-tasks        — TDD 任务清单');
   console.log('   /adspecs-utest        — 生成单元测试');
-  console.log('   ...（共 19 个技能）');
+  console.log('   ...（共 30 个技能）');
   console.log('');
-};
+}
 
 /**
  * 卸载插件
  *
  * @param {object} options
  * @param {string} options.scope - 卸载范围: user|project
+ * @param {string} options.platform - 目标平台: claude|qoder（可选，自动检测）
  */
 exports.uninstall = async function uninstall(options) {
   const scope = options.scope || 'user';
-  const pluginName = getPluginName();
+  const platform = options.platform || detectInstalledPlatform();
+  const pluginName = getPluginName(platform);
 
   console.log(chalk.cyan('🔌 adspecs 插件卸载'));
   console.log('');
+  console.log(`   目标平台:  ${platform}`);
+  console.log('');
+
+  if (platform === 'qoder') {
+    // Qoder 卸载：移除项目级链接
+    if (scope === 'project') {
+      const targetDir = path.join(process.cwd(), '.qoder-plugin');
+      if (fs.existsSync(targetDir)) {
+        try {
+          fs.rmSync(targetDir, { recursive: true, force: true });
+          console.log(chalk.green('   ✅ 已移除项目 .qoder-plugin/'));
+        } catch (err) {
+          throw new Error(`移除失败: ${err.message}`);
+        }
+      } else {
+        console.log(chalk.yellow('   ⏭ 项目未安装 .qoder-plugin/，无需卸载'));
+      }
+    } else {
+      console.log(chalk.yellow('   用户级卸载请从 Qoder 插件设置中移除本插件路径'));
+    }
+    console.log('');
+    console.log(chalk.green(`✅ ${pluginName} 已从 Qoder 卸载 (scope=${scope})`));
+    return;
+  }
 
+  // Claude Code 卸载
   if (!checkClaudeCli()) {
     console.error(chalk.red('❌ 未检测到 claude CLI'));
     process.exit(1);