已经让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', 那行,在其后添加:
修改 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 文件)
已经让ai按zcode的目录结构进行适配了,操作步骤如下:
superpowers-zh 添加 ZCode 支持
修改文件位置
实际路径示例:
修改 1: TARGETS 数组(约第76行)
找到
{ name: 'Qwen Code', ...}那行,在其后添加:修改 2: TOOL_ALIASES(约第691行)
找到
'qwen-code': 'Qwen Code',那行,在其后添加:修改 3: 添加 generateZcodeBootstrap 函数
在
generateCodeBuddyBootstrap函数之后、CLI_PROBES之前添加:修改 4: installForTarget 函数
在
if (target.name === 'Kilo Code') { ... }块之后添加:测试
预期输出:
安装后的目录结构