kilo-superpowers-compose 0.1.2 → 0.1.5

package/README.md

@@ -11,7 +11,7 @@
 
 ## Status
 
-**v0.1.2.** Installed via the npm CLI and verified on both **Kilo CLI** and the
+**v0.1.5.** Installed via the npm CLI and verified on both **Kilo CLI** and the
 **VS Code Kilo Code** extension (they share the same config, so one install
 covers both).
 
@@ -24,19 +24,20 @@ covers both).
 ## What it is
 
 `kilo-superpowers-compose` bundles 14 battle-tested Superpowers skills + 3
-purpose-built agents + a `/superpowers` slash command into one npm package.
+purpose-built agents into one npm package.
 Run one install command and the skills link into `~/.kilo/skills/`, the agent
-files copy into `~/.config/kilo/agent/`, the command into
-`~/.config/kilo/commands/`, and `kilo.jsonc` gets the skill path registered.
-Restart Kilo and a `compose` agent appears in the agent picker, ready to run
-the full, disciplined Superpowers workflow on any coding task.
+files copy into `~/.config/kilo/agent/`, and `kilo.jsonc` gets the skill path
+registered. Restart Kilo and a `compose` agent appears in the agent picker.
+Pick `compose` and the full, disciplined Superpowers workflow runs on any
+coding task — no extra slash command required (this matches the mimo-compose
+convention).
 
 ## Installation
 
 > ⚠ **Two steps required.** Running only step ① (`npm install -g`) does
-> nothing visible — it only installs the CLI binary, not the agent/command
-> files, the skills link, or `kilo.jsonc`. Skipping step ② is the most
-> common mistake.
+> nothing visible — it only installs the CLI binary, not the agent files,
+> the skills link, or `kilo.jsonc`. Skipping step ② is the most common
+> mistake.
 
 **Step ① — Install the CLI**:
 
@@ -53,17 +54,16 @@ itself); does not touch your config directory.
 kilo-superpowers-compose install
 ```
 
-Copies the 3 agent files to `~/.config/kilo/agent/`, the command to
-`~/.config/kilo/commands/`, creates the skills link at
-`~/.kilo/skills/superpowers`, and adds an entry to `kilo.jsonc`'s
+Copies the 3 agent files to `~/.config/kilo/agent/`, creates the skills
+link at `~/.kilo/skills/superpowers`, and adds an entry to `kilo.jsonc`'s
 `skills.paths`. **Idempotent**: safe to re-run.
 
 **Step ③ — Restart Kilo** (fully quit and reopen the CLI; **Reload Window**
 in VS Code).
 
-After this, `compose` appears in `/agents` and `/superpowers` works. One
-install covers both Kilo CLI and the VS Code Kilo Code extension (they
-share `~/.config/kilo/`).
+After this, `compose` appears in the agent picker — pick it to enter the
+Superpowers workflow. One install covers both Kilo CLI and the VS Code
+Kilo Code extension (they share `~/.config/kilo/`).
 
 ### Kilo Marketplace (official channel — coming soon)
 
@@ -84,14 +84,24 @@ Until then, use the npm install above.
   `writing-skills`.
 - **3 agents**: `compose` (primary orchestrator), `compose-dev` (TDD
   implementer subagent), `compose-review` (two-stage reviewer subagent). None
-  pin a `model` — they use your global default model.
-- **1 slash command**: `/superpowers` (routes to `compose`).
+  pin a `model` — they use your global default model. Pick `compose` in the
+  agent picker to enter the Superpowers workflow.
+
+> v0.1.x 早期版本同时注册了 `/superpowers` 斜杠命令；自 v0.1.3 起移除以与
+> mimo-compose 保持一致——选 `compose` 代理即可触发完整工作流，不再占用命令面板。
+> **从老版本升级到 v0.1.3+：** 若你的 `~/.config/kilo/commands/superpowers.md`
+> 仍是 v0.1.2 之前留下的副本，运行 `kilo-superpowers-compose uninstall`（再 install
+> 也可）会顺手清掉它。如果还想自己手动清：
+>
+> ```powershell
+> Remove-Item -Force "$env:USERPROFILE\.config\kilo\commands\superpowers.md"
+> ```
 
 ## Update & uninstall
 
 > **Update is also two steps.** `npm update -g` upgrades the package
 > itself; the `update` subcommand re-syncs the artifacts to Kilo's config.
-> Running only step ① won't update your agents/commands/skills link.
+> Running only step ① won't update your agents / skills link.
 
 **Update** (two steps, after a new version is published):
 
@@ -112,21 +122,20 @@ kilo-superpowers-compose uninstall       # remove artifacts
 npm uninstall -g kilo-superpowers-compose  # remove the CLI itself
 ```
 
