Skip to content

feat: 添加 ZCode 支持 #120

Description

@DearTang

已经让ai按zcode的目录结构进行适配了,操作步骤如下:

superpowers-zh 添加 ZCode 支持

修改文件位置

%LOCALAPPDATA%\npm-cache\_npx\<hash>\node_modules\superpowers-zh\bin\superpowers-zh.js

实际路径示例:

C:\Users\argus\AppData\Local\npm-cache\_npx\b45846acb10a9395\node_modules\superpowers-zh\bin\superpowers-zh.js

⚠️ 这是 npx 缓存,npx 更新时会被覆盖。永久生效需提 PR。


修改 1: TARGETS 数组(约第76行)

找到 { name: 'Qwen Code', ...} 那行,在其后添加:

{ name: 'ZCode',         dir: '.zcode/skills',            detect: '.zcode',                          global: { dir: '.zcode/skills',          detect: '.zcode' } },

修改 2: TOOL_ALIASES(约第691行)

找到 'qwen-code': 'Qwen Code', 那行,在其后添加:

'zcode':        'ZCode',

修改 3: 添加 generateZcodeBootstrap 函数

generateCodeBuddyBootstrap 函数之后、CLI_PROBES 之前添加:

// ZCode:项目级 bootstrap 放 .zcode/AGENTS.md(类似 Claude Code 的 CLAUDE.md),
// skills 放 .zcode/skills/。全局装到 ~/.zcode/skills/。
function generateZcodeBootstrap(baseDir, isGlobal) {
  const skillEntries = scanSkillEntries(SKILLS_SRC);
  const skillList = skillEntries.map(s => `- **${s.name}**: ${s.desc}`).join('\n');
  const scope = isGlobal ? '已全局安装 superpowers-zh 技能框架,所有项目共享' : '本项目已安装 superpowers-zh 技能框架';
  const skillsRef = isGlobal ? '~/.zcode/skills/' : '.zcode/skills/';

  const content = `# Superpowers-ZH 中文增强版

${scope}${skillEntries.length} 个 skills)。

## 核心规则

1. **收到任务时,先检查是否有匹配的 skill** — 哪怕只有 1% 的可能性也要检查
2. **设计先于编码** — 收到功能需求时,先用 brainstorming skill 做需求分析
3. **测试先于实现** — 写代码前先写测试(TDD)
4. **验证先于完成** — 声称完成前必须运行验证命令

## 可用 Skills

Skills 位于 \`${skillsRef}\` 目录,每个 skill 有独立的 \`SKILL.md\` 文件。

${skillList}

## 如何使用

当任务匹配某个 skill 时,使用 \`$skill-name\` 或 \`/skill-name\` 加载对应 skill 并严格遵循其流程。
`;

  // 项目级写入 .zcode/AGENTS.md;全局写入 ~/.zcode/AGENTS.md
  const mdPath = isGlobal ? resolve(baseDir, '.zcode', 'AGENTS.md') : resolve(baseDir, '.zcode', 'AGENTS.md');
  mkdirSync(dirname(mdPath), { recursive: true });
  if (existsSync(mdPath)) {
    const existing = readFileSync(mdPath, 'utf8');
    if (!existing.includes('superpowers-zh')) {
      writeFileSync(mdPath, existing.replace(/\s+$/, '') + '\n\n' + wrapWithSentinel(content), 'utf8');
      console.log(`  ✅ ZCode: 追加 skills 引用 -> ${mdPath}`);
    } else {
      console.log(`  ✅ ZCode: AGENTS.md 已包含 superpowers-zh 引用`);
    }
  } else {
    writeFileSync(mdPath, wrapWithSentinel(content), 'utf8');
    console.log(`  ✅ ZCode: bootstrap -> ${mdPath}`);
  }
}

修改 4: installForTarget 函数

if (target.name === 'Kilo Code') { ... } 块之后添加:

if (target.name === 'ZCode') {
  generateZcodeBootstrap(baseDir, isGlobal);
}

测试

npx superpowers-zh --tool zcode

预期输出:

superpowers-zh v1.7.9 — AI 编程超能力中文版

源: 20 个 skills
模式: 项目级
目标: F:\workProject\personProject\zcode-assistant

✅ ZCode [项目]: 20 个 skills -> F:\workProject\personProject\zcode-assistant\.zcode\skills
✅ ZCode: bootstrap -> F:\workProject\personProject\zcode-assistant\.zcode\AGENTS.md

安装完成!重启你的 AI 编程工具即可生效。

安装后的目录结构

.zcode/
├── skills/
│   ├── brainstorming/
│   │   └── SKILL.md
│   ├── tdd-workflow/
│   │   └── SKILL.md
│   └── ... (20 个 skill)
└── AGENTS.md  (bootstrap 文件)

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions