Flutter 仓库的个人 Agent 配置详解Reidbaker Agent 的定位、Expert 人格与双轨技能体系【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter本文围绕 Flutter 仓库中 .agents/agents/reidbaker-agent/README.md 展开讲清这个个人 Agent 在仓库 Agent 体系中的定位、config.yaml中 Expert 人格 prompt 的设计、以及托管技能npx skillsskills-lock.json 本地技能的双轨技能管理机制并结合 code-review 与 natural-writing 两个本地技能说明完整的代码评审工作流帮助你复现一个可验证、可治理的端到端 Agent 工作流。适用场景什么时候使用 Reidbaker AgentReidbaker Agent 的使用场景在 README 中说得直接当你想采用 Reid仓库中 Flutter 团队核心维护者之一的个人工作流时使用它。它预配置了 Expert 人格以获得最高的严谨度与直言程度rigor and candor并预装了两个专用技能code-review和natural-writing。它在整个 Flutter 仓库 Agent 体系中的定位需要结合上级目录的 .agents/agents/README.md 来理解人格化/团队化集合仓库长期目标是维护按人格或团队划分的技能与 Agent 配置集合例如android-agent、ios-agent。个人入门 Agent像reidbaker-agent这样的个人化配置主要目的是让贡献者体验到成功的端到端 Agent 工作流、降低上手门槛。文档明确指出一旦个人化配置达到一定规模仓库的意图是逐步弃用并移除个人 Agent转而由贡献者把高度个人化的 Agent 托管在自己的 GitHub 仓库中。也就是说Reidbaker Agent 是一个样板它演示了如何把人格 prompt、技能发现路径、托管技能锁文件和个人维护的技能组织成一个自洽的 Agent 目录。目录结构与三个核心配置文件Reidbaker Agent 的完整目录如下.agents/agents/reidbaker-agent/ ├── README.md # 本文主体文档 ├── agent.json # Agent 元信息与配置入口 ├── config.yaml # 人格 prompt 与技能发现配置 ├── skills-lock.json # 托管第三方技能清单 └── skills/ # 本地维护的技能 ├── code-review/ │ ├── SKILL.md │ ├── references/ │ │ ├── critique_rules.md │ │ ├── review_criteria.md │ │ └── splitting_reviews.md │ └── scripts/ │ └── split_diff.py └── natural-writing/ └── SKILL.mdagent.json元信息与配置入口agent.json 定义了 Agent 的名称、描述以及配置文件指针{ name: reidbaker-agent, description: An agent configured with the Expert persona for maximum rigor and candor., configPath: { relativePathToConfig: config.yaml } }从结构看configPath.relativePathToConfig是加载链的起点Agent 运行时先读agent.json再按该相对路径加载config.yaml获取完整行为配置。config.yaml运行模式、Expert 人格与环境自检config.yaml 包含三段配置分别对应运行模式人格定制技能发现1. 运行模式coding_agentcoding_agent: agentic_mode: true # 启用自主 Agent 模式 google_mode: false2. Prompt 定制prompt_section_customization通过append_prompt_sections向系统提示词追加两个自定义段落identityExpert 人格要求 Agent 以世界顶级专家的标准作答——完整、详细、具体逐步推理并自我校验Never hallucinate or make anything up不知道就直说语气精确但不咄咄逼人允许挑衅性、论战性的回答负面结论和坏消息都可以直接给出不需要免责声明、不需要政治正确。此外还有一组明确的反迎合约束不夸赞提问、不在回答前验证用户前提、用户错了立即指出、先给出对用户立场的最强反论证再谈支持、被反驳时除非有新证据否则不轻易退让、对用户给出的数字/估计值不锚定要独立生成自己的估计、使用显式置信度high/moderate/low/unknown、Accuracy is your success metric, not my approval。Environment Verification环境自检规定 Agent 在新会话中的第一步是用文件系统工具检查.agents/agents/reidbaker-agent/.agents/skills目录是否存在且包含技能若缺失或为空必须停止并提示用户执行cd .agents/agents/reidbaker-agent npx skills experimental_install来拉取托管技能在此之前不回答其他问题。这是一个很实用的设计它把技能未安装从一个静默降级变成了显式的、可恢复的阻塞状态。3. 技能发现customization_configcustomization_config: customization_discovery_config: skills: inherit_user: true # 同时继承用户级技能 skills_paths: - workspace_relative: .agents/agents/reidbaker-agent/skills从这段配置看该 Agent 的技能来源是用户级继承 Agent 目录下skills/的 workspace 相对路径即本地技能code-review、natural-writing通过skills_paths被发现而托管技能则由npx skills安装机制单独管理。双轨技能体系托管技能与本地技能README 的核心信息就是技能管理机制原文要点如下.agents/skills中仓库共享目录的技能由npx skills管理要拉取skills-lock.json中定义的技能执行npx skills experimental_installskills/目录Agent 本地中的技能是本地维护的。托管技能skills-lock.json 锁文件skills-lock.jsonversion: 1锁定了 11 个第三方技能每个条目包含来源仓库source、来源类型sourceType: github、仓库内的技能路径skillPath和内容哈希computedHash用于校验安装内容未被篡改。按来源分组如下技能来源仓库仓库内路径dart-best-practiceskevmoo/dash_skillsplugins/dash-skills/skills/dart-best-practices/SKILL.mddart-build-cli-appdart-lang/skillsskills/dart-build-cli-app/SKILL.mddart-doc-validationkevmoo/dash_skillsplugins/dash-skills/skills/dart-doc-validation/SKILL.mddart-long-lineskevmoo/dash_skillsplugins/dash-skills/skills/dart-long-lines/SKILL.mddart-matcher-best-practiceskevmoo/dash_skillsplugins/dash-skills/skills/dart-matcher-best-practices/SKILL.mddart-migrate-to-checks-packagedart-lang/skillsskills/dart-migrate-to-checks-package/SKILL.mddart-modern-featureskevmoo/dash_skillsplugins/dash-skills/skills/dart-modern-features/SKILL.mddart-package-maintenancekevmoo/dash_skillsplugins/dash-skills/skills/dart-package-maintenance/SKILL.mddart-test-coveragekevmoo/dash_skillsplugins/dash-skills/skills/dart-test-coverage/SKILL.mddart-test-fundamentalskevmoo/dash_skillsplugins/dash-skills/skills/dart-test-fundamentals/SKILL.mdgrill-memattpocock/skillsskills/productivity/grill-me/SKILL.mdtest-driven-developmentobra/superpowersskills/test-driven-development/SKILL.md可以看出托管技能高度聚焦 Dart 工程实践最佳实践、CLI 工具构建、文档校验、长行拆分、matcher 规范、checks 包迁移、现代 Dart 特性、包维护、测试覆盖率与测试基础外加通用方法论技能grill-me压力拷问和test-driven-developmentTDD。这正好呼应了 Expert 人格最大严谨度的意图人格管态度技能管方法论。本地技能code-review 与 natural-writing本地技能不经npx分发而是直接提交在 skills/ 目录下随仓库版本化。这正是上级 README.agents/agents/README.md中治理规则的适用对象任何为 Agent 专门编写的本地技能非npx安装的第三方依赖必须注册到仓库的技能校验测试套件——这一点由 dev/tools/test/validate_skills_test.dart 落实该测试中显式定义了reidbakerSkillsDirectory.agents/agents/reidbaker-agent/skills并将其纳入skillDirPaths一起校验。本地技能深读code-review 的五步评审工作流SKILL.md 定义了一个生成 → 批判 → 综合generation, critique, synthesis迭代的完整评审流程目标是避免 AI 评审的典型毛病无意义的 looks good 评论、在未修改行上评论。核心原则只在真实存在问题/bug/改进点时评论建议只针对 diff 中实际修改的行尽量给出可落地的具体代码建议书面反馈遵循 natural-writing 技能若存在针对代码库/语言/框架的专用技能优先引用其最佳实践。五步工作流Gather Changes收集变更GitHub PR 场景用gh pr view读标题与描述理解意图gh pr diff取实际变更本地变更场景用git status、git diff/git diff --staged、git log -p。Context Enrichment上下文富集评审前识别需要一并阅读的文件——被导入/引用的文件、父类与接口、相关工具文件、对应测试文件评审过大时按 splitting_reviews.md 的规则拆分。Generate Initial Review生成初审围绕正确性功能、边界、API 使用、效率瓶颈、冗余计算、可维护性可读性、风格规范、安全潜在漏洞四个维度生成评论评审标准以 review_criteria.md 为准关键约束是不得添加表扬用户做得好的评论。Critique and Refine自批判即评审你的评审按 critique_rules.md 过滤或修改评论——只保留落在 diff/-行上的评论、删除纯信息性/表扬性评论、代码建议必须可编译且缩进与目标代码一致。Synthesis综合成稿去重、按严重度排序critical 与 high 置顶产出四段式输出高层摘要段落、文件级摘要每个变更文件一句话以 Added/Updated 等过去式动词开头、按严重度排列的评论列表、可执行建议汇总每条评论需标注 File / Line锚定 diff/ Severitycritical、high、medium、low/ Body / Suggestion可选最终 Markdown 写入会话产物目录如review_results.md并展示给用户。评审标准与严重度细则来自 review_criteria.md优先级依次为正确性、效率、可维护性、安全严重度四级critical必须立即处理可能造成正确性/安全/性能的严重后果、high应尽快处理未来大概率引发问题、medium值得考虑改进不紧急、low次要或风格问题作者可酌情处理关键约束只评论变更行不写无信息量的表扬不解释代码做了什么作者自己知道建议必须简洁且可直接应用、可编译。critique_rules.md 还给出了一组实用的严重度校准基线重构硬编码字符串/数字、日志增强、Markdown 注释、补 docstring、抑制 warning/TODO 一般归lowtypo 归low/medium测试文件的评论除非指向关键覆盖缺口否则一般low。大 diff 拆分工具当 diff 超过约 500 行或 10 个文件、跨多个组件/层、或一个 PR 混了多个不相关特性时splitting_reviews.md 建议按文件/组件按目录、按层数据库 → 后端 → 前端 → 测试、按文件类型或按关注点多轮遍第 1 遍正确性与架构、第 2 遍风格与可维护性、第 3 遍安全与性能两种策略拆分再在 Synthesis 步去重合并。配套脚本 split_diff.py 支持从 stdin 或文件读取 diff也支持--json/--json-key从 JSON 包裹中抽取 diff 字符串按diff --git标记回退到---标记切成每文件一个 chunk 写入指定目录并把路径中的/替换为_作为安全文件名。用法示例python3 .agents/agents/reidbaker-agent/skills/code-review/scripts/split_diff.py --output-dir scratch/diff_chunks diff.txt python3 .agents/agents/reidbaker-agent/skills/code-review/scripts/split_diff.py --json --json-key diff --output-dir scratch/diff_chunks input.jsonnatural-writing反 AI 腔 的写作规则natural-writing 技能 在写长文本分析文档、PR/CL 描述、文档时生效其规则是 code-review 输出质量的保证。要点包括禁用词表统计上在 AI 文本中过度出现的动词delve、underscore、leverage、foster…、名词tapestry、landscape、testament、synergy…、形容词pivotal、crucial、nuanced、transformative…禁止 系词替换不要为了华丽把 is/are 换成 serves as / stands as代码与注释中禁用相对时间词now、currently、old、new、modern 等随时间推移会失去意义的词无夸大与虚假显著性不用 serves as a testament to、marking a pivotal moment 这类短语也不用 highlighting/emphasizing/reflecting 开头的空洞尾缀分词从句句式约束不用 not only X but also Y 式否定排比、不刻意凑 三项并列、不用无逻辑区间的 from X to Y格式约束标题用 Sentence case、不用 emoji 和非常规 bullet、简单信息不建表、用直引号而非弯引号、克制使用 em dash引用与诚信不生成没看过来源的引用不编造 URL/DOI聊天上下文不用 Certainly! 这类协作性填充语、不加 Subject: 前缀、编辑摘要保持简短非正式。治理与落地CODEOWNERS、技能校验与运行步骤所有权CODEOWNERS 中为整个 Agent 目录指派了 owner.agents/agents/reidbaker-agent/** reidbaker与 .agents/agents/README.md 的治理要求一致——每个 Agent 目录必须在根CODEOWNERS中指派明确的 owner 或团队。校验如前所述本地技能已注册进 dev/tools/test/validate_skills_test.dart 的校验目录列表与共享的.agents/skills目录一起参与自动校验仓库另提供dart_skills_lint工具做手动 lint用法见 .agents/skills/README.md。在本地运行该 Agent 的步骤克隆/打开 Flutter 仓库工作区进入 Agent 目录并安装托管技能cd .agents/agents/reidbaker-agent npx skills experimental_install该命令按 skills-lock.json 拉取并校验全部 11 个第三方技能用支持该 Agent 目录规范的编码 Agent 启动会话。若托管技能未装好config.yaml中的 Environment Verification 段会让 Agent 在第一轮就停下来提示你执行上面的安装命令而不是在缺失方法论的情况下继续回答。小结Reidbaker Agent 展示了 Flutter 仓库对个人 Agent 作为入门样板的完整工程化做法agent.json提供元信息与配置入口config.yaml注入 Expert 人格、环境自检和技能发现路径skills-lock.json以锁文件方式固定 11 个第三方技能含内容哈希校验skills/目录则以版本化方式承载code-review五步迭代评审 三份 reference 文档 diff 拆分脚本与natural-writing系统性反 AI 腔写作规则两个本地技能所有权由CODEOWNERS固化、本地技能由dev/tools/test/validate_skills_test.dart纳入 CI 校验。这套人格 托管技能 本地技能 治理的组合正是仓库希望贡献者体验并复制的端到端 Agent 工作流。【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考