ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Avoid AI Writing 技能的双轴配置体系:Context 与 Voice Profiles 实战指南

Avoid AI Writing 技能的双轴配置体系:Context 与 Voice Profiles 实战指南 Avoid AI Writing 技能的双轴配置体系Context 与 Voice Profiles 实战指南【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents导读本篇文章围绕avoid-ai-writing插件中 profiles.md 这一核心参考文档展开系统讲解其上下文画像Context Profiles语气画像Voice Profiles双轴配置体系前者决定对一篇文本管得多严后者决定改写后的文风听起来如何。读完本文你将掌握 6 种上下文画像的适用场景、自动检测信号、按规则划分的容差矩阵以及 5 种语气画像的量化改写目标并能将该技能接入对 README、Changelog、PR 描述、技术博客等各类文本的去 AI 味审校与改写流程。该技能定位为一个纯 Markdown 的审计与改写技能用于让文本不再读起来像机器生成覆盖 README、Changelog、发布说明、PR 描述、文档、博客与社媒文案见 README.md。它明确不承担作者身份分类职责所有标记只作为写作质量信号绝不用于学术诚信、招聘或署名判定依据见 SKILL.md。双轴模型严格程度 × 声音profiles.md 开篇给出了整个配置体系的第一性原理两个相互独立的轴。上下文画像context profile设定针对某类受众的严格程度语气画像voice profile设定散文听起来的样貌。对博客写得直白blunt、对文档写得温暖warm都是完全合法的组合——两轴解耦意味着任何上下文画像都可以与任何语气画像搭配而不会产生配置冲突。在实际调用中上下文画像通过--context参数显式指定语气画像通过--voice参数指定两者均可省略并交由技能自动推断。Context Profiles六种上下文画像profiles.md 定义了六种上下文画像每一种对应一类典型写作场景与受众预期画像定位核心说明linkedin短形式社媒追求冲击力的短片段落视觉化排版比长句更重要blog默认画像标准长文散文每条规则满强度执行technical-blog含代码的长文涉及代码、架构、API技术术语获得豁免investor-email高信任受众全面收紧营销语言是最大风险点docs文档/README/指南清晰度优先于个性声音casual聊天/内部笔记只处理最严重的违规项关键设计点是blog作为默认值当没有足够信号推断其他画像时所有规则以满强度生效这保证了审校的保守安全底线。上下文自动检测无信号时的推断规则当调用方未指定上下文时技能根据文本自身信号推断画像并必须说明推断依据与推断出的画像作者有权覆盖。profiles.md 给出的推断信号表如下信号推断出的上下文不足 300 词且含话题标签或 提及linkedin含代码块、API 引用或架构内容technical-blog有称谓且含投资者/融资语言investor-email分步说明、参数文档、README 结构docs无强信号blog最安全的默认值这条表与 SKILL.md 中的审计流程第一步挑选上下文画像——询问或从文本推断直接呼应整个技能在任何模式下都要求先确定画像再依画像容差执行规则。容差矩阵每一条规则的画像级裁剪这是 profiles.md 的技术核心。表中缺席的规则在所有画像下满强度生效Skip表示该规则对该语域不适用Extra strict表示连临界情况也要标记——例如投资邮件中出现一个 thriving ecosystem 就足以削弱整条信息的可信度。完整矩阵如下规则linkedinblogtechnical-bloginvestor-emaildocscasual破折号Em dashes宽松每帖 2 个可接受严格严格严格宽松跳过过度加粗宽松加粗钩子可接受严格严格严格宽松跳过标题中的 Emoji宽松行尾 1-2 个可接受严格严格严格跳过跳过过度使用列表跳过LinkedIn 上列表有效严格宽松技术列表可接受严格跳过列表即文档跳过含糊措辞Hedging严格严格宽松技术语境中 may 是准确的严格宽松跳过词汇表完整清单严格严格部分见下文严格宽松仅 P0营销语言宽松社媒允许一定推销严格严格额外严格严格跳过意义膨胀Significance inflation严格严格严格额外严格宽松跳过系动词回避Copula avoidance跳过严格宽松严格跳过跳过段落长度均匀跳过短形式严格严格严格宽松跳过编号列表膨胀宽松严格宽松严格跳过跳过反问句宽松1 个钩子可接受严格严格严格严格跳过过渡短语跳过短形式严格严格严格宽松跳过泛泛结论跳过严格严格额外严格跳过跳过话题标签堆砌严格严格严格额外严格跳过文档无标签跳过名词短语裸列表严格严格宽松技术选项列表可接受严格宽松参数列表可接受跳过三级词聚类严格严格严格额外严格宽松跳过未来叙事结尾严格严格严格额外严格跳过跳过社媒背书结尾严格LinkedIn 分享帖标志严格严格严格跳过宽松私信中 1 个可接受模糊措辞堆叠预测严格严格宽松could 是模糊化的准确表达额外严格宽松跳过Real/actual 强化词膨胀严格严格严格额外严格宽松跳过道德形容词类别错误严格严格宽松严格宽松跳过编造对比对镜像严格严格宽松严格宽松跳过无主语片段与无施事被动宽松短形式片段即语域本身严格宽松严格跳过片段列表即文档跳过矩阵还附带两条结构性说明其一墙式文本回复wall-of-text replies的触发规则位于 pattern 本身而非本表——它只在对话式回复语域中触发而一条普通 issue 评论会自动检测为blog因此判断权归于规则本身见 pattern-catalog.md 中Conversational-register tells一节其二profiles.md 明确缺席即满强度这与 word-tiers.md 中docs放松整张词汇表、casual只保留 P0 模式的上下文调整规则互相印证。Technical-blog 词汇豁免例外technical-blog 画像为一批本身携带正当技术含义的词开出豁免在技术语境中不再标记robust、comprehensive、seamless、ecosystem、leverage当主语确指平台杠杆或 API 时、facilitate、underpin、streamline。但以下词即使在该画像下仍会被标记delve、tapestry、beacon、embark、testament to、game-changer、harness。这一豁免清单与 word-tiers.md 末尾的 Context adjustments 一节完全一致构成跨参考文档的同一套规则。Voice Profiles五种语气画像语气是可选的。未指定时技能从输入推断语域并避免把人格强加给已有声音的文本。关键约束是每个画像都是一组具体目标而非氛围——目标决定什么能在编辑后存活但绝不授权添加源文本不具备的立场、个性或事实SKILL.md 中的改写护栏rewrite guardrails同样约束此处。画像具体目标适用场景casual全文使用缩约形式缺失会显得生硬短句平均不超过 14 词允许片段保留源文本中的第一人称与具体细节但绝不新增近乎零术语保留温暖含糊语honestly、I think剔除企业腔its worth noting博客、社媒、社区写作professional多数句子用主动语态长短句交错源文本有具体主张数字、名字、日期时优先于 experts say源文本有明确请求则保留绝不编造事实或请求对含糊措辞容忍度低LinkedIn、投资邮件、pitchtechnical偏好朴素系动词X is Y而非膨胀替身serves as、stands as a testament to一句一个想法指令用祈使语气术语首次出现时定义即可表格与列表只用于内容真正呈列表形状之处文档、技术博客warm源文本已直接对读者说话时保持直接保留其致谢而非新增删掉强化词very、truly、incredibly改用更强的动词不用表演式共情开场中等句长 15–20 词营造从容节奏导师辅导、新人 onboarding、致谢blunt先抛结论再砍铺垫罕见破折号用句号制造强调不凑三段式近零含糊措辞标记 may / could / potentially 堆叠短陈述句偶尔搭配长句形成对比决策备忘录、思想领导力内容、严厉反馈校准到样本而非套用画像profiles.md 额外提供了一种高级用法给定作者自己的作品样本分析其句长模式、缩约率、段落开头方式与高频用词然后匹配这些特征而不是套用某个具名画像。同时明确不升级其词汇如果作者写 stuff 和 things就保留那个语域。这体现了整个技能去除机器味但不安装新口音的核心哲学——见 SKILL.md 中Rewriting without installing a new accent一节所列的禁止项虚假第一人称、制造事态、被迫反叛、表演式坦诚、破折号戏剧、碎片化转换、编造具体细节。双轴如何组合两轴组合遵循三条规则语气目标始终生效——即使某上下文画像对该类别标记为 Skip语气画像仍会管到它。例如在忽略系动词回避的 casual 上下文中technical 语气依然偏好朴素系动词。两轴同管一条规则且一致时相互强化。两轴冲突时取更严格者——warm 语气搭配docs上下文依然不会得到装饰性表格。profiles.md 同时给出了推荐默认配对casual×casual、professional×linkedin 或 investor-email、technical×docs 或 technical-blog。这套组合规则让画像系统在实际使用中可预测、可组合不会因语气偏好而突破上下文的安全边界。画像在实际审计流程中的位置画像不是孤立的配置项而是技能五步审计流程的入口见 SKILL.md选择上下文画像——询问或从文本推断并说明所用画像扫描 P0/P1 模式——依据 pattern-catalog.md 的严重度分级P0 可信度杀手、P1 明显 AI 味、P2 打磨项每个标记都要引用原文对照词汇表——依据 word-tiers.md 的三级词表Tier 1 默认替换、Tier 2 同段两个才替换、Tier 3 高密度才标记应用所选上下文画像的豁免最后检查节奏并给予最高权重——结构规律性句长均匀、段长均匀、对称措辞比任何单个词都更重要改写后重读自己的改写——回收式过渡、系动词回避和新的膨胀词常在首轮幸存。画像同时影响三种运行模式rewrite / detect / edit的输出detect 模式要求区分清晰问题与判断项并单独报告 Tier 1AAI 频率标记与 Tier 1B清晰度编辑两个频段——1B 仅是好的写作不是机器作者身份证据。命令层面对应的显式参数为--mode rewrite|detect|edit、--voice casual|professional|technical|warm|blunt、--context linkedin|blog|technical-blog|investor-email|docs|casual、--file PATH与--iterate NN 为总遍数、含内置纠错遍、上限 2。延伸阅读SKILL.md三种模式、审计流程、改写护栏、转义通道与输出格式pattern-catalog.mdP0/P1/P2 模式目录格式、句式、开头过渡结尾、膨胀、可信度、对话语域、社媒、机器指纹、节奏word-tiers.md112 个词条三级词表与 10 个样板短语README.md技能范围、披露信息与可移植性说明纯 Markdown、无工具调用、技能正文保持在 Codex 8 KB 上限内【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进