From flutter-dev-tools
Initialize or optimize claude.md for Flutter projects. Detect real project structure from pubspec.yaml and source folders, merge existing rules, and generate a concise low-token AI guidance file that prioritizes reusing existing architecture, utilities, and coding patterns. Optionally generate minimal verified checklist docs for APIs, dependencies, and modules when explicitly requested.
How this skill is triggered — by the user, by Claude, or both
Slash command
/flutter-dev-tools:init-flutterThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> 中文环境要求
中文环境要求
- 面向用户的回复、注释、提示信息必须使用中文
- AI 内部分析可以使用英文
- 所有生成文件必须使用 UTF-8 编码
- 对外输出优先简洁、明确、可执行,避免冗长项目介绍
为 Flutter 项目生成或优化 claude.md,使 AI 工具能够:
/fdt:init-flutter
最终生成或更新的 claude.md 必须满足以下目标:
确认当前目录是 Flutter 项目。至少满足以下条件之一:
pubspec.yaml 且包含 flutter: 或 dependencies 中有 flutter 相关包lib/main.dartandroid/ 或 ios/ 目录(Flutter 项目特征)flutter --version 可执行如果不是 Flutter 项目,直接退出并说明原因。
优先读取并分析已有规则和文档,禁止直接按模板覆盖:
目标不是复制这些文档,而是抽取其中对 AI 最关键的高频约束、真实事实和复用入口。
以下信息必须只从真实来源提取:
pubspec.yaml 为准pubspec.yaml 中的 environment 为准lib/ 源码目录扫描结果为准pubspec.yaml 和已有项目文档如果文档与代码冲突,以代码和配置为准;若两者都不明确,再保留谨慎描述。
必须检测而不是臆测:
检测项目使用的状态管理方案,而不是套预设模板:
生成规则时必须写明: 修改代码时优先跟随目标文件和同目录已有状态管理模式,不因为偏好擅自迁移。
优先识别这些复用入口:
检查项目真实结构,而不是套预设模板:
不要因为检测到少量 ChangeNotifier、Bloc 或 Riverpod provider 就自动断言项目使用某种完整架构。
默认行为是"优化已有 claude.md",不是"全量重写"。
只有在以下情况才接近重写:
生成结果必须符合:
生成的 claude.md 应优先包含这些部分:
每一部分都应短、硬、可执行。
生成的 claude.md 必须显式包含并优先前置以下四段,不能只在其他章节中隐含表达:
至少要明确写出:
至少要明确写出:
至少要明确写出:
至少要优先检查并写入:
这些规则优先级高于命名规范、示例代码和通用 Flutter 最佳实践。
如果 claude.md 包含"相关文档"或"文档索引"部分,必须遵循以下格式规则:
正确示例:
错误示例:
生成 claude.md 时必须尽量固化这些规则:
如果项目中存在明确的资源、工具、常量、存储、日志规范,必须前置写入 claude.md,例如:
注意:这些规则必须来自真实项目实现或已有规范,不能凭空推荐。
不要让命名规范、网络请求示例、技术栈介绍抢在这些强约束之前占据主要篇幅。
默认不生成 docs/checklist/*。
只有在以下情况才生成:
如果生成 checklist,必须遵循:
生成或更新 claude.md 后,不要主动将其添加到 .gitignore。
这些文件可以提交到版本控制,方便团队成员共享 AI 配置。
如果用户明确要求将 AI 生成文件加入 .gitignore,则可按以下条目添加:
# AI guidance files (generated, do not commit)
claude.md
docs/checklist/api.md
docs/checklist/dependencies.md
docs/checklist/modules.md
执行方式:
对用户的总结说明要包含:
如果输出 claude.md,还必须检查一遍:
.、缺失的 []() 或损坏的列表格式禁止以下做法:
高质量结果应满足:
npx claudepluginhub adzcsx2/flutter-claude-skill --plugin flutter-dev-toolsProvides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.