mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
fc9a2a40ca
上游同步： - hooks/session-start: 新增 Copilot CLI 平台检测（COPILOT_CLI 环境变量） - .opencode/plugins/superpowers.js: bootstrap 从 system prompt 改为 user message 注入，避免 token 膨胀和 Qwen 兼容问题 - skills/using-superpowers: 新增 Copilot CLI 使用说明和工具映射引用 - 新增 references/copilot-tools.md（中文化） 本地优化： - 清理 OpenCode 插件死代码（normalizePath/os/configDir） - 统一版本号为 1.1.6（修复插件 JSON 与 package.json 不一致） - .gitignore 排除安装器生成的 skills 副本 - package.json files 数组精简，避免打包重复的 skills 副本 - 安装器新增 copilot/copilot-cli 别名 - 工具数量更新为 15 款
44 lines
3.7 KiB
Markdown
44 lines
3.7 KiB
Markdown
@./skills/using-superpowers/SKILL.md
|
||
@./skills/using-superpowers/references/gemini-tools.md
|
||
|
||
|
||
# Superpowers-ZH 中文增强版
|
||
|
||
本项目已安装 superpowers-zh 技能框架（20 个 skills）。
|
||
|
||
## 核心规则
|
||
|
||
1. **收到任务时，先检查是否有匹配的 skill** — 哪怕只有 1% 的可能性也要检查
|
||
2. **设计先于编码** — 收到功能需求时，先用 brainstorming skill 做需求分析
|
||
3. **测试先于实现** — 写代码前先写测试（TDD）
|
||
4. **验证先于完成** — 声称完成前必须运行验证命令
|
||
|
||
## 可用 Skills
|
||
|
||
Skills 位于 `.gemini/skills/` 目录，每个 skill 有独立的 `SKILL.md` 文件。
|
||
|
||
- **brainstorming**: 在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。
|
||
- **chinese-code-review**: 中文代码审查规范——在保持专业严谨的同时，用符合国内团队文化的方式给出有效反馈
|
||
- **chinese-commit-conventions**: 中文 Git 提交规范 — 适配国内团队的 commit message 规范和 changelog 自动化
|
||
- **chinese-documentation**: 中文技术文档写作规范——排版、术语、结构一步到位，告别机翻味
|
||
- **chinese-git-workflow**: 适配国内 Git 平台和团队习惯的工作流规范——Gitee、Coding、极狐 GitLab 全覆盖
|
||
- **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**: 当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用
|
||
|
||
## 如何使用
|
||
|
||
当任务匹配某个 skill 时，读取对应的 `.gemini/skills/<skill-name>/SKILL.md` 并严格遵循其流程。
|