-Uninstall removes: the skills link, the 3 agent files, the
-`superpowers.md` command, this package's `skills.paths` entry in
-`kilo.jsonc`, and the install manifest. Your own skills, agents, and config
-are left untouched.
+Uninstall removes: the skills link, the 3 agent files, this package's
+`skills.paths` entry in `kilo.jsonc`, and the install manifest. Your own
+skills, agents, and config are left untouched.
 
 ## Common mistakes
 
-**"I ran `npm install -g` but `/agents` doesn't show `compose`."**
-— You only ran step ①. The CLI is installed, but no agent files, skills
-link, or command were created. Run `kilo-superpowers-compose install`.
+**"I ran `npm install -g` but the agent picker doesn't show `compose`."**
+— You only ran step ①. The CLI is installed, but no agent files or skills
+link were created. Run `kilo-superpowers-compose install`.
 
 **"I changed package code after install; restarting Kilo doesn't pick it up."**
 — `~/.kilo/skills/superpowers` is a junction pointing to the package
 directory, so package upgrades are picked up automatically. But
-agent/command files were copied at install time and don't auto-update. Run
+agent files were copied at install time and don't auto-update. Run
 `kilo-superpowers-compose update`.
 
 **"I added `plugin: ['kilo-superpowers-compose']` to `kilo.jsonc`."**
@@ -139,7 +148,7 @@ This package installs via the npm CLI — no `plugin` field needed.
 kilo-superpowers-compose <command>
 
 Commands:
-  install     Install skills, agents, and the slash command (default)
+  install     Install skills and agents (default)
   uninstall   Remove everything this package installed (manifest-based)
   update      Re-run install (idempotent)
 

package/bin/cli.js

