Yila-AI/awesome-defensive-writing / skills/yila-clear-writing
yila-clear-writing
VerifiedDiagnose and revise AI defensive padding in drafts, reports, emails, research prose and public explanations when the user requests less hedging or clearer claims. Preserve evidence strength and meaningful reader guidance.
references/technical-zh.md
View on GitHub# 教学与技术说明
[English](technical-en.md) | **简体中文**
选择任务,复制提示词,填入自己的材料;点击案例查看输入事实、修改结果与理由。
## DW-043 · 新手教程
将给定材料写得清楚、直接、有信息量。
以读者需要知道的判断或行动为主线,
删除重复退让与空泛铺垫。
事实、数字、范围、责任与承诺性质以材料为准;
真实条件放在对应结论旁。
缺失的关键事实单列待确认。
任务:按输入材料写最短可完成路径,
保留前置条件、预期现象和失败时下一步。
删说教铺垫,
不把简洁做成省略关键步骤。
输出:教程:前提、步骤、完成检查、失败后的下一步。
输入材料:
任务:[填写]
环境:[填写]
步骤:[填写]
常见失败:[填写]
相关案例:EX-15,见 examples-zh.md
## DW-044 · 安装说明
将给定材料写得清楚、直接、有信息量。
以读者需要知道的判断或行动为主线,
删除重复退让与空泛铺垫。
事实、数字、范围、责任与承诺性质以材料为准;
真实条件放在对应结论旁。
缺失的关键事实单列待确认。
任务:保持已验证的命令、版本、作用范围和顺序,
解释用户需要的动作。
删除泛泛风险堆叠,
不修改命令来显得简单;
未验证环境标清。
输出:安装步骤:环境与范围、原命令、完成检查。
输入材料:
已验证步骤:[填写]
版本:[填写]
环境:[填写]
安装范围:[填写]
相关案例:EX-15,见 examples-zh.md
## DW-045 · 故障排查
将给定材料写得清楚、直接、有信息量。
以读者需要知道的判断或行动为主线,
删除重复退让与空泛铺垫。
事实、数字、范围、责任与承诺性质以材料为准;
真实条件放在对应结论旁。
缺失的关键事实单列待确认。
任务:用症状、可观察证据、判断和下一步组织。
将确定原因与假设分开;
避免一上来归因用户操作或要求重装,
不省略数据保护条件。
输出:排查表:症状、已观察证据、当前假设与下一步检查。
输入材料:
症状:[填写]
日志:[填写]
环境:[填写]
已尝试步骤:[填写]
相关案例:EX-15,见 examples-zh.md
## DW-046 · SOP 与前提
将给定材料写得清楚、直接、有信息量。
以读者需要知道的判断或行动为主线,
删除重复退让与空泛铺垫。
事实、数字、范围、责任与承诺性质以材料为准;
真实条件放在对应结论旁。
缺失的关键事实单列待确认。
任务:保留顺序、单位、参数、禁止操作和适用条件,
只删不改变操作含义的重复说教。
否定限制不能仅改成不等价的正向建议;
未知条件标待确认。
输出:编号 SOP,
完整保留参数、前提、顺序和禁止事项。
输入材料:
原 SOP:[填写]
适用范围:[填写]
已确认参数:[填写]
相关案例:EX-16,见 examples-zh.md
## DW-047 · 代码评审意见
将给定材料写得清楚、直接、有信息量。
以读者需要知道的判断或行动为主线,
删除重复退让与空泛铺垫。
事实、数字、范围、责任与承诺性质以材料为准;
真实条件放在对应结论旁。
缺失的关键事实单列待确认。
任务:指出具体触发条件、可观察后果和最小修正建议,
区分功能问题与偏好。
删除模糊否定,
不编运行结果;
不为显得友好回避实际缺陷。
输出:评审意见:触发条件、后果、修正建议与实际验证状态。
输入材料:
差异:[填写]
相关上下文:[填写]
实际测试结果:[填写]
相关案例:EX-21,见 examples-zh.md
## DW-048 · 技术选型
将给定材料写得清楚、直接、有信息量。
以读者需要知道的判断或行动为主线,
删除重复退让与空泛铺垫。
事实、数字、范围、责任与承诺性质以材料为准;
真实条件放在对应结论旁。
缺失的关键事实单列待确认。
任务:按项目约束与同条件证据比较候选项,
给推荐和会改变结论的条件。
材料不足时给验证步骤;
不写所有技术都各有优劣就结束。
输出:候选项比较、推荐选择及会改变结论的条件。
输入材料:
约束:[填写]
候选项:[填写]
测量或文档:[填写]
维护条件:[填写]
相关案例:EX-22,见 examples-zh.md
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |