SuperAPI AI 工具集

plain-voice

通用与其它

查看项目

更新于 10-15 19:56

技能介绍

用途:plain-voice 面向没有参与工作的读者,要求交付物直接给出决定、结论或遗漏,再附证据,不写表演性内容。规则适用于所有交付物,其中机械性规则由 agentic-sdlc lint-voice 检查,署名规则由钩子和 CI 检查在安装插件或工作流处执行,其他环境以文本本身为准。决定者指批准并放行的角色,而非具体个人。

主要能力:VOICE-1 首行给决定、结果或遗漏;VOICE-2 只写当前状态,不叙述旧版本、不在正文写版本或分支标签;VOICE-3 不用破折号作标点;VOICE-4 不用三段式、计数框架、因果套话或格言式结尾;VOICE-5 内容结束即结束,不加收尾提议;VOICE-6 禁用 seamless、robust、leverage 等词;VOICE-7 删除“值得注意的是”等前言;VOICE-8 证据词须有证据支撑;VOICE-9 未决点保持开放,写明选项、决定者与期限;VOICE-10 遗漏按遗漏报告;VOICE-11 共享交付物只谈技术,不点名个人;VOICE-12 决定者原话照用;VOICE-13 草稿不承诺签署者未说的话。ATTR-1 禁止在变更文本中出现工具署名,ATTR-2 可通过 .agentic-sdlc.json 开启严格模式。

使用方式:运行 agentic-sdlc lint-voice README.md docs 报告 VOICE-3 至 VOICE-8 的机械规则及文件行号;--fail-on fail 使硬性规则失败、对套话和证据词仅警告;必须引用禁用词的行可在 HTML 注释中加 voice-lint: skip。变更描述首行用简短祈使句,正文说明改了什么、为什么及有意省略什么。

适用场景与限制:适用于提交信息、PR、评审、工单与仓库文档。写作上建议一句一个想法、约二十词、含动词,短不等于省略;数字与测量仅在影响读者行动时用短表或独立行;约五百词以下的消息不加标题,以上最多三个;标题用句首大写、直引号、无装饰性 emoji。资料未提供具体安装步骤、收费与平台信息。