@@ -32,7 +32,7 @@ if (cmd === '--help' || cmd === '-h') {
       '  kilo-superpowers-compose <command>',
       '',
       '命令:',
-      '  install     安装技能、代理与斜杠命令（默认）',
+      '  install     安装技能与代理（默认）',
       '  uninstall   移除本包安装的全部内容（清单法，不触碰用户自有文件）',
       '  update      重新运行安装（幂等）',
       '',

package/bin/lib.js

@@ -52,7 +52,6 @@ export function resolvePaths(home) {
     configDir,
     configFile: path.join(configDir, 'kilo.jsonc'),
     agentsDir: path.join(configDir, 'agent'),
-    commandsDir: path.join(configDir, 'commands'),
     skillsDir,
     skillLink: path.join(skillsDir, 'superpowers'),
     manifestFile: path.join(configDir, MANIFEST_NAME),
@@ -237,7 +236,6 @@ export function runInstall(opts = {}) {
 
   const srcSkills = path.join(root, 'skills');
   const srcAgents = path.join(root, 'agents');
-  const srcCommands = path.join(root, 'commands');
 
   let pkg;
   try {
@@ -252,7 +250,7 @@ export function runInstall(opts = {}) {
   log('config dir', ctx.configDir);
 
   // 1. 确保目标目录
-  for (const d of [ctx.configDir, ctx.agentsDir, ctx.commandsDir, ctx.skillsDir]) {
+  for (const d of [ctx.configDir, ctx.agentsDir, ctx.skillsDir]) {
     try {
       ensureDir(d, { dryRun, log });
     } catch (e) {
@@ -261,6 +259,16 @@ export function runInstall(opts = {}) {
     }
   }
 
+  // 1.5 兜底清理：v0.1.3 之前的版本曾向 ~/.config/kilo/commands/superpowers.md
+  //     写入 /superpowers 斜杠命令副本（已随 v0.1.3 停止分发）。老用户机器上若
+  //     残留该文件，install / update 路径上都主动删掉它，消除 Kilo 命令面板里的
+  //     幽灵条目。该清理与 uninstall 路径共用的 safeRemove 幂等安全。
+  const legacyCmdInInstall = path.join(ctx.configDir, 'commands', 'superpowers.md');
+  let legacyRemovedOnInstall = false;
+  if (linkExists(legacyCmdInInstall)) {
+    legacyRemovedOnInstall = safeRemove(legacyCmdInInstall, { dryRun, log });
+  }
+
   // 2. 备份 kilo.jsonc
   const bak = backupConfig(ctx.configFile, { dryRun, log });
 
@@ -310,25 +318,7 @@ export function runInstall(opts = {}) {
     installedAgentPaths.push(dst);
   }
 
-  // 6. 复制 commands
-  const cmdFiles = listMdFiles(srcCommands);
-  const installedCommandPaths = [];
-  for (const f of cmdFiles) {
-    const dst = path.join(ctx.commandsDir, f.name);
-    log('copy command', f.abs, '->', dst);
-    if (!dryRun) {
-      try {
-        fs.mkdirSync(ctx.commandsDir, { recursive: true });
-        fs.copyFileSync(f.abs, dst);
-      } catch (e) {
-        console.error(`✗ 复制 command 失败 ${f.name}: ${e.message}`);
-        return EXIT.NOT_WRITABLE;
-      }
-    }
-    installedCommandPaths.push(dst);
-  }
-
-  // 7. 追加 skills.paths（config 已在第 3 步解析校验通过）
+  // 6. 追加 skills.paths（config 已在第 3 步解析校验通过）
   config.skills = config.skills || {};
   config.skills.paths = config.skills.paths || [];
   let added = false;
@@ -351,7 +341,6 @@ export function runInstall(opts = {}) {
       skillsLinkType: linkRes.type,
       skillsPathsEntry: srcSkills,
       agents: installedAgentPaths,
-      commands: installedCommandPaths,
     },
     { dryRun, log }
   );
@@ -364,8 +353,10 @@ export function runInstall(opts = {}) {
     console.log(`  注意: 链接创建失败，已回退为递归复制（${linkRes.fallback}）`);
   }
   console.log(`  代理: ${agentFiles.map((f) => f.name).join(', ') || '(无)'}`);
-  console.log(`  命令: /${cmdFiles.map((f) => f.name.replace(/\.md$/, '')).join(', /') || '(无)'}`);
   console.log(`  kilo.jsonc: skills.paths ${added ? '已新增条目' : '已存在（幂等跳过）'}`);
+  if (legacyRemovedOnInstall) {
+    console.log(`  遗留命令: 已移除 ~/.config/kilo/commands/superpowers.md（来自 v0.1.3 之前版本）`);
+  }
   console.log('');
   console.log('  请重启 Kilo CLI / VS Code 扩展以加载。');
   console.log('');
@@ -408,21 +399,20 @@ export function runUninstall(opts = {}) {
   }
   for (const p of agentPaths) safeRemove(p, { dryRun, log });
 
-  // 2. 移除 commands
-  const cmdPaths = (manifest && manifest.commands) || [];
-  if (cmdPaths.length === 0) {
-    for (const n of ['superpowers.md']) {
-      cmdPaths.push(path.join(ctx.commandsDir, n));
-    }
+  // 1b. 兜底清理：从 v0.1.3 之前的版本残留的 /superpowers 斜杠命令副本。
+  // 新安装已不再分发该命令；但老用户机器上可能还留有旧文件，主动清掉防止幽灵命令。
+  const legacyCmd = path.join(ctx.configDir, 'commands', 'superpowers.md');
+  let legacyRemoved = false;
+  if (linkExists(legacyCmd)) {
+    legacyRemoved = safeRemove(legacyCmd, { dryRun, log });
   }
-  for (const p of cmdPaths) safeRemove(p, { dryRun, log });
 
-  // 3. 移除技能链接（清单有记录类型则用之，否则按链接处理）
+  // 2. 移除技能链接（清单有记录类型则用之，否则按链接处理）
   if (linkExists(ctx.skillLink)) {
     safeRemove(ctx.skillLink, { dryRun, log });
   }
 
-  // 4. 从 kilo.jsonc 移除本包的 skills.paths 条目
+  // 3. 从 kilo.jsonc 移除本包的 skills.paths 条目
   const config = readJsonc(ctx.configFile);
   if (config.__parseError) {
     if (bak && !dryRun) {
@@ -459,9 +449,11 @@ export function runUninstall(opts = {}) {
 
   console.log('✓ kilo-superpowers-compose 已卸载');
   console.log(`  agents: ${agentPaths.length} 个文件`);
-  console.log(`  commands: ${cmdPaths.length} 个文件`);
   console.log(`  技能链接: ${ctx.skillLink}`);
   console.log(`  kilo.jsonc: skills.paths 移除 ${removedEntries} 条`);
+  if (legacyRemoved) {
+    console.log(`  遗留命令: 已移除 ~/.config/kilo/commands/superpowers.md（来自 v0.1.3 之前版本）`);
+  }
   console.log('  未触碰用户自有的技能 / 代理 / 配置。');
   return EXIT.OK;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kilo-superpowers-compose",
-  "version": "0.1.2",
-  "description": "将 obra/superpowers 工作流打包为 Kilo 插件：一个 compose 编排器代理、/superpowers 斜杠命令与 14 个技能，一条命令安装。",
+  "version": "0.1.5",
+  "description": "将 obra/superpowers 工作流打包为 Kilo 插件：一个 compose 编排器代理、3 个子代理与 14 个技能，通过 compose 代理选择器直接进入完整工作流，一条命令安装。",
   "keywords": [
     "kilo",
     "kilo-code",
@@ -46,7 +46,6 @@
     "bin",
     "skills",
     "agents",
-    "commands",
     "plugin",
     "NOTICE"
   ],

package/plugin/index.js

@@ -5,25 +5,23 @@
 // 在 kilo.jsonc 里写 `"plugin": ["kilo-superpowers-compose"]`，Kilo 启动时
 // 会加载本模块的默认导出（工厂函数），调用其 `config(config)` 钩子，向**运行时**
 // 配置对象直接注入 3 个 agent 与 skills.paths —— agent 从不落盘，仅存活于运行时。
+// 用户通过在代理选择器中选取 `compose` 代理即可进入工作流，无需注册斜杠命令。
 //
 // 设计参考：moyu-by/opencode-mimo-compose 的 src/index.js（OpenCode 插件机制）。
 // Kilo 是 OpenCode 的 fork，复用同样的 `config` 钩子契约。
 //
 // 硬性约束（与 bin/lib.js 一致）：
-// - 零第三方依赖；仅用 node:fs / node:path / node:os / node:url。
+// - 零第三方依赖；仅用 node:fs / node:path / node:url。
 // - 绝不抛异常：**插件崩溃会让 Kilo 启动失败**。所有 fs / 解析操作均包 try/catch。
-// - 跨平台路径一律用 path.join，绝不手拼反斜杠；尊重 KILO_HOME。
+// - 跨平台路径一律用 path.join，绝不手拼反斜杠。
 // - skills.paths 幂等判定用规范化路径比较（path.resolve + toLowerCase）。
 //
 // 自动更新原理：
 // - agents：每次 Kilo 启动由 config 钩子重注（永远取包内最新内容）。
 // - skills：config.skills.paths 指向**包内** skills 目录，`npm update -g` 后即时刷新。
-// - /superpowers 命令：无法经 config 钩子注册（Kilo 无对应钩子），故采用
-//   "复制到 ~/.config/kilo/commands/ + 版本标记" 的方式；包升级时标记比对触发重同步。
 
 import fs from 'node:fs';
 import path from 'node:path';
-import os from 'node:os';
 import { fileURLToPath } from 'node:url';
 
 // ─── 路径常量 ──────────────────────────────────────────────────────────
@@ -33,32 +31,6 @@ const PKG_ROOT = path.resolve(__dirname, '..');
 
 const AGENTS_SRC = path.join(PKG_ROOT, 'agents');
 const SKILLS_SRC = path.join(PKG_ROOT, 'skills');
-const COMMANDS_SRC = path.join(PKG_ROOT, 'commands');
-
-// Kilo 配置目录（尊重 KILO_HOME，便于测试与隔离配置）。
-// 惰性求值 —— 读取在调用时进行（而非模块加载时），使测试可用临时 KILO_HOME 隔离，
-// 不触碰用户真实配置目录。
-function defaultConfigDir() {
-  const home = (process.env.KILO_HOME || os.homedir()) + '';
-  return path.join(home, '.config', 'kilo');
-}
-function defaultMarkerFile() {
-  return path.join(defaultConfigDir(), '.kilo-superpowers-compose-plugin');
-}
-function defaultCommandsDstDir() {
-  return path.join(defaultConfigDir(), 'commands');
-}
-
-// 包版本（仅用于版本标记比对；读失败回退为占位串）。
-const PKG_VERSION = readPkgVersion(PKG_ROOT);
-
-function readPkgVersion(root) {
-  try {
-    return JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).version || '0.0.0';
-  } catch (_) {
-    return '0.0.0';
-  }
-}
 
 // ─── 纯函数 / 路径规范化 ───────────────────────────────────────────────
 // 与 bin/lib.js 的 normalizePath 行为一致，便于 skills.paths 去重判定。
@@ -159,48 +131,14 @@ export function loadAgents(agentsSrc) {
   return agents;
 }
 
-// ─── 版本标记：同步复制的命令 ──────────────────────────────────────────
-// agents / skills 每次启动自动重注 / 自动刷新；只有复制的 /superpowers 命令
-// 需要版本标记触发重同步。
-export function needsSetup(markerFile) {
-  const f = markerFile || defaultMarkerFile();
-  try {
-    if (!fs.existsSync(f)) return true;
-    return fs.readFileSync(f, 'utf8').trim() !== PKG_VERSION;
-  } catch (_) {
-    return true;
-  }
-}
-
-// 执行命令同步：把 commands/superpowers.md 复制到 ~/.config/kilo/commands/，并写标记。
-export function runSetup(opts = {}) {
-  const commandsDst = opts.commandsDstDir || defaultCommandsDstDir();
-  const mf = opts.markerFile || defaultMarkerFile();
-  try {
-    const srcCmd = path.join(opts.commandsSrc || COMMANDS_SRC, 'superpowers.md');
-    if (fs.existsSync(srcCmd)) {
-      try {
-        fs.mkdirSync(commandsDst, { recursive: true });
-        fs.copyFileSync(srcCmd, path.join(commandsDst, 'superpowers.md'));
-      } catch (_) {
-        // 命令复制失败不应阻断 agent / skills 注入 —— 仅记录为无命令。
-      }
-    }
-    try {
-      fs.mkdirSync(path.dirname(mf), { recursive: true });
-      fs.writeFileSync(mf, PKG_VERSION, 'utf8');
-    } catch (_) {
-      // 标记写失败：下次启动会重试，无致命影响。
-    }
-  } catch (_) {
-    // 整体防御：runSetup 任何异常都不外泄。
-  }
-}
-
 // ─── 插件工厂（Kilo 加载入口，当前休眠）──────────────────────────────
 // 设计目标：Kilo 按 PluginModule 契约（{ server: Plugin }，见 @kilocode/plugin）
 // import 本模块、调用 server() 工厂、再调用返回的 config() 钩子，向运行时配置
-// 注入 agents/skills/command。
+// 注入 agents/skills。
+//
+// 用户使用方式：在代理选择器中选取 `compose` 代理即可进入 Superpowers 工作流，
+// 流程由 compose 编排器（agents/compose.md）驱动：brainstorming → planning →
+// dispatch compose-dev → dispatch compose-review。
 //
 // 实测结论（2026-07，见 docs/DESIGN.md §10 Q5）：当前 Kilo **不会**经
 // `kilo.jsonc` 的 `plugin:["包名"]` 字段加载 npm 命名插件（该字段无效，还会拖慢
@@ -208,11 +146,6 @@ export function runSetup(opts = {}) {
 // 但作为用户安装方式暂不启用 —— 安装走 npm CLI（见 bin/）。本模块保留待 Kilo
 // 正式支持插件加载后即可启用。命名兼容：同时以 server 命名导出（与 mimo 一致）。
 export async function plugin(_input, _options) {
-  // 首次安装或包升级时同步命令（失败被 runSetup 内部吞掉）。
-  try {
-    if (needsSetup()) runSetup();
-  } catch (_) {}
-
   const agents = loadAgents();
 
   return {

package/commands/superpowers.md

@@ -1,38 +0,0 @@
----
-description: |
-  Start the Superpowers workflow. Loads the using-superpowers discipline
-  rules, then hands the user's request to the compose orchestrator agent,
-  which classifies the task (simple / complex / bug) and drives the full
-  brainstorming → planning → subagent implementation → two-stage review
-  → merge pipeline.
-agent: compose
----
-
-# /superpowers
-
-You are being launched via the `/superpowers` slash command. Follow these
-steps in order:
-
-1. **Bootstrap discipline (mandatory first step).** Load the
-   `using-superpowers` skill before doing anything else. This installs the
-   core rules that govern all subsequent work in this session.
-
-2. **Hand off to the compose workflow.** Treat the user's request (the
-   text they supplied after `/superpowers`, or the most recent message if
-   none) as the task to process. Run the compose orchestrator's workflow
-   decision tree:
-   - Classify the task: **simple**, **complex**, or **bug fix**.
-   - For complex work: brainstorm → plan → get explicit user approval →
-     dispatch `compose-dev` per task → dispatch `compose-review` →
-     finish the branch.
-   - For bugs: `systematic-debugging` first, then a failing test, then
-     the simple or complex path based on fix size.
-   - For simple work: do it directly, then invoke
-     `verification-before-completion` before reporting done.
-
-3. **Never skip the gates.** Brainstorming for new features, TDD for any
-   logic, systematic debugging for bugs, and review before merge on
-   complex work are mandatory — not suggestions.
-
-Begin by loading `using-superpowers`, then emit the task classification
-checkpoint so the user can see your reasoning.