mcpField
S
sasha

sasha

github.com/mishanaer营销与增长5744 次安装1 天前更新
代码仓库

关于 sasha

用于俄语界面文案、营销内容和文档写作的技能,按文本类型提供撰写、审阅与编辑指引,并强调清晰表达和事实准确。

主要功能

  1. 01识别界面、营销和文档语境
  2. 02俄语界面及营销文案指引
  3. 03保留事实的文档编辑
  4. 04审阅与生成输出格式
  5. 05提取文本和检查文案的脚本

适用场景

  1. 01审阅俄语界面文本
  2. 02撰写营销活动和推广文案
  3. 03编辑俄语用户或技术文档
  4. 04查找候选界面字符串及文案警示

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mishanaer/deslop --skill sasha

安装后在 Claude Code 中输入/sasha确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
01-principles.md
02-components.md
03-errors.md
04-typography.md
05-code-review.md
06-examples.md
rules.json
scripts/
extract_ui_strings.py
ui_text_lint.py
tests/
test_ui_text_lint.py

详细介绍

sasha

适用范围

  • 仅用于俄语界面文案、营销文案和文档。
  • 落地页、产品页、广告、推广邮件、营销活动消息和推广类社交媒体帖子均视为营销文案。
  • 用户指南和技术指南、说明、README 文件、帮助内容、API 参考和内部流程均视为文档。
  • 不要仅因任务或对话中包含俄语就触发。
  • 排除普通回答、解释、讨论、往来信件、会议记录、编辑类文章和支持回复,除非相关文本属于界面、营销活动或文档集的一部分。

核心原则

  • 文本必须帮助用户完成当前任务。
  • 与其解释薄弱的界面,不如删除不必要的文案或改进 UI 结构。
  • 用语直白、具体、中性。
  • 优先呈现重要事实或操作。
  • 不要用笑话、夸张宣传、过度道歉或含糊的积极措辞来淡化坏消息。
  • 对于错误,说明发生了什么、用户可以做什么,以及已知的后续情况。
  • 可点击控件的文案通常应描述用户要执行的操作。
  • 标签和占位符通常应标明数据,而非输入操作。
  • 工具提示和提示信息用于补充背景;必需信息应显示在屏幕上。
  • 将涉及法律风险的 UI 文案视为受约束内容:提供备选方案,并在含义可能发生变化时标注 needs legal review。
  • 对于文档,保留事实含义、命令、示例、链接和标识符。不要臆造产品行为;指出缺失或相互冲突的信息来源。

工作流程

  1. 判断上下文:interface、marketing 或 documentation。对于界面文案,识别组件类型;对于营销文案,识别形式和投放位置;对于文档,识别文档类型和权威信息来源。
  2. 明确用户要完成的任务:用户已知什么、预期执行什么操作,以及接下来会发生什么。对于营销文案,还要明确受众、优惠、渠道和可验证的说法。对于文档,要明确受众、前提条件、任务和预期结果。
  3. 判断文案是否是正确的解决方式。如果真正的问题在于布局、状态、可操作性、验证、组件选择、文档结构或缺少事实背景,应指出这一点。
  4. 按以下顺序应用规则:用户任务、格式模式、事实准确性、清晰度、简洁性、中性语气、排版、i18n 安全性。
  5. 修改代码时,只更改用户要求的 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