writing-clearly-and-concisely
Пишите ясно с классическими правилами Странка
متاح أيضًا من: softaworks
Превратите неясный текст в четкий, профессиональный текст. Этот навык применяет вечные принципы Странка, чтобы сделать вашу документацию, сообщения и объяснения более понятными и эффективными.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "writing-clearly-and-concisely". Реализация новой функции была завершена командой разработки своевременно.
النتيجة المتوقعة:
- Версия с активным залогом: 'Команда разработки реализовала новую функцию вовремя.'
- Более кратко: 'Команда выпустила функцию по расписанию.'
- Наиболее прямо: 'Мы выпустили вовремя.'
استخدام "writing-clearly-and-concisely". Важно отметить, что тот факт, что этот код имеет баг, должен быть принят во внимание.
النتيجة المتوقعة:
- Прямая версия: 'В этом коде есть баг.'
- Активный залог: 'Мы нашли баг в этом коде.'
- К действию: 'Исправьте баг в этом коде.'
استخدام "writing-clearly-and-concisely". В логах было обнаружено большое количество ошибок.
النتيجة المتوقعة:
- Конкретно: 'Мы нашли много ошибок в логах.'
- Конкретно: 'В логах было 47 ошибок.'
- Прямо: 'Логи содержат ошибки.'
التدقيق الأمني
آمنAll 70 static findings are false positives. The skill contains only public domain text (Strunk's Elements of Style, 1918) and skill metadata. No executable code, network calls, file system access, or environment variables. Static scanner misidentified markdown table syntax and writing terminology as security threats.
عوامل الخطر
📁 الوصول إلى نظام الملفات (2)
🌐 الوصول إلى الشبكة (1)
⚙️ الأوامر الخارجية (4)
درجة الجودة
ماذا يمكنك بناءه
Пишите лучшую документацию
Применяйте принципы ясного письма к файлам README, документации API и комментариям к коду для улучшения опыта разработчиков.
Улучшайте технические объяснения
Используйте правила Странка, чтобы сделать сложные технические понятия доступными и интересными для читателей.
Улучшайте командную коммуникацию
Пишите более понятные сообщения коммитов, описания pull-запросов и объявления команды, которые понятны всем.
جرّب هذه الموجهات
Пожалуйста, просмотрите этот текст и примените принципы Странка, чтобы сделать его более понятным и кратким: [вставьте ваш текст]
Помогите мне переписать эту техническую документацию, используя правила Странка. Сосредоточьтесь на активном залоге, конкретном языке и удалении лишних слов: [ваша документация]
Примените принципы Странка, чтобы сделать это сообщение об ошибке более понятным и полезным для пользователей: [текст сообщения об ошибке]
Проанализируйте этот текст, используя "Элементы стиля" Странка. Определите конкретные нарушения правил 10-18 и предложите конкретные улучшения: [ваш текст]
أفضل الممارسات
- Читайте полный файл elements-of-style.md при написании важного текста для максимального эффекта
- Используйте субагентов для редактирования, когда контекст ограничен, чтобы сэкономить токены
- Применяйте 6 правил Орвелла как легкую альтернативу, когда ресурсы ограничены
تجنب
- Не применяйте эти правила к синтаксису кода или конфигурационным файлам
- Избегайте чрезмерного редактирования разговорного текста, где естественный поток важнее
- Не жертвуйте технической точностью ради стиля - уточняйте, а не упрощайте