[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-evanca--flutter-ai-rules":3,"tool-evanca--flutter-ai-rules":61},[4,18,26,36,44,52],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",141543,2,"2026-04-06T11:32:54",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,60],"视频",{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":77,"owner_email":75,"owner_twitter":78,"owner_website":79,"owner_url":80,"languages":75,"stars":81,"forks":82,"last_commit_at":83,"license":84,"difficulty_score":85,"env_os":86,"env_gpu":87,"env_ram":86,"env_deps":88,"category_tags":91,"github_topics":92,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":105,"updated_at":106,"faqs":107,"releases":108},4586,"evanca\u002Fflutter-ai-rules","flutter-ai-rules","Flutter AI Skills and Rules for Cursor, Copilot, Antigravity, and Other AI-Powered IDEs","flutter-ai-rules 是一套专为 Flutter 开发者打造的 AI 编程规则与技能库，旨在提升 Cursor、Windsurf、Copilot 等 AI 驱动 IDE 的代码生成质量。它通过提供基于官方文档的结构化指令，解决了 AI 助手在生成代码时风格不统一、偏离最佳实践或忽略特定框架规范（如 Riverpod、Bloc）的痛点。\n\n该工具主要服务于使用 AI 辅助编程的 Flutter 工程师。其核心亮点在于模块化的设计思路：既包含能根据任务上下文自动激活的\"Skills\"文件夹，实现动态规则匹配；也提供了针对特定技术栈的组合规则文件，且严格控制字数以适配不同 IDE 的限制。用户既可以一键部署预设规则快速上手，也能像搭积木一样灵活挑选单个规则文件进行定制。这种“按需取用”的机制，让开发者能在保持工作流一致性的同时，最大化地发挥 AI 编码助手的潜力，让生成的代码更符合专业标准。","# Flutter AI Skills and Rules for Cursor, Copilot, Antigravity, and Other AI-Powered IDEs\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fevanca_flutter-ai-rules_readme_12a72db5de4f.png\" width=\"500\" alt=\"Flutter Rules for Windsurf, Cursor\">\n\n## ⚡ TLDR\n\n**Primary method:** Copy skill folders from [`skills\u002F`](.\u002Fskills) into your IDE's skills directory (e.g., `.cursor\u002Fskills\u002F`, `.windsurf\u002Fskills\u002F`). The agent will automatically use relevant skills based on your tasks.\n\nFor traditional rules: If you want to use `.cursor\u002Frules` or `.windsurfrules`, just copy the contents of the rule set of your choice (e.g., `combined\u002Fflutter_dart__under_6K.md`) into your IDE's global or local rules.  \nFor maximum control, you can also copy the `\u002Frules` folder into your project and reference rules as needed (e.g., \"Read @rules\u002Ffirebase\u002F and set up a project with Realtime Database, App Check, and Analytics.\").\n\n## 🚀 Introduction\n\nThis repository provides a comprehensive, (almost) non-opinionated collection of Flutter-related rules tailored for use with **Windsurf**, **Cursor**, and other AI-powered IDEs. These rules are designed to improve your development workflow, ensure consistency, and help you get the most out of your AI coding assistant.\n\n## 📁 Repository Structure\n\n- **`skills\u002F`**  \n  **NEW!** Skills are an open standard for extending agent capabilities. A skill is a folder containing a `SKILL.md` file with instructions that the agent can follow when working on specific tasks. They are essentially what “dynamic rules” used to be — applied automatically when the agent determines they are relevant based on the description.\n\n  Copy or symlink any skill folder into `.cursor\u002Fskills\u002F`, `.agent\u002Fskills\u002F`, or another supported location.\n- **`rules\u002F`**  \n  Contains individual rule files, each focused on a specific topic or tool (e.g., `bloc.md`, `effective_dart.md`, etc.).  \n  These files are:\n    - Based **only** on official documentation from Flutter, Dart, or relevant package websites.\n    - Categorized by subject to make them easy to mix, match, and reference.\n    - Meant to be refined, adjusted, or extracted based on your project needs.\n\n- **`combined\u002F`**  \n  Contains pre-made, curated sets of rules that combine commonly used topics (e.g., Flutter + Riverpod + Mockito).  \n  These files:\n    - Are kept under **6,000 characters** to comply with **Windsurf's** limit.\n    - Can be used **as-is** by copying them into your global or local rules configuration.\n\n## ✅ How To Use\n\n### Option 1: Skills - Agent Will Decide What to Use\n\n1. Browse the [`skills\u002F`](.\u002Fskills) folder.\n2. Copy or symlink skill folders into your IDE's skills directory (e.g., `.cursor\u002Fskills\u002F`, `.windsurf\u002Fskills\u002F`).\n3. The agent will automatically use relevant skills based on your task descriptions.\n4. You're ready to go - skills activate contextually without manual selection.\n\n### Option 2: Use Pre-Made Combined Rules\n\nIf you want a quick setup with traditional rules:\n\n1. Browse the [`combined\u002F`](.\u002Fcombined) folder.\n2. Copy a file that suits your project.\n3. Paste it into your IDE's global or local rules config.\n4. You're ready to go.\n\n### Option 3: Use Individual Rule Files\n\nIf you prefer more control:\n\n1. Browse the [`rules\u002F`](.\u002Frules) folder.\n2. Pick files relevant to your project (e.g., `riverpod.md`, `bloc.md`, etc.).\n3. You can:\n    - **Include** them directly in your IDE setup.\n    - **Reference** them in prompts to add context.\n    - **Extract** only the parts that are useful for your context.\n    - **Include** them partially or fully in a PRD (Product Requirements Document).\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fevanca_flutter-ai-rules_readme_f247452326e2.png\" width=\"300\" alt=\"Example usage with Mocktail rules\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fevanca_flutter-ai-rules_readme_62a20880780b.png\" width=\"300\" alt=\"Example usage with Mocktail rules\">\n\u003C\u002Fdiv>\n\nEverything is modular — use what works best for you.\n\n### Option 4: Download All Skills via CLI\n\nYou can fetch the latest skills directly into your project with a single command:\n\n```sh\ngit clone --depth 1 https:\u002F\u002Fgithub.com\u002Fevanca\u002Fflutter-ai-rules.git temp_repo && mkdir -p .skills && cp -r temp_repo\u002Fskills\u002F* .skills && rm -rf temp_repo\n```\n\nThis will copy all skills into a `.skills` folder in your project. After all skills are in the `.skills` folder, you can reference them individually based on your needs. For example:\n\n\"Read `@.skills\u002Fbloc\u002FSKILL.md` and create test coverage for new methods.\"\n\n**Pro tip:**  \nYou can also configure your IDE to automatically load skills from this `.skills` folder, or reference them in prompts for specific guidance. \n\n## 📏 No Opinions, Just Documentation\n\nAll rules are sourced from official documentation — no personal preferences or subjective interpretations. That’s intentional. You’re free to alter them to your taste, but this repo keeps things objective by sticking to the source.\n\nNote: This might sometimes lead to contradictory rules (e.g., if one package suggests one folder architecture and another recommends a different one).\n\n## 📌 Use Cases\n\n- Install skills in your IDE for automatic, contextual assistance during development.\n- Set up global rules for a Flutter project in your IDE.\n- Configure project-specific constraints for popular state management packages.\n- Provide clear expectations in a PRD when working with a team.\n- Extract only what you need to avoid rule clutter.\n- Reference individual skills or rules in prompts for specific guidance.\n\n## 🛠️ Contributing\n\nContributions are welcome! If you'd like to suggest a new rule or improve an existing one, here’s how you can help:\n\n1. Fork this repository.\n2. Add or modify rules in the appropriate folder.\n3. Submit a pull request with a clear explanation of your changes.  \n   **Make sure to include an official documentation link** for any rule set you’re adding or modifying to keep everything objective and reliable.\n\n## 📚 References\n\nHere are the official sources that have been used to build these rules:\n\n### Flutter\n- [Flutter App Architecture](https:\u002F\u002Fdocs.flutter.dev\u002Fapp-architecture) - Official Flutter architecture guidelines\n- [Flutter Common Errors](https:\u002F\u002Fdocs.flutter.dev\u002Ftesting\u002Fcommon-errors) - Common errors documentation\n- [Flutter ChangeNotifier State Management](https:\u002F\u002Fdocs.flutter.dev\u002Fdata-and-backend\u002Fstate-mgmt\u002Fsimple) - Simple state management with ChangeNotifier\n\n### Dart\n- [Effective Dart](https:\u002F\u002Fdart.dev\u002Feffective-dart) - Official Dart style guidelines\n- [Dart 3 Updates](https:\u002F\u002Fdart.dev\u002Flanguage) - Documentation on Dart 3 features including:\n  - [Records](https:\u002F\u002Fdart.dev\u002Flanguage\u002Frecords)\n  - [Patterns](https:\u002F\u002Fdart.dev\u002Flanguage\u002Fpatterns)\n  - [Pattern Types](https:\u002F\u002Fdart.dev\u002Flanguage\u002Fpattern-types)\n  - [Branches](https:\u002F\u002Fdart.dev\u002Flanguage\u002Fbranches)\n\n### State Management\n- [Bloc Library](https:\u002F\u002Fbloclibrary.dev\u002F) - Official Bloc library documentation\n- [Provider](https:\u002F\u002Fpub.dev\u002Fpackages\u002Fprovider) - Official Provider package documentation\n- [Riverpod](https:\u002F\u002Friverpod.dev\u002F) - Official Riverpod documentation\n\n### Testing\n- [Mockito](https:\u002F\u002Fpub.dev\u002Fpackages\u002Fmockito) - Official Mockito for Dart documentation\n- [Mocktail](https:\u002F\u002Fpub.dev\u002Fpackages\u002Fmocktail) - Official Mocktail documentation\n\n### Firebase\n- [Firebase for Flutter](https:\u002F\u002Ffirebase.google.com\u002Fdocs\u002Fflutter\u002Fsetup) - Official Firebase Flutter documentation\n- [Code with Andrea](https:\u002F\u002Fcodewithandrea.com\u002Farticles\u002Fflutter-firebase-multiple-flavors-flutterfire-cli\u002F) - How to Setup Flutter & Firebase with Multiple Flavors using the FlutterFire CLI\n","# Flutter AI 技能与规则，适用于 Cursor、Copilot、Antigravity 等 AI 驱动的 IDE\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fevanca_flutter-ai-rules_readme_12a72db5de4f.png\" width=\"500\" alt=\"Flutter 规则，适用于 Windsurf 和 Cursor\">\n\n## ⚡ 快速概览\n\n**主要方法：** 将 `skills\u002F` 文件夹中的技能复制到你的 IDE 的技能目录中（例如 `.cursor\u002Fskills\u002F`、`.windsurf\u002Fskills\u002F`）。代理会根据你的任务自动使用相关的技能。\n\n对于传统规则：如果你想使用 `.cursor\u002Frules` 或 `.windsurfrules`，只需将你选择的规则集内容（例如 `combined\u002Fflutter_dart__under_6K.md`）复制到你的 IDE 的全局或本地规则中即可。  \n为了获得最大的控制权，你也可以将 `\u002Frules` 文件夹复制到你的项目中，并根据需要引用规则（例如：“阅读 @rules\u002Ffirebase\u002F 并设置一个包含实时数据库、App Check 和 Analytics 的项目。”）。\n\n## 🚀 简介\n\n此仓库提供了一套全面且（几乎）无偏见的 Flutter 相关规则，专为 **Windsurf**、**Cursor** 和其他 AI 驱动的 IDE 设计。这些规则旨在改善你的开发工作流程、确保一致性，并帮助你充分利用 AI 编码助手的功能。\n\n## 📁 仓库结构\n\n- **`skills\u002F`**  \n  **新增！** 技能是一种开放标准，用于扩展代理的能力。技能是一个包含 `SKILL.md` 文件的文件夹，其中包含了代理在处理特定任务时可以遵循的指令。它们本质上就是以前所说的“动态规则”——当代理根据描述判断其相关性时，会自动应用。\n\n  将任何技能文件夹复制或创建符号链接到 `.cursor\u002Fskills\u002F`、`.agent\u002Fskills\u002F` 或其他支持的位置。\n- **`rules\u002F`**  \n  包含单个规则文件，每个文件专注于一个特定的主题或工具（例如 `bloc.md`、`effective_dart.md` 等）。  \n  这些文件：\n    - 完全基于 Flutter、Dart 或相关包的官方网站文档。\n    - 按主题分类，便于混合、匹配和引用。\n    - 可以根据你的项目需求进行优化、调整或提取。\n\n- **`combined\u002F`**  \n  包含预先制作好的、精选的规则集合，结合了常用的主题（例如 Flutter + Riverpod + Mockito）。  \n  这些文件：\n    - 字数控制在 **6,000 字符** 以内，以符合 **Windsurf** 的限制。\n    - 可以直接复制到你的全局或本地规则配置中使用。\n\n## ✅ 使用方法\n\n### 方法 1：技能——由代理决定使用哪些\n\n1. 浏览 [`skills\u002F`](.\u002Fskills) 文件夹。\n2. 将技能文件夹复制或创建符号链接到你的 IDE 的技能目录中（例如 `.cursor\u002Fskills\u002F`、`.windsurf\u002Fskills\u002F`）。\n3. 代理会根据你的任务描述自动使用相关的技能。\n4. 你就可以开始使用了——技能会在上下文中自动激活，无需手动选择。\n\n### 方法 2：使用预设的组合规则\n\n如果你想要快速设置传统规则：\n\n1. 浏览 [`combined\u002F`](.\u002Fcombined) 文件夹。\n2. 复制一个适合你项目的文件。\n3. 将其粘贴到你的 IDE 的全局或本地规则配置中。\n4. 你就可以开始使用了。\n\n### 方法 3：使用单个规则文件\n\n如果你更喜欢更精细的控制：\n\n1. 浏览 [`rules\u002F`](.\u002Frules) 文件夹。\n2. 选择与你的项目相关的文件（例如 `riverpod.md`、`bloc.md` 等）。\n3. 你可以：\n    - 直接将其**纳入**你的 IDE 设置中。\n    - 在提示中**引用**它们以增加上下文。\n    - 只**提取**对你当前场景有用的部分。\n    - 将其部分或全部**纳入**产品需求文档（PRD）中。\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fevanca_flutter-ai-rules_readme_f247452326e2.png\" width=\"300\" alt=\"使用 Mocktail 规则的示例\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fevanca_flutter-ai-rules_readme_62a20880780b.png\" width=\"300\" alt=\"使用 Mocktail 规则的示例\">\n\u003C\u002Fdiv>\n\n一切都是模块化的——选择最适合你的方式即可。\n\n### 方法 4：通过 CLI 下载所有技能\n\n你可以使用一条命令将最新的技能直接下载到你的项目中：\n\n```sh\ngit clone --depth 1 https:\u002F\u002Fgithub.com\u002Fevanca\u002Fflutter-ai-rules.git temp_repo && mkdir -p .skills && cp -r temp_repo\u002Fskills\u002F* .skills && rm -rf temp_repo\n```\n\n这将会把所有技能复制到你项目的 `.skills` 文件夹中。一旦所有技能都进入 `.skills` 文件夹，你可以根据自己的需求单独引用它们。例如：\n\n“阅读 `@.skills\u002Fbloc\u002FSKILL.md`，并为新方法创建测试覆盖率。”\n\n**小贴士：**  \n你还可以配置你的 IDE 自动加载这个 `.skills` 文件夹中的技能，或者在提示中引用它们以获取具体的指导。\n\n## 📏 无偏见，只基于文档\n\n所有规则均来源于官方文档——没有任何个人偏好或主观解释。这是有意为之。你可以根据自己的喜好修改它们，但这个仓库坚持从原始资料出发，保持客观性。\n\n注意：这有时可能会导致规则相互矛盾（例如，如果一个包建议一种文件夹架构，而另一个包又推荐另一种架构）。\n\n## 📌 使用场景\n\n- 在你的 IDE 中安装技能，以便在开发过程中获得自动化的上下文相关帮助。\n- 在你的 IDE 中为 Flutter 项目设置全局规则。\n- 为流行的状态管理库配置项目特定的约束条件。\n- 在团队协作时，在 PRD 中明确期望。\n- 只提取你需要的内容，避免规则过于冗杂。\n- 在提示中引用单个技能或规则，以获得具体的指导。\n\n## 🛠️ 贡献\n\n欢迎贡献！如果你想提出新的规则或改进现有规则，可以按照以下步骤操作：\n\n1. 分支此仓库。\n2. 在相应的文件夹中添加或修改规则。\n3. 提交一个带有清晰说明的拉取请求。  \n   **请务必为任何你添加或修改的规则集附上官方文档链接**，以确保所有内容客观可靠。\n\n## 📚 参考文献\n\n以下是构建这些规则所使用的官方资料：\n\n### Flutter\n- [Flutter 应用架构](https:\u002F\u002Fdocs.flutter.dev\u002Fapp-architecture) —— 官方 Flutter 架构指南\n- [Flutter 常见错误](https:\u002F\u002Fdocs.flutter.dev\u002Ftesting\u002Fcommon-errors) —— 常见错误文档\n- [Flutter ChangeNotifier 状态管理](https:\u002F\u002Fdocs.flutter.dev\u002Fdata-and-backend\u002Fstate-mgmt\u002Fsimple) —— 使用 ChangeNotifier 的简单状态管理\n\n### Dart\n- [Effective Dart](https:\u002F\u002Fdart.dev\u002Feffective-dart) —— 官方 Dart 风格指南\n- [Dart 3 更新](https:\u002F\u002Fdart.dev\u002Flanguage) —— 关于 Dart 3 特性的文档，包括：\n  - [元组](https:\u002F\u002Fdart.dev\u002Flanguage\u002Frecords)\n  - [模式匹配](https:\u002F\u002Fdart.dev\u002Flanguage\u002Fpatterns)\n  - [模式类型](https:\u002F\u002Fdart.dev\u002Flanguage\u002Fpattern-types)\n  - [分支语句](https:\u002F\u002Fdart.dev\u002Flanguage\u002Fbranches)\n\n### 状态管理\n- [Bloc 库](https:\u002F\u002Fbloclibrary.dev\u002F) —— 官方 Bloc 库文档\n- [Provider](https:\u002F\u002Fpub.dev\u002Fpackages\u002Fprovider) —— 官方 Provider 包文档\n- [Riverpod](https:\u002F\u002Friverpod.dev\u002F) —— 官方 Riverpod 文档\n\n### 测试\n- [Mockito](https:\u002F\u002Fpub.dev\u002Fpackages\u002Fmockito) - Dart 官方 Mockito 文档\n- [Mocktail](https:\u002F\u002Fpub.dev\u002Fpackages\u002Fmocktail) - Mocktail 官方文档\n\n### Firebase\n- [Firebase for Flutter](https:\u002F\u002Ffirebase.google.com\u002Fdocs\u002Fflutter\u002Fsetup) - Firebase Flutter 官方文档\n- [Code with Andrea](https:\u002F\u002Fcodewithandrea.com\u002Farticles\u002Fflutter-firebase-multiple-flavors-flutterfire-cli\u002F) - 如何使用 FlutterFire CLI 为 Flutter 和 Firebase 设置多环境配置","# flutter-ai-rules 快速上手指南\n\n`flutter-ai-rules` 是一个专为 Flutter 开发者设计的开源规则库，旨在提升 Cursor、Windsurf、Copilot 等 AI 编程助手的代码生成质量。它基于官方文档（Flutter\u002FDart\u002F主流包），提供模块化技能和预设规则，确保 AI 输出的代码符合最佳实践。\n\n## 环境准备\n\n*   **系统要求**：Windows, macOS, 或 Linux。\n*   **前置依赖**：\n    *   已安装支持自定义规则\u002FSkills 的 AI IDE（推荐 **Cursor** 或 **Windsurf**）。\n    *   已安装 `git` 命令行工具。\n    *   熟悉 Flutter 和 Dart 基础开发流程。\n\n## 安装步骤\n\n你可以根据需求选择以下任一方式将规则集成到项目中。\n\n### 方式一：一键克隆所有 Skills（推荐）\n\n使用单行命令将所有技能文件下载到项目本地的 `.skills` 目录中，便于灵活引用。\n\n```sh\ngit clone --depth 1 https:\u002F\u002Fgithub.com\u002Fevanca\u002Fflutter-ai-rules.git temp_repo && mkdir -p .skills && cp -r temp_repo\u002Fskills\u002F* .skills && rm -rf temp_repo\n```\n\n### 方式二：手动配置全局\u002F局部规则\n\n如果你希望 AI 自动应用规则而无需每次指定：\n\n1.  浏览本仓库的 `skills\u002F` 文件夹（用于动态技能）或 `combined\u002F` 文件夹（用于传统静态规则）。\n2.  将选中的文件夹（如 `skills\u002Fbloc`）复制或软链接到你的 IDE 配置目录：\n    *   **Cursor**: `.cursor\u002Fskills\u002F` 或 `.cursor\u002Frules\u002F`\n    *   **Windsurf**: `.windsurf\u002Fskills\u002F` 或 `.windsurfrules`\n3.  IDE 重启后会自动加载这些上下文。\n\n> **提示**：国内用户若克隆速度慢，可尝试使用镜像加速服务，或将仓库 Fork 到国内代码托管平台（如 Gitee）后再克隆。\n\n## 基本使用\n\n### 场景 A：自动上下文感知（使用 Skills）\n\n如果你采用了**方式一**或**方式二**安装了 Skills 文件夹，AI 会根据你的任务描述自动匹配规则。\n\n**操作示例**：\n直接在对话框中输入自然语言指令，无需额外参数：\n> \"为当前的 User 模型创建单元测试。\"\n\nAI 会自动读取 `.skills\u002F` 中相关的测试规范（如 Mocktail 规则）并生成符合标准的代码。\n\n### 场景 B：手动指定规则（精准控制）\n\n如果你只想在特定任务中应用某项规则，可以在提示词中显式引用本地文件。\n\n**操作示例**：\n假设你已下载 skills 到 `.skills` 目录，需要创建 Bloc 测试：\n\n> \"Read `@.skills\u002Fbloc\u002FSKILL.md` and create test coverage for new methods.\"\n\n或者在中文提示中引用：\n> \"请参考 `@.skills\u002Friverpod\u002FSKILL.md` 中的规范，重构当前的状态管理代码。\"\n\n### 场景 C：使用预设组合规则\n\n对于新项目，可以直接使用 `combined\u002F` 目录下的整合规则文件（如 `flutter_dart__under_6K.md`），将其内容复制到 IDE 的全局规则设置中。这将一次性注入 Flutter + Dart + 常用库的综合最佳实践，适合快速初始化项目环境。","某中级 Flutter 开发者正利用 Cursor 编辑器为一个电商项目快速搭建基于 Riverpod 的状态管理模块，并需要集成 Mocktail 进行单元测试。\n\n### 没有 flutter-ai-rules 时\n- AI 生成的代码经常混用 Provider 和 Riverpod 写法，导致架构风格不统一，需人工反复修正。\n- 编写的测试用例往往忽略 Mocktail 的最新语法规范，产生大量编译警告或运行时错误。\n- 每次提示词都要冗长地强调“请遵循官方 Dart 有效指南”和“使用 Riverpod 2.0\"，沟通成本极高。\n- AI 偶尔会幻觉出不存在的 API 用法，开发者必须花费大量时间查阅官方文档进行验证。\n- 不同文件间的代码规范（如命名约定、异步处理模式）不一致，增加了代码审查的难度。\n\n### 使用 flutter-ai-rules 后\n- 将 `skills\u002Friverpod` 和 `skills\u002Fmocktail` 文件夹复制进 `.cursor\u002Fskills\u002F` 后，AI 自动输出完全符合最新官方规范的纯净代码。\n- 生成的单元测试直接适配 Mocktail 最佳实践，无需额外调试即可通过运行，显著减少报错。\n- 无需在对话中重复约束条件，AI 根据任务上下文自动激活对应技能，提示词变得简洁高效。\n- 所有建议均严格基于 Flutter 和 Dart 官方文档，彻底消除了 API 幻觉，代码可信度大幅提升。\n- 整个项目的状态管理与测试代码保持高度一致的风格，极大降低了团队协作和维护成本。\n\nflutter-ai-rules 通过将官方最佳实践转化为 AI 的原生认知，让开发者从繁琐的规范纠正中解放出来，专注于核心业务逻辑的实现。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fevanca_flutter-ai-rules_12a72db5.png","evanca","Ivanna","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fevanca_941119e9.png",null,"Happy Code Studio","Latvia ","ivannahere","happycode.studio","https:\u002F\u002Fgithub.com\u002Fevanca",518,50,"2026-04-06T07:24:59","MIT",1,"未说明","无需求",{"notes":89,"python":86,"dependencies":90},"该工具并非需要运行环境的 AI 模型，而是一组用于 Cursor、Windsurf 等 AI 驱动 IDE 的规则和技能文件集合（Markdown 格式）。用户只需将文件复制到 IDE 的配置目录（如 .cursor\u002Fskills\u002F）或通过 CLI 命令获取即可使用，无需安装 Python、GPU 驱动或任何运行时依赖库。",[],[14,35,13,15],[93,94,95,96,97,98,99,100,101,102,103,104],"cursor","cursor-ai","dart","flutter","llm","windsurf","windsurf-ai","ai","ai-rules","ai-skills","antigravity","dartlang","2026-03-27T02:49:30.150509","2026-04-07T03:52:51.761277",[],[]]