superpowers-zh: Instructions file for Gemini CLI

GEMINI.md

superpowers-zh GEMINI.md is an instructions file for Gemini CLI from jnMetaCode/superpowers-zh. It costs 1,234 tokens per session, scanned A, original, MIT.

A Chinese-language guide for Superpowers-ZH, a collection of workflows for AI-assisted software development. It requires checking for a matching workflow, planning before implementation, writing tests first, and verifying results.

In plain words
What is it for?
Use it when working in the Superpowers-ZH project, especially for new features, behavior changes, testing, planning, or Chinese-language code reviews and documentation.
Why use it?
It gives agents a consistent development process and helps catch missing requirements or broken changes early.

Instructions file for Gemini CLI

Written for Gemini CLI: the file is GEMINI.md. Also seen: mentions subagents; mentions Claude Code; built for openclaw.

This is jnMetaCode/superpowers-zh's own configuration. It tells Gemini CLI how to work on superpowers-zh itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything superpowers-zh configures →

About the project

superpowers-zh is a Chinese community edition of superpowers, a collection of practical skills and development methods for AI coding tools. It helps users apply workflows such as brainstorming, test-driven development, debugging, code review, and other programming tasks across supported coding agents. The catalogue add-ons are the project's translated and original skills, instructions, hook, and plugin components.

jnMetaCode/superpowers-zh · 8,390 stars · on GitHub · sp.aiolaola.com

Reuse

Borrowing it

Nothing to install: this file belongs to jnMetaCode/superpowers-zh. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/jnMetaCode/superpowers-zh/main/GEMINI.md
Clone the repo
git clone --depth 1 https://github.com/jnMetaCode/superpowers-zh

Made for: Gemini CLI.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for superpowers-zh GEMINI.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/jnmetacode/superpowers-zh/gemini-md/github.svg)](https://agentmods.dev/instructions/jnmetacode/superpowers-zh/gemini-md)
Your own site
<a href="https://agentmods.dev/instructions/jnmetacode/superpowers-zh/gemini-md"><img src="https://agentmods.dev/badge/instructions/jnmetacode/superpowers-zh/gemini-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for superpowers-zh GEMINI.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/jnmetacode/superpowers-zh/gemini-md"><img src="https://agentmods.dev/badge/instructions/jnmetacode/superpowers-zh/gemini-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,234 This file is loaded in full into every session.
When invoked 1,234 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.01234 $0.01234
Opus 5.5 $0.00494 $0.00494
Sonnet 5.5 $0.00247 $0.00247
Haiku 4.5 $0.00123 $0.00123

Measured 28d ago against content hash de7007e61549, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

superpowers-zh GEMINI.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 28d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

GEMINI.md · 45 lines

How it starts

The opening of the file, as written. The whole thing — 45 lines — stays where its author put it; the contents beside it link to each section on GitHub.

@./skills/using-superpowers/SKILL.md @./skills/using-superpowers/references/gemini-tools.md

Superpowers-ZH 中文增强版

本项目已安装 superpowers-zh 技能框架(21 个 skills)。

核心规则

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

可用 Skills

Skills 位于 .gemini/skills/ 目录,每个 skill 有独立的 SKILL.md 文件。

  • brainstorming: 在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。
  • chinese-code-review: 中文 review 沟通参考——话术模板、分级标注(必须修复/建议修改/仅供参考)、国内团队常见反模式应对。仅在用户显式 /chinese-code-review 时调用,不要根据上下文自动触发。
  • chinese-commit-conventions: 中文 commit 与 changelog 配置参考——Conventional Commits 中文适配、commitlint/husky/commitizen 中文模板、conventional-changelog 中文配置。仅在用户显式 /chinese-commit-conventions 时调用,不要根据上下文自动触发。
  • chinese-documentation: 中文文档排版参考——中英文空格、全半角标点、术语保留、链接格式、中文文案排版指北约定。仅在用户显式 /chinese-documentation 时调用,不要根据上下文自动触发。
  • chinese-git-workflow: 国内 Git 平台配置参考——Gitee、Coding.net、极狐 GitLab、CNB 的 SSH/HTTPS/凭据/CI 接入差异与镜像同步配置。仅在用户显式 /chinese-git-workflow 时调用,不要根据上下文自动触发。
  • diagnosing-superpowers: 当一次 superpowers 会话出了问题、你的人类伙伴想知道原因时使用——重复劳动、无视计划、磕磕绊绊、结果质量差、某个技能没触发、"太慢了"、"为什么这么贵"、"它到底在干什么"——或者想给 superpowers 维护者整理一份 bug 报告;适用于当前会话,或按 id / 路径指定的过往会话,任何工具均可
  • dispatching-parallel-agents: 当面对 2 个以上可以独立进行、无共享状态或顺序依赖的任务时使用
  • executing-plans: 当你要在当前会话里亲自担任实现者执行一份实现计划时使用——你的人类伙伴选择了内联执行,或者没有可用的子智能体工具
  • finishing-a-development-branch: 当实现完成、所有测试通过、需要决定如何集成工作时使用——通过提供合并、PR 或清理等结构化选项来引导开发工作的收尾
  • mcp-builder: MCP 服务器构建方法论 — 系统化构建生产级 MCP 工具,让 AI 助手连接外部能力
  • receiving-code-review: 收到代码审查反馈后、实施建议之前使用,尤其当反馈不明确或技术上有疑问时——需要技术严谨性和验证,而非敷衍附和或盲目执行
  • requesting-code-review: 完成任务、实现重要功能或合并前使用,用于验证工作成果是否符合要求
  • subagent-driven-development: 当在当前会话中执行包含独立任务的实现计划时使用
  • systematic-debugging: 遇到任何 bug、测试失败或异常行为时使用,在提出修复方案之前执行
  • test-driven-development: 在实现任何功能或修复 bug 时使用,在编写实现代码之前
  • using-git-worktrees: 当需要开始与当前工作区隔离的功能开发或执行实现计划之前使用——创建具有智能目录选择和安全验证的隔离 git 工作树
  • using-superpowers: 在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具
  • verification-before-completion: 在宣称工作完成、已修复或测试通过之前使用,在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功;始终用证据支撑断言
  • workflow-runner: 在 Claude Code / OpenClaw / Cursor 中直接运行 agency-orchestrator YAML 工作流——无需 API key,使用当前会话的 LLM 作为执行引擎。当用户提供 .yaml 工作流文件或要求多角色协作完成任务时触发。
  • writing-plans: 当你有规格说明或需求用于多步骤任务时使用,在动手写代码之前
  • writing-skills: 当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用

Read the full file on GitHub · 45 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 28d ago Changed · +1 lines · +129 tokens per session de7007e61549
  2. 1mo ago First seen · 44 lines · 1,105 tokens per session scan A aa496116b9d7

Subscribe to this mod's changes

superpowers-zh GEMINI.md is an instructions file published in the GitHub repository jnMetaCode/superpowers-zh (8,390 stars, last pushed yesterday), licensed MIT. It adds 1,234 tokens to every session, about $0.0049 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,786 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens