尧图网站建设 
Flutter 仓库 Agent Skills 中的自然写作规则消除机器文本AI 味的系统化手册【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter本文基于 Flutter 开源仓库随附的 agent skill 文档 natural-writing SKILL.md 展开。这是一份专门用于消除大语言模型常见文体与结构套路文档称之为 AI-isms的严格规则集挂载在仓库的reidbaker-agent上供 PR 描述、代码审查意见、分析文档等长文本写作场景加载。读完后你可以掌握完整禁用词表与替代表达、六大类句式/结构/引用禁忌及其判定标准以及这套规则在 Flutter 仓库中如何被 code-review 流程引用、被 skill lint 工具校验的工程化机制。技能在 Flutter agent 体系中的位置Flutter 仓库在.agents/目录下维护了一套面向贡献者的 agent 与 skill 基础设施。.agents/skills/README.md 说明了共享 skill 的准入要求作者必须实际使用过、PR 需附提示词与输出示例、命名与规范合规和推荐实践提供增量信息、每个 CLI 工具一个 skill、指令越结构化越好、脚本用 Dart 编写等。reidbaker-agent是其中一个预配置了 Expert 人格的 agent见 agent.json 与 README。其 config.yaml 做了三件关键配置coding_agent.agentic_mode: true启用 agentic 模式prompt_section_customization.append_prompt_sections追加了两个 prompt 段identity段要求回答精确、分步推理、自查事实、标注置信度、不对用户示弱Environment Verification段要求 agent 在新会话第一步检查 skill 目录是否已安装缺失时提示用户运行cd .agents/agents/reidbaker-agent npx skills experimental_installcustomization_config中skills_paths指向.agents/agents/reidbaker-agent/skills并设置inherit_user: true继承用户级 skill。该 agent 的 skill 分两类管理外部 skill 由skills-lock.json锁定skills-lock.json 记录了dart-best-practices、dart-build-cli-app、test-driven-development等 12 个来自多个 GitHub 源的 skill 及其computedHash通过npx skills experimental_install拉取本地 skill 则直接放在skills/目录natural-writing与code-review即属此类。后者的 code-review SKILL.md 在核心原则和Step 5: Synthesis两处都明确要求最终评审输出遵循 natural-writing 规则使本文讨论的文档成为 Flutter 代码审查流水线的实际组成部分而不仅仅是风格建议。规则一词汇与措辞控制Vocabulary Phrasing Controls文档开篇即给出动机这些词在 AI 文本中统计上过量出现应改用更简单直接的替代词。禁用词表分三类动词delve, underscore, highlight作动词时, foster, cultivate, maximize, leverage, democratize, ensure, align with, resonate with, encompass, bridge名词tapestry, landscape抽象用法, realm, testament, interplay, synergy, cornerstone, hub, ecosystem抽象用法形容词pivotal, crucial, vibrant, intricate, nuanced, unwavering, indelible, uncharted, rapidly evolving, transformative, breathtaking, nestled, dynamic中文语境下可以推断出对应的同构问题堆砌赋能生态格局深远影响一类抽象大词同样应替换为具体表述。接着是三条更细的措辞规则均配了 bad/good 对照示例避免系动词替换。不要拿华丽动词替代简单的 is/are反例The libraryserves asa center for learning.反例The statuestands asa monument to...正例The libraryisa center for learning.正例The statueisa monument to...消除优雅变体。不要为了回避重复主语名字而换同义词如 the eponymous character、the titular protagonist、the celebrated author。自然地重复名词或用人称代词是可接受的。代码与注释中的时间词禁令。变量名、函数名、注释中不得使用相对时间词因为代码库演化后这些词会失去意义禁用词now, currently, existing behavior, previous behavior, old, new, modern反例// This function now uses the config parser instead of hardcoding.正例// Resolves paths via [ConfigParser.loadConfig] to support custom config locations.这条规则对维护 Flutter 这样的大型仓库尤其实际注释里写 now/old/new 的文本在半年后的 diff 中已经无法解释行为变化的方向。规则二内容与语气Content Tone禁止夸大与强行拔高不应用模糊赞美夸大主题的重要性。重要这件事应该由事实本身证明。规则明令避免 serves as a testament to、marking a pivotal moment、underscoring the importance of、leaving an indelible mark、shaping the landscape 等短语。文档示例反例The founding of the institute marked a pivotal moment in the evolution of regional statistics, representing a significant shift toward independence.正例The institute was founded in 1989 to collect regional statistics.禁止空泛的现在分词评注删掉那些只复述显而易见内容、以 highlighting、emphasizing、reflecting、showcasing、demonstrating 开头的悬垂分词短语反例The building uses blue glass,reflecting the regions natural beauty and symbolizing unity.正例The building uses blue glass.避免宣传腔保持中立语气警惕 boasts, features作动词, offers, premier, leading, state-of-the-art, committed to, dedicated to 这类广告词反例Nestled in the heart of the city, the hotel boasts a vibrant atmosphere.正例The hotel is located in the city center.拒绝挑战与展望套式结尾LLM 习惯以 Despite challenges... remains important 一类段落收尾。规则要求不要用 Despite [X], [Subject] continues to... 开头写总结段也不要展望式揣测直接停在最后一个事实上。示例反例Despite facing economic hurdles, the company continues to thrive and remains a beacon of innovation.不要把标题当专有名词开篇描述性的文章标题清单、宽泛主题不应在首句被当作专有名词使用反例The List of songs about Mexicois a curated compilation...正例This list contains songs about Mexico...See Also 链接须具体相关阅读条目不得堆砌宽泛词条。链接必须与主题直接相关且具体写某家初创公司的文章里挂Financial technology词条是反例挂其竞争对手或具体的相关技术才是正例。归因要精确避免 Experts argue、Observers have noted、Several sources indicate 等含糊归因除非紧接着给出具体人名。也不要声称某主题与更宏大的历史或趋势相关除非来源明确这么说。规则三句子结构Sentence Structure三条结构性禁令各配反例避免负面对仗。不要无必要地构造 not only... but also 式对比反例It isnot onlya painting,but alsoa representation of...反例It isnotjust about X;it isabout Y.正例It is a painting that represents...避免三项排比。不要为显得全面而恰好列三个形容词或三个名词短语The event brings togethermarketers, engineers, and designers 只有在确实只有这三类群体时才成立It isbold, innovative, and unique 是典型反例。避免虚假区间。from X to Y 只在 X 和 Y 是逻辑标度端点如时间、尺寸时才可用反例The book covers everythingfrombiologytospace travel.这是两个不相干话题不是区间正例The book covers topics including biology and space travel.规则四结构与格式Structure Formatting标题用 Sentence case句首大写不用 Title CaseEarly life 而非 Early Life。禁止行内标题列表格式即* **Header:** Description...这种写法改用正文段落或简单列表。不过度加粗正文中不要给关键词、key takeaways、人名加粗导语中首次出现除外。不用 emoji如 、或怪异的项目符号#、-列表一律用标准*。不为一句话能讲清的信息建表格。标记语法要匹配载体在 Wikitext 等不支持 Markdown 的环境里不要写##除非明确做过转换。标点引号一律用直引号、不用弯引号、em dash—要克制使用强调改用逗号或括号。规则五引用与诚信Citations Integrity三条反幻觉规则没在看着来源时绝不生成引用不编造 URL 或 DOI未经验证不得假设某本书存在、或包含某个具体事实。规则六聊天场景沟通Communication针对对话式交互的四条约束不要以 Certainly!、Here is the information、I hope this helps 等协作性废话开场直接给内容不声明知识截止、不为我是 AI道歉As of my last update in... 只在涉及时间敏感事实时可用不要用Subject: ...给回复加主题行生成编辑摘要时保持简短随意避免冗长正式的合规性段落。规则在 Flutter 仓库中的工程化落地natural-writing 不是孤立的文档它在仓库里有明确的消费方与校验链路。消费方code-review SKILL.md 的五步评审流程收集变更、上下文增强、生成初评、自我批判、综合定稿中Step 5 要求最终输出 cohesive 且遵循 natural-writing 规则核心原则第 4 条也以相对链接../natural-writing/SKILL.md显式引用本技能。也就是说agent 产出的每一条评审意见都要过一遍禁用词表与句式检查。校验方仓库对 skill 文档本身也做了机械化约束。.agents/skills/README.md 给出在dev/tools目录下运行 lint 的完整命令dart run dart_skills_lint:cli --skills-directory ../../.agents/skills --check-trailing-whitespace --check-absolute-paths --check-relative-paths并列出作者可用的标志位--fix干跑预览修复、--fix-apply自动应用可修复项如行尾空白、--check-trailing-whitespace、--check-absolute-paths链接不得用绝对路径、--check-relative-paths相对链接必须指向存在的文件另有自动化测试dart test test/validate_skills_test.dart。dev/tools/skills_lint.yaml 将这三条规则全部设为error级别作用目录为.agents/skills.agents/skills/skills_lint_ignore.json 则为find-release的 SKILL.md 保留了check-relative-paths的豁免记录。值得注意的是natural-writing 文档自身的行文即遵循它规定的风格全小写引导短语、*标准列表、直引号、每个规则配 bad/good 对照、结尾停在最后一个事实上。从源码结构看这正是 .agents/skills/README.md 推荐实践中指令越严格、越结构化agent 遵循效果越好这条经验的具体体现。【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Flutter 仓库 Agent Skills 中的自然写作规则：消除机器文本“AI 味“的系统化手册
Flutter 仓库 Agent Skills 中的自然写作规则消除机器文本AI 味的系统化手册【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter本文基于 Flutter 开源仓库随附的 agent skill 文档 natural-writing SKILL.md 展开。这是一份专门用于消除大语言模型常见文体与结构套路文档称之为 AI-isms的严格规则集挂载在仓库的reidbaker-agent上供 PR 描述、代码审查意见、分析文档等长文本写作场景加载。读完后你可以掌握完整禁用词表与替代表达、六大类句式/结构/引用禁忌及其判定标准以及这套规则在 Flutter 仓库中如何被 code-review 流程引用、被 skill lint 工具校验的工程化机制。技能在 Flutter agent 体系中的位置Flutter 仓库在.agents/目录下维护了一套面向贡献者的 agent 与 skill 基础设施。.agents/skills/README.md 说明了共享 skill 的准入要求作者必须实际使用过、PR 需附提示词与输出示例、命名与规范合规和推荐实践提供增量信息、每个 CLI 工具一个 skill、指令越结构化越好、脚本用 Dart 编写等。reidbaker-agent是其中一个预配置了 Expert 人格的 agent见 agent.json 与 README。其 config.yaml 做了三件关键配置coding_agent.agentic_mode: true启用 agentic 模式prompt_section_customization.append_prompt_sections追加了两个 prompt 段identity段要求回答精确、分步推理、自查事实、标注置信度、不对用户示弱Environment Verification段要求 agent 在新会话第一步检查 skill 目录是否已安装缺失时提示用户运行cd .agents/agents/reidbaker-agent npx skills experimental_installcustomization_config中skills_paths指向.agents/agents/reidbaker-agent/skills并设置inherit_user: true继承用户级 skill。该 agent 的 skill 分两类管理外部 skill 由skills-lock.json锁定skills-lock.json 记录了dart-best-practices、dart-build-cli-app、test-driven-development等 12 个来自多个 GitHub 源的 skill 及其computedHash通过npx skills experimental_install拉取本地 skill 则直接放在skills/目录natural-writing与code-review即属此类。后者的 code-review SKILL.md 在核心原则和Step 5: Synthesis两处都明确要求最终评审输出遵循 natural-writing 规则使本文讨论的文档成为 Flutter 代码审查流水线的实际组成部分而不仅仅是风格建议。规则一词汇与措辞控制Vocabulary Phrasing Controls文档开篇即给出动机这些词在 AI 文本中统计上过量出现应改用更简单直接的替代词。禁用词表分三类动词delve, underscore, highlight作动词时, foster, cultivate, maximize, leverage, democratize, ensure, align with, resonate with, encompass, bridge名词tapestry, landscape抽象用法, realm, testament, interplay, synergy, cornerstone, hub, ecosystem抽象用法形容词pivotal, crucial, vibrant, intricate, nuanced, unwavering, indelible, uncharted, rapidly evolving, transformative, breathtaking, nestled, dynamic中文语境下可以推断出对应的同构问题堆砌赋能生态格局深远影响一类抽象大词同样应替换为具体表述。接着是三条更细的措辞规则均配了 bad/good 对照示例避免系动词替换。不要拿华丽动词替代简单的 is/are反例The libraryserves asa center for learning.反例The statuestands asa monument to...正例The libraryisa center for learning.正例The statueisa monument to...消除优雅变体。不要为了回避重复主语名字而换同义词如 the eponymous character、the titular protagonist、the celebrated author。自然地重复名词或用人称代词是可接受的。代码与注释中的时间词禁令。变量名、函数名、注释中不得使用相对时间词因为代码库演化后这些词会失去意义禁用词now, currently, existing behavior, previous behavior, old, new, modern反例// This function now uses the config parser instead of hardcoding.正例// Resolves paths via [ConfigParser.loadConfig] to support custom config locations.这条规则对维护 Flutter 这样的大型仓库尤其实际注释里写 now/old/new 的文本在半年后的 diff 中已经无法解释行为变化的方向。规则二内容与语气Content Tone禁止夸大与强行拔高不应用模糊赞美夸大主题的重要性。重要这件事应该由事实本身证明。规则明令避免 serves as a testament to、marking a pivotal moment、underscoring the importance of、leaving an indelible mark、shaping the landscape 等短语。文档示例反例The founding of the institute marked a pivotal moment in the evolution of regional statistics, representing a significant shift toward independence.正例The institute was founded in 1989 to collect regional statistics.禁止空泛的现在分词评注删掉那些只复述显而易见内容、以 highlighting、emphasizing、reflecting、showcasing、demonstrating 开头的悬垂分词短语反例The building uses blue glass,reflecting the regions natural beauty and symbolizing unity.正例The building uses blue glass.避免宣传腔保持中立语气警惕 boasts, features作动词, offers, premier, leading, state-of-the-art, committed to, dedicated to 这类广告词反例Nestled in the heart of the city, the hotel boasts a vibrant atmosphere.正例The hotel is located in the city center.拒绝挑战与展望套式结尾LLM 习惯以 Despite challenges... remains important 一类段落收尾。规则要求不要用 Despite [X], [Subject] continues to... 开头写总结段也不要展望式揣测直接停在最后一个事实上。示例反例Despite facing economic hurdles, the company continues to thrive and remains a beacon of innovation.不要把标题当专有名词开篇描述性的文章标题清单、宽泛主题不应在首句被当作专有名词使用反例The List of songs about Mexicois a curated compilation...正例This list contains songs about Mexico...See Also 链接须具体相关阅读条目不得堆砌宽泛词条。链接必须与主题直接相关且具体写某家初创公司的文章里挂Financial technology词条是反例挂其竞争对手或具体的相关技术才是正例。归因要精确避免 Experts argue、Observers have noted、Several sources indicate 等含糊归因除非紧接着给出具体人名。也不要声称某主题与更宏大的历史或趋势相关除非来源明确这么说。规则三句子结构Sentence Structure三条结构性禁令各配反例避免负面对仗。不要无必要地构造 not only... but also 式对比反例It isnot onlya painting,but alsoa representation of...反例It isnotjust about X;it isabout Y.正例It is a painting that represents...避免三项排比。不要为显得全面而恰好列三个形容词或三个名词短语The event brings togethermarketers, engineers, and designers 只有在确实只有这三类群体时才成立It isbold, innovative, and unique 是典型反例。避免虚假区间。from X to Y 只在 X 和 Y 是逻辑标度端点如时间、尺寸时才可用反例The book covers everythingfrombiologytospace travel.这是两个不相干话题不是区间正例The book covers topics including biology and space travel.规则四结构与格式Structure Formatting标题用 Sentence case句首大写不用 Title CaseEarly life 而非 Early Life。禁止行内标题列表格式即* **Header:** Description...这种写法改用正文段落或简单列表。不过度加粗正文中不要给关键词、key takeaways、人名加粗导语中首次出现除外。不用 emoji如 、或怪异的项目符号#、-列表一律用标准*。不为一句话能讲清的信息建表格。标记语法要匹配载体在 Wikitext 等不支持 Markdown 的环境里不要写##除非明确做过转换。标点引号一律用直引号、不用弯引号、em dash—要克制使用强调改用逗号或括号。规则五引用与诚信Citations Integrity三条反幻觉规则没在看着来源时绝不生成引用不编造 URL 或 DOI未经验证不得假设某本书存在、或包含某个具体事实。规则六聊天场景沟通Communication针对对话式交互的四条约束不要以 Certainly!、Here is the information、I hope this helps 等协作性废话开场直接给内容不声明知识截止、不为我是 AI道歉As of my last update in... 只在涉及时间敏感事实时可用不要用Subject: ...给回复加主题行生成编辑摘要时保持简短随意避免冗长正式的合规性段落。规则在 Flutter 仓库中的工程化落地natural-writing 不是孤立的文档它在仓库里有明确的消费方与校验链路。消费方code-review SKILL.md 的五步评审流程收集变更、上下文增强、生成初评、自我批判、综合定稿中Step 5 要求最终输出 cohesive 且遵循 natural-writing 规则核心原则第 4 条也以相对链接../natural-writing/SKILL.md显式引用本技能。也就是说agent 产出的每一条评审意见都要过一遍禁用词表与句式检查。校验方仓库对 skill 文档本身也做了机械化约束。.agents/skills/README.md 给出在dev/tools目录下运行 lint 的完整命令dart run dart_skills_lint:cli --skills-directory ../../.agents/skills --check-trailing-whitespace --check-absolute-paths --check-relative-paths并列出作者可用的标志位--fix干跑预览修复、--fix-apply自动应用可修复项如行尾空白、--check-trailing-whitespace、--check-absolute-paths链接不得用绝对路径、--check-relative-paths相对链接必须指向存在的文件另有自动化测试dart test test/validate_skills_test.dart。dev/tools/skills_lint.yaml 将这三条规则全部设为error级别作用目录为.agents/skills.agents/skills/skills_lint_ignore.json 则为find-release的 SKILL.md 保留了check-relative-paths的豁免记录。值得注意的是natural-writing 文档自身的行文即遵循它规定的风格全小写引导短语、*标准列表、直引号、每个规则配 bad/good 对照、结尾停在最后一个事实上。从源码结构看这正是 .agents/skills/README.md 推荐实践中指令越严格、越结构化agent 遵循效果越好这条经验的具体体现。【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考