关于 sasha
用于俄语界面文案、营销内容和文档写作的技能,按文本类型提供撰写、审阅与编辑指引,并强调清晰表达和事实准确。
主要功能
- 01识别界面、营销和文档语境
- 02俄语界面及营销文案指引
- 03保留事实的文档编辑
- 04审阅与生成输出格式
- 05提取文本和检查文案的脚本
适用场景
- 01审阅俄语界面文本
- 02撰写营销活动和推广文案
- 03编辑俄语用户或技术文档
- 04查找候选界面字符串及文案警示
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mishanaer/ deslop --skill sasha安装后在 Claude Code 中输入/sasha确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/01-principles.md02-components.md03-errors.md04-typography.md05-code-review.md06-examples.mdrules.jsonscripts/extract_ui_strings.pyui_text_lint.pytests/test_ui_text_lint.py详细介绍
sasha
适用范围
- 仅用于俄语界面文案、营销文案和文档。
- 落地页、产品页、广告、推广邮件、营销活动消息和推广类社交媒体帖子均视为营销文案。
- 用户指南和技术指南、说明、README 文件、帮助内容、API 参考和内部流程均视为文档。
- 不要仅因任务或对话中包含俄语就触发。
- 排除普通回答、解释、讨论、往来信件、会议记录、编辑类文章和支持回复,除非相关文本属于界面、营销活动或文档集的一部分。
核心原则
- 文本必须帮助用户完成当前任务。
- 与其解释薄弱的界面,不如删除不必要的文案或改进 UI 结构。
- 用语直白、具体、中性。
- 优先呈现重要事实或操作。
- 不要用笑话、夸张宣传、过度道歉或含糊的积极措辞来淡化坏消息。
- 对于错误,说明发生了什么、用户可以做什么,以及已知的后续情况。
- 可点击控件的文案通常应描述用户要执行的操作。
- 标签和占位符通常应标明数据,而非输入操作。
- 工具提示和提示信息用于补充背景;必需信息应显示在屏幕上。
- 将涉及法律风险的 UI 文案视为受约束内容:提供备选方案,并在含义可能发生变化时标注
needs legal review。 - 对于文档,保留事实含义、命令、示例、链接和标识符。不要臆造产品行为;指出缺失或相互冲突的信息来源。
工作流程
- 判断上下文:
interface、marketing或documentation。对于界面文案,识别组件类型;对于营销文案,识别形式和投放位置;对于文档,识别文档类型和权威信息来源。 - 明确用户要完成的任务:用户已知什么、预期执行什么操作,以及接下来会发生什么。对于营销文案,还要明确受众、优惠、渠道和可验证的说法。对于文档,要明确受众、前提条件、任务和预期结果。
- 判断文案是否是正确的解决方式。如果真正的问题在于布局、状态、可操作性、验证、组件选择、文档结构或缺少事实背景,应指出这一点。
- 按以下顺序应用规则:用户任务、格式模式、事实准确性、清晰度、简洁性、中性语气、排版、i18n 安全性。
- 修改代码时,只更改用户要求的 UI 字符串或文档文件,除非用户明确要求修改组件或实现。
代码编辑规则
- 首先检查项目:包管理器、本地化格式、组件框架和现有命名约定。
- 保留本地化键,除非某个键明显有误且用户同意修改。
- 保留变量和格式语法:
{name}、%{count}、{{value}}、ICU 复数/选择语法、JSX 插值、HTML 实体、Markdown 链接和转义字符。 - 不要大幅改写法律文案。应改为添加说明。
- 如有帮助,可运行
scripts/extract_ui_strings.py查找候选字符串,并运行scripts/ui_text_lint.py获取启发式警告。 - 如果从锁文件或脚本中能明显看出可用的项目检查命令,请运行这些检查。
审核输出
对于审核任务,请具体说明发现,并按类别分组:
## Критичные проблемы
- ...
## Замечания sasha
- ...
## Типографика
- ...
## Предложенная версия
| Было | Стало | Почему |
|---|---|---|
| ... | ... | ... |
## Что проверить отдельно
- ...
对于小型审核,省略空白章节。
生成输出
对于界面文案生成任务,返回 2-4 个选项:
Безопасный:适合生产环境的清晰默认选项。Короткий:适用于空间紧张的 UI。Более явный:需要明确说明后果时使用。Для узкого места:仅在字符空间可能受限时使用。
然后说明推荐选项,并用一两句话解释原因。
对于营销文案,在有必要提供备选方案时返回 2-3 个版本。对于文档,除非用户要求提供多个版本,否则只返回一个推荐版本。
参考资料
- 阅读
references/01-principles.md,了解通用的 UI 文案判断原则。 - 阅读
references/02-components.md,了解组件专属模式。 - 阅读
references/03-errors.md,了解错误状态和恢复文案。 - 阅读
references/04-typography.md,了解俄语 UI 排版和安全规范化处理。 - 在编辑本地化文件或代码中的字符串之前,阅读
references/05-code-review.md。 - 阅读
references/06-examples.md,快速了解修改前后的示例。 - 将
references/rules.json用作脚本或审查的机器可读规则集。
脚本
scripts/extract_ui_strings.py 用于从 .json、.yml、.yaml、.ts、.tsx、.js、.jsx 和 .vue 文件中提取可能的俄语 UI 字符串。
python3 sasha/scripts/extract_ui_strings.py src/locales/ru.json --format json
python3 sasha/scripts/extract_ui_strings.py src --include '*.tsx' --format md
scripts/ui_text_lint.py 会报告启发式的 sasha 警告。请将结果视为审查提示,而非绝对结论。
python3 sasha/scripts/ui_text_lint.py src/locales/ru.json
python3 sasha/scripts/ui_text_lint.py src --format json --component button
评论
支持 Markdown