mohmaedeslam00116/shadowspowers

# Shadowspowers [English](#english) · [العربية](#arabic) ## 中文 ### 什么是 shadowspowers？ Shadowspowers 是一个单一的插件，同时赋予你的 AI 编程代理两项互补的超能力： - **流程部分**（来自 [obra/superpowers](https://github.com/obra/superpowers)，MIT 协议） — 包含 14 项技能，教导你的代理*如何*构建软件：在编写代码前进行头脑风暴，有纪律地进行规划，编写真正的红/绿 TDD，系统地调试，诚实地审查代码，分派并行的子代理，妥善完成分支，并在声称完成之前验证工作。 - **技巧部分**（来自 [pbakaus/impeccable](https://github.com/pbakaus/impeccable)，Apache-2.0 协议） — 包含 1 项设计技能和 7 个领域参考（排版、颜色、动效、空间、交互、响应式、UX writing），23 个命令（`/impeccable polish`、`/impeccable audit`、`/impeccable critique` 等），以及 27 条确定性的反模式规则，用于在 AI 生成的特征发布之前捕获这些设计缺陷。 它们共同回答了构建问题的**两个**部分： ### 包含内容 ``` shadowspowers/ ├── skills/ 15 skills │ ├── (14 from superpowers, untouched) │ │ ├── brainstorming/ HARD-GATE: design before code │ │ ├── writing-plans/ turn specs into step-by-step plans │ │ ├── test-driven-development/ red → green → refactor, no shortcuts │ │ ├── systematic-debugging/ root cause before fix │ │ ├── verification-before-completion/ evidence, not vibes │ │ ├── writing-skills/ meta: how to author more skills │ │ ├── requesting-code-review/ how to ask for review │ │ ├── receiving-code-review/ how to act on feedback │ │ ├── subagent-driven-development/ parallel work via subagents │ │ ├── dispatching-parallel-agents/ when and how to parallelize │ │ ├── executing-plans/ run a plan with discipline │ │ ├── finishing-a-development-branch/ merge / PR / cleanup │ │ ├── using-git-worktrees/ isolated workspaces │ │ └── using-superpowers/ bootstrap: how to find skills │ ├── impeccable/ design vocabulary │ │ ├── SKILL.md user-invocable as /impeccable … │ │ ├── reference/ 27 sub-command / domain references │ │ ├── agents/ 2 design agents │ │ └── scripts/ 32 design / detection scripts │ └── designing-frontend-with-shadowspowers/ ★ the bridge (new in shadowspowers) │ └── SKILL.md maps superpowers stages → /impeccable commands ├── hooks/ session-start, hooks.json, hooks-cursor.json ├── scripts/ bump-version.sh, sync-to-codex-plugin.sh ├── docs/ superpowers/, plans/, testing.md, windows/ ├── assets/ app-icon.png, superpowers-small.svg ├── .claude-plugin/ Claude Code plugin + marketplace manifests ├── .codex-plugin/ Codex plugin manifest ├── .cursor-plugin/ Cursor plugin manifest ├── .opencode/ OpenCode plugin (JS) ├── AGENTS.md ├── CLAUDE.md ├── LICENSE └── README.md ``` ### 桥梁：`designing-frontend-with-shadowspowers` 这是 **shadowspowers 中新增**的技能（在两个源仓库中都不存在）。它将 superpowers 的流程阶段映射到 impeccable 的命令中，从而使设计润色成为工程工作流的一部分，而不是事后的想法。 | Superpowers 阶段 | Impeccable 命令 | |---|---| | brainstorming | `/impeccable shape` (在编码前规划 UX) | | writing-plans | 包含设计任务：调色板、排版、动效、a11y、润色 | | subagent-driven-development | `/impeccable craft` / `distill` / `typeset` / `colorize` | | verification-before-completion | `/impeccable audit` + `/impeccable polish` | | requesting-code-review | 首先执行 `/impeccable critique`（在人工审查之前捕获设计问题） | | systematic-debugging (视觉 bug) | `/impeccable audit`（反模式是你未曾注意到的 bug） | | finishing-a-development-branch | `/impeccable harden` (i18n、溢出、错误状态) | ### 快速开始 **Claude Code** (marketplace): ``` /plugin marketplace add mohmaedeslam00116/shadowspowers-marketplace /plugin install shadowspowers@shadowspowers-marketplace ``` **Cursor**: 从 marketplace 安装插件。 **Codex**: `/plugins` → 搜索 `shadowspowers` → 安装。 **OpenCode**: 克隆并添加插件路径；参见 `.opencode/INSTALL.md`。 ### 版本 - `v0.1.0` — 初始版本：superpowers v5.1.0 + impeccable v3.5.0 + 全新的 `designing-frontend-with-shadowspowers` 桥接技能。 ## 阿拉伯语 · العربية ### 什么是 shadowspowers？ **shadowspowers** إضافة (plugin) واحدة تمنح وكيل البرمجة بالذكاء الاصطناعي قوتين متكاملتين في نفس الوقت: - **نصف العملية** (من [obra/superpowers](https://github.com/obra/superpowers)، MIT) — 14 مهارة تعلّم وكيلك *كيف* يبني البرمجيات: عصف ذهني قبل الكود، تخطيط منضبط، TDD حقيقي (أحمر → أخضر → إعادة هيكلة)، تصحيح منهجي للأخطاء، مراجعة كود صادقة، توزيع المهام على وكلاء فرعيين متوازيين، إنهاء الفروع بشكل صحيح، والتحقق من العمل قبل ادّعاء اكتماله. - **نصف الحرفة** (من [pbakaus/impeccable](https://github.com/pbakaus/impeccable)، Apache-2.0) — مهارة تصميم واحدة فيها 7 مراجع متخصصة (الطباعة، الألوان، الحركة، التوزيع المكاني، التفاعل، التصميم المتجاوب، كتابة تجربة المستخدم)، و23 أمرًا (`/impeccable polish`، `/impeccable audit`، `/impeccable critique`، …)، و27 قاعدة كشف حتمية للأنماط السيئة الشائعة في تصاميم الذكاء الاصطناعي. معاً يجيبون على **نصفي** سؤال البناء: ### Bridge: `designing-frontend-with-shadowspowers` مهارة واحدة **جديدة في shadowspowers** (غير موجودة في أي من الريبو الأصلية). تربط مراحل عملية superpowers بأوامر impeccable، فتصبح صقل التصميم جزءاً من سير عمل الهندسة — لا فكرة لاحقة. | مرحلة superpowers | أمر impeccable | |---|---| | العصف الذهني | `/impeccable shape` (خطّط لتجربة المستخدم قبل الكود) | | كتابة الخطط | أضف مهام تصميم: لوحة ألوان، طباعة، حركة، إمكانية وصول، صقل نهائي | | التطوير بالوكلاء الفرعيين | `/impeccable craft` / `distill` / `typeset` / `colorize` | | التحقق قبل الاكتمال | `/impeccable audit` + `/impeccable polish` | | طلب مراجعة الكود | `/impeccable critique` أولاً (يكتشف مشاكل التصميم قبل المراجع البشري) | | التصحيح المنهجي (أخطاء بصرية) | `/impeccable audit` (الأنماط السيئة أخطاء لم تنتبه إليها) | | إنهاء فرع التطوير | `/impeccable harden` (تعدد اللغات، تجاوز النص، حالات الخطأ) | ### 版本 - `v0.1.0` — الإصدار الأول: superpowers v5.1.0 + impeccable v3.5.0 + مهارة جسر `designing-frontend-with-shadowspowers` الجديدة. ### 鸣谢 - مهارات **superpowers** من تأليف [Jesse Vincent](https://github.com/obra) والمساهمين — رخصة MIT. - مهارة التصميم **impeccable** من تأليف [Paul Bakaus](https://github.com/pbakaus) والمساهمين — رخصة Apache-2.0. - تغليف shadowspowers، والدمج، ومهارة الجسر `designing-frontend-with-shadowspowers` من عمل [Mohamed Eslam](https://github.com/mohmaedeslam00116) — رخصة MIT. راجع `LICENSE` والريبوهات الأصلية للإسناد الكامل.

标签：AI编程助手, Cutter, SOC Prime, TDD, 代码规范, 前端设计, 开发工具, 提示词工程, 数据管道, 策略决策点, 自定义脚本, 软件工程