python-architecture(Python 架构规范)
在 APM CLI 代码库中创建新模块、重构类层次、引入设计模式,或进行横跨 3 个以上文件的改动时启用。
使用场景/设计与创意
Figma、图像生成、品牌素材。适合产品、运营、设计协作。
共匹配 4,262 个资源 · 第 83 / 89 页
设计类 MCP 把设计工具与图像生成能力接入 AI 工作流:Figma MCP 让 AI 读取设计稿的图层、变量与组件结构,直接生成对齐设计稿的前端代码;图像生成类 MCP 负责配图、图标与营销素材的批量产出。
典型用法:设计师在 Figma 中标注组件 → 开发者在 Cursor 中通过 Figma MCP 拉取节点信息 → AI 生成与设计系统一致的 React / Vue 代码。评审环节可以让 AI 对照设计稿截图做还原度检查。
注意版权与授权:仅处理团队有权访问的 Figma 文件;生成图片素材时确认模型的商用条款;字体与第三方素材仍需单独授权。
在 APM CLI 代码库中创建新模块、重构类层次、引入设计模式,或进行横跨 3 个以上文件的改动时启用。
审阅 Scout UI/API 测试(含 Scout 测试迁移)在最佳实践、复用与对等性上的表现。
vcanary
LobeHub React 组件约定。在编辑 TSX UI、于 base-ui 与 @lobehub/ui 及 antd 间做选择、用 antd-style 写样式、路由、桌面变体、布局与组件状态时使用。
关于“写出能暴露 bug 而非侥幸通过”的测试准则,覆盖软件与 LLM/AI 系统。在编写或评审测试、新增 mock、判断测试该放在哪一层、让编码 agent 生成测试、排查 flaky CI、为 LLM/agent 功能设计 eval 套件,或重建脆弱的测试集时使用。不用于通用代码评审、与测试无关的库调试、超出测试范围的 CI 流水线设计,或生产可观测性。
在为 Shiny for Python (py-shiny) 应用编写或运行端到端测试时使用——在 pytest 下启动应用、定位并断言 UI 组件(输入、输出、卡片、导航集)、用 Playwright 模拟用户交互,或当你想对 Shiny 渲染的 HTML 手写 CSS 选择器、原始 Playwright 定位器或 sleep() 等待时
遵循 HashiCorp 模块设计原则与社区最佳实践,将单体式 Terraform 配置改造为可复用、易维护的模块。
使用 winapp CLI 在两种场景下端到端验证 PowerToys 行为:(A) 用模块的发布检查清单对照已安装版本;(B) PR 验证——依据 PR 描述与 diff 推导其检查清单再对照已安装版本执行(已合并/已发布的 PR,或整个 release/hotfix 集合),若 PR 尚未进入构建版本则构建并侧加载该模块。逐项通过 UIA invoke / Named Events / settings.json 编辑 / 剪贴板 / GPO / SendInput 驱动,并为每项输出带证据的结构化 PASS / FAIL / BLOCKED 结论(FAIL 需区分产品缺陷与过期/含糊的清单项)。当被要求验证模块检查清单、确认 PR、签署发布/hotfix 的 PR 或对安装/侧加载的 PowerToys 做 QA 时使用。结合通用 winapp ui 机制(references/winapp-ui-testing.md)与 PT 专属配方、分场景 playbook(references/scenarios/)以及本 skill 附带的辅助 .ps1 脚本。
端到端讲解当前分支的完整逻辑与流程,让毫无前置知识的人也能理解、审查并复现。从分支 diff 界定变更范围,追踪其触达的每一层流程(前端工具/hook/组件、Java controller/service/endpoint、Python 引擎、配置、i18n、测试),产出带 Mermaid 图(时序/流程/架构)、可点击引用的带注释文件地图、前后行为对比、涉及 UI 时的截图、「本地试跑」章节与边界情况/风险的自包含走查文档。当被要求做功能或分支走查、「解释这个分支做了什么」、设计/逻辑说明、PR 审查者上手或交接文档时使用。加 --html 可同时输出渲染的 HTML 版;--no-screens 跳过截图。
HashQL 测试策略,包括 compiletest(UI 测试)、单元测试与快照测试。在为 HashQL 代码编写测试、使用 //~ 注释、运行 --bless、调试测试失败或选择合适的测试方法时使用
vandroidx-main
在 AndroidX 支持项目中,按 API 设计合规性评审待处理工作的技能。
分析原生 Android 应用并制定测试策略——安装测试库、搭建测试基础设施,并为单元测试、UI 测试、截图测试与端到端测试创建测试装置。
Phoenix AI 可观测性平台的前端开发准则。在 app/ 目录编写、审查或修改 React 组件、TypeScript 代码、样式或 UI 功能时使用。任何前端任务都会触发——新组件、UI 变更、样式、无障碍修复、表单处理或组件重构。用户询问本项目前端约定或组件模式时也使用。设计系统规则(错误展示、布局、对话框、令牌)请改用 phoenix-design 技能。
维护 Infection 的 Docker Sandbox 镜像与 sbx 模板。当需要添加、移除或升级沙箱工具,更改 PHP 沙箱镜像,更新 Codex 沙箱遥测,重建或加载 codex-infection 沙箱,或排查 devTools/sbx 镜像与测试失败时使用
从更强模型蒸馏的后端工程判断经验——在选择技术栈、语言、数据库、队列或架构时调用;在设计服务、API、业务逻辑或 schema 时;在让系统达到生产可用(可观测性、故障处理、安全)时;或评审服务端代码、判断代码库健康度时。包含场景化技术栈取舍、逻辑设计规则、数据纪律、生产底线,以及“腐烂目录”(代码不可维护的早期征兆)。
读取计划文档,将其拆解为步骤,从 ECC 目录中设计每一步的代理链,并输出可直接粘贴的 /orchestrate 自定义提示词。只做生成——本身不会调用 /orchestrate。当用户有多步计划并想通过 orchestrate 来驱动、又不想手工编排代理链时使用。
以 openai-agents-python 维护者的身份评审一个 GitHub issue 或 PR 链接,分阶段判断该诉求是否真实存在、是否具有实际重要性、是否能用受支持的功能自行解决、范围界定是否恰当、是否有更合适的其他设计、以及是否值得投入维护者与贡献者的精力。用于评估 issue 的有效性与严重程度、决定优先处理还是关闭、判断所请求特性究竟代表未被满足的需求还是只是可发现性或用法缺口、判断 PR 是否值得推进到可合并质量、比较多个开放 PR 或替代设计、把代码质量与仓库就绪状态分开看待,以及撰写简洁的维护者评估意见。当需要回复要求关闭、补充证据或修改代码时,同时产出一条礼貌、简洁、完整、可直接复制粘贴的维护者评论。
使用 i18n 体系(i18next / react-i18next)添加、修改或审查 Langflow 前端的用户可见文案。当变更涉及新增或编辑 UI 字符串——标签、按钮、tooltip、模态框、toast、错误提示、空状态——或审查包含用户可见文案的 diff 时使用。所有用户可见字符串必须走翻译体系,且每个新 key 必须存在于全部 locale 文件中。不适用于后端字符串、日志消息或代码标识符。
构建使用原生移动设备能力的 Salesforce LWC——条码扫描、生物识别、定位、NFC、日历、通讯录、文档扫描、地理围栏、AR 空间捕捉、应用评价与支付。当用户要求 LWC 执行条码扫描、文档拍照、定位或地理围栏、生物识别提示、读写设备日历或通讯录、NFC 触碰、收款、应用评价提示或 AR 空间扫描时使用。也由“lightning/mobileCapabilities”“mobile capability”“Nimbus”“device capability”触发。移动离线/Komaci priming 审查请勿使用(改用 mobile-platform-offline-validate),挑选通用 Lightning 基础组件请勿使用(改用 design-systems-slds-apply)。
vcanary
为新 AI 供应商添加文档——使用说明、环境变量、Docker 配置与图像资源。
以 node-redis 维护者身份审阅 GitHub issue 或 pull request 链接,逐层评估其主张是否真实、是否实际重要、能否用已支持的功能解决、范围界定是否正确、是否更适合另一种设计,以及是否值得投入维护者与贡献者精力。用于评估 issue 的有效性或严重度、决定优先处理还是关闭、判断所请求的功能是未被满足的需求还是仅是可发现性/使用上的缺口、判断某 PR 是否值得打磨到可合并、比较开启的 PR 或备选设计、区分代码质量与仓库就绪度,或撰写简明的维护者评估。当应请求关闭、补充证据或代码改动时,还生成礼貌、简洁、完整、可直接粘贴的维护者评论。
核心组件库与设计系统模式。在构建 UI、使用设计令牌或处理组件库时使用。
适用于任意 React 或 React Native 前端的可移植、框架无关的架构风格。将应用组织为功能模块(页面/屏幕目录),严格区分服务端状态与 UI 状态,跨模块仅通过 barrel 导入,样式与组件同置,并制定清晰的组件晋升规则。
本 monorepo 的测试实践——在单元与端到端测试之间取舍、测试文件位置、tsconfig.test.json 的角色、如何驱动 Playwright、如何编写/适配 UI/端到端测试,以及该用哪个测试运行器(vitest 还是 jest)。当用户要求添加、编写或扩展测试、补充覆盖率、创建测试文件、在新包里搭建测试、提到 vitest/jest,或引用既有 *.test.ts 文件时,必须先调用本技能再做任何代码搜索或文件读取。同等适用于单元测试与端到端/UI 测试——后者会路由到 Playwright-MCP 优先的探索流程,与常规代码搜索工作流不同。
运用具名重构变换改进代码结构而不改变行为。当用户提到“重构这段代码”“代码坏味道”“提取方法”“替换条件”“技术债”“下移方法”“内联变量”“分解条件”或“清理这段烂代码”时使用。也在整理遗留代码、为新增功能重组代码、或判断哪种变换对应某种代码坏味道时触发。覆盖坏味道驱动重构、安全变换序列与测试保障。代码质量基础参见 clean-code;复杂度管理参见 software-design-philosophy
Docker 容器化专家,精通多阶段构建、镜像优化、Docker Compose 模式与生产容器安全。适用于 Dockerfile 优化、compose 配置与容器最佳实践。
为新功能、既有代码重构,或包、设计、架构、基础设施升级创建新的实施计划文件。
如何组织前端代码——关注点分离(UI / 逻辑 / 数据 / 类型)、文件职责、状态分层、API 服务、Schema 验证,以及 React/Next 和 Vue 的框架规范。提供结构规则,非视觉设计。
处理任何 Docker 任务时使用:编写 Dockerfile、配置 docker-compose/compose.yml、多阶段构建、docker-bake.hcl、容器安全审计、.dockerignore 优化或 CI/CD 容器测试。触发词:Dockerfile、docker-compose、container、image build、multi-stage、docker bake、compose
HyperFrames 的全部动画知识——原子运动规则、多阶段场景蓝图、场景转场、更广泛的运动设计技巧,以及七种运行时适配器(GSAP 默认,另有 Lottie、Three.js、Anime.js、CSS keyframes、Web Animations API、TypeGPU)。用于任何运动或动画任务:挑选 2-4 条规则组合,或加载场景蓝图,或查阅特定运行时 API(如 GSAP 缓动 / Lottie 播放器 / Three.js mixer)。HyperFrames 原生:单一暂停时间轴、可安全 seek、确定性输出。
为 Langflow 编写并审查 Playwright E2E 测试。当用户要求编写、修复或审查 E2E 测试、spec 文件、Playwright 测试或覆盖完整 UI 的集成测试时触发。修改 data-testid 属性、tests/utils/ 中的测试辅助函数或 fixture 配置时同样触发。
将 Stitch 设计稿转化为生产级 React + Vite 仪表盘,集成 TanStack Query、来自 DESIGN.md 的无障碍令牌,以及支持 Web3 的模式(ethers/viem)。
生产级 Docker Swarm 部署规则:compose 文件从单节点扩展到多节点 Swarm 时会发生什么。在编写或审查 stack 文件、deploy 块、overlay 网络或用 docker stack deploy 部署的任何内容时使用。涵盖 Swarm 会静默忽略的指令、固定 IP 与 bind mount 为何失效、deploy 编排块,以及 Swarm 自愈所依赖的退出码与健康检查纪律。与覆盖镜像和 compose 文件本身编写的 docker 技能互补。
编写 Dockerfile、Compose 文件与 Swarm stack 的生产级 Docker 最佳实践。在创建或编辑 Dockerfile、docker-compose / compose.yaml 或 stack 文件,或构建与优化镜像时使用。修正 Claude 常犯的几个问题:多阶段构建、层缓存顺序、exec 形式 ENTRYPOINT 以保证正确的信号与退出码、init:true、将密钥与环境变量排除在镜像外、非 root 用户与健康检查。立足生产而非默认值。
本仓库的 Codacy Cloud 工作流——在 `git push` 前本地运行 Codacy 分析器(对齐 Codacy CI 行为),并经 v3 API 拉取/聚类任意 PR 的 Codacy 问题。当用户提到 Codacy、「codacy analysis」、`codacy-analysis-cli`、「codacy issues on PR」「fix codacy CI」「codacy markdownlint findings」,或 netdata-org PR 上任何 Codacy 门禁失败时使用。附带脚本 analyze-local.sh(codacy-analysis-cli 的 docker/二进制运行器)与 pr-issues.sh(分页 v3 问题拉取 + 按工具/模式/严重级/文件分组)。令牌安全——CODACY_TOKEN 绝不进入助手可见的 stdout。按设计只读;写操作(标记误报、标记已修复)需要 GitHub issue 或分支本地 SOW。
在 orchestration cluster webapp(webapp/client/apps/orchestration-cluster-webapp/)中构建或修改页面、组件、模块、路由、数据加载、表单、API 集成或 UI 功能时使用——包括新增一列、一个筛选器或一个面板这类小改动。
在 iOS 或 Android 上构建任何 Salesforce 原生移动应用的入口。当用户说“build a Salesforce iOS app”“add Salesforce login to my Android app”“set up Mobile SDK”“add MobileSync / SmartStore offline storage”“embed an Agentforce agent in my mobile app”“add Agentforce chat to iOS/Android”,或要求以 Swift/Kotlin 创建、扩展、集成 Salesforce 移动体验(MSDK、Agentforce SDK 或两者)时触发。当构建非 Salesforce 移动应用、使用不含 Salesforce 集成的 React Native/Flutter/Ionic、咨询通用移动 UI 设计,或从事 Salesforce 周边 Web/桌面工作(LWC、Experience Cloud、仅品牌化的 Mobile Publisher)时不要使用。
把 Novu 的应用内通知收件箱集成进 Web 应用。支持 React、Next.js 与原生 JavaScript。包括 Inbox 组件(铃铛图标+通知流)、可组合组件(Bell、Notifications、InboxContent、Preferences)、headless hooks、品牌主题、自定义 render props、基于 context 的多租户、标签页、本地化与 HMAC 安全。当需要添加应用内通知中心、铃铛图标、通知流、实时通知更新,或构建个性化且带品牌的通知体验时使用。
校验并修复 OSS 首装 Docker Compose 路径。在编辑 docker-compose.yaml、docker-compose.dev.yaml、.env.example、release 镜像标签、Compose profiles、Keycloak/OpenFGA/RAG 默认值或本地一体化安装的首次启动 UI 行为时使用。
蒸馏并应用当前仓库的 Next.js Nextra 启动模板架构、已实现功能、二次开发扩展点与迁移模式。适用于理解本项目、继续二次开发、修改 docs/landing/i18n/theme/auth/UI 行为,或把这些 Next.js 16 + Nextra 4 + Tailwind CSS 4 模式复用到其他项目。
蒸馏并应用本仓库 Next.js Nextra 启动模板的架构、已实现功能、扩展点与迁移模式。适用于需要理解本项目、继续第二阶段开发、修改 docs/landing/i18n/theme/auth/UI 行为,或把 Next.js 16 + Nextra 4 + Tailwind CSS 4 这些模式复用到其他项目的场景。
RomM v2 前端的主题、设计令牌、色彩与视觉语言。在为 v2 组件写样式、挑选颜色、添加/使用 CSS 变量、处理明暗主题,或想用 hex/rgba 字面量时使用。涵盖令牌流水线(src/v2/tokens/index.ts → build:tokens → tokens.css)、.r-v2 作用域类、零 hex 字面量策略与共享状态语义。对 frontend/src/v2/ 下任何颜色/主题/令牌工作触发。
RomM v2 前端的横切功能模式——错误/snackbar 处理、加载与骨架状态、实时 Socket.IO 更新、UI 状态持久化(URL vs localStorage vs 临时)、分页/无限滚动、表单与校验、权限(useCan),以及破坏性操作确认。在为 v2 功能接行为(不只是写标签)时使用。在 frontend/src/v2/ 下实现数据流、对话框、表单、开关或权限门控时触发。
通过微交互改进、动画、无障碍(a11y)修复和 UI 结构打磨来提升 Jetpack Compose 界面。用于把硬编码样式抽取到 AppTheme、补充 TalkBack semantics、实现 AnimatedVisibility 或微动画、抽取无状态 Composable,以及添加 @Preview 注解。
RedisInsight UI 的 React/Redux 前端开发模式:组件目录结构、styled-components、hooks、命名导出、barrel 文件、布局组件与主题用法。在编辑 redisinsight/ui/** 下任何文件、编写或修改 React 组件、Redux slice、styled-components、自定义 hook,或用户提到 UI、frontend、React、Redux、styled-components 时使用。
搭建完整的 Next.js 项目,包含 TypeScript、Tailwind、shadcn/ui、TanStack Query 与主题支持。
在 Next.js 项目中搭建 Better Auth,支持邮箱 OTP 认证与 shadcn/ui 组件。
为高端网站打造 CSS Grid 编辑风排版布局系统。适用于不对称网格、杂志式版面、作品集索引、案例展示页、图片画廊、主视觉构图、专题叙事、产品证明版式、类瀑布流节奏,以及用更强的层级感取代千篇一律的卡片网格。
React/TypeScript 前端开发规则,涵盖类型安全、组件设计、状态管理与错误处理。在实现 React 组件、TypeScript 代码或前端功能时使用。
需要 Figma 个人访问令牌(Personal Access Token)或企业 OAuth 授权,令牌只需授予文件读取范围。AgentHub 详情页标注了对应环境变量。
可以读到结构并生成初版代码,但复杂交互与响应式仍需人工调整。业界普遍把它用作「设计到代码」的第一稿加速器而非最终交付。
取决于模型训练与输出条款。商用发布前请确认服务提供方公开的版权政策,重要素材保留人工审核环节。