SuperAPI AI 工具集

orbitant-tone

通用与其它

查看项目

更新于 10-16 06:44

技能介绍

用途:这是 Orbitant 博客内容的语气与风格参考,面向任何创建或审阅博客内容的人——人类撰稿者或内容生成智能体。它定义 Orbitant 的写作方式,而非具体工具功能。

主要原则:一,始终使用第一人称,写自身经历;“我”用于亲身经历、决定或所学,“我们”用于代表公司发言,绝不用第三人称写自己的工作。二,多用真实案例而非抽象理论,每个论断都应落在具体项目、决定、失败或结果上,先举例再讲原则。三,解释技术决策背后的原因,说明为何选此方案、排除了什么、接受了哪些权衡。四,实践优先于理论,能展示就展示,代码片段、配置示例、录屏、标注截图比三段说明更有价值,理想结构是:陈述问题或决定、展示方案、解释要点与原因。五,诚实面对权衡与错误,承认没起作用的地方与限制,不夸大方案。

多声部内容:许多文章源自 Slack 讨论或 KS 会议等群体对话。规则是一篇文章一个署名者,用第一人称单数;署名者是对话发起人或最资深参与者,其他人的贡献以散文式归属呈现,格式为:背景句→归属短语(姓名+职能角色)→该人实际观点(按需转述或引用)。用姓名与职能角色标识,如软件工程师、软件架构师、DevOps 工程师、工程经理、QA 工程师,不用职级(Senior、Junior、Lead)。可偶尔把一句难忘的话提为视觉引用块,但内容仍以正文为准。

避免的写法:不写宣传册式内容去推销 Orbitant;不保持中立,要有观点并解释偏好;不正式,不用“usted”、公司被动语态等套话;不写理想世界,只写实践中如何运作。需避免的词与模式包括“con honestidad”“provocador/a”“en el mundo actual”“es crucial/fundamental”“sin duda”“hoy en día más que nunca”以及可用西语替代的英语词如 el why、el approach、el timing 等。有既定西语对应词的技术英语术语(framework、pipeline、deployment、token、clean code、contract testing)保留英文并斜体。

标点注意:西班牙语破折号只用于双侧插入语,即开合成对的 inciso;单侧破折号是英语式用法,不应出现。续接用冒号或句号,列举用列表或“x, y, y z”。

提及 Orbitant:可以出现,但作为背景而非主体,主体始终是技术问题、决策或经验。

资产:技术资产是优先项而非可选项。配置步骤用代码片段,UI 流程用标注截图或短录屏,前后对比用并排代码块,系统输出用截图或代码输出块,多步流程用编号列表,架构与流程用 Excalidraw 图,决策树或方案比较也用 Excalidraw 图。Orbitant 账号已将 Excalidraw 接入 Claude,便于直接生成与迭代图。若写作时无法加入资产,在草稿中按指定格式留 NOTE FOR AUTHOR 说明缺失资产及价值与建议类型。

限制:以上为写作风格规范,未提供该技能的安装方式、命令、价格、平台支持或技术实现细节。