Asd Ste100 Zh

中文技术清晰写作（ASD-STE100 原则适配）

源自 danyuchn/asd-ste100-skill，基线版本 0.4.0，提交 7d4a135a199a5d7447c4886bcd7ffe742a627bc9。上游版权与 MIT 许可见 LICENSE。本项目是独立中文清晰写作适配，不是 ASD 官方中文标准、认证翻译或 ASD-STE100 符合性保证。

语言与适用范围

默认输出中文，适用于技术说明、操作步骤、技术报告、错误信息和工具描述，也可用于工程任务汇报。用户明确指定输出语言时，遵循该要求。不要擅自翻译代码、命令、路径、标识符、产品名称、英文原文引用或指定保留的英文片段；解释文字可用中文。领域术语有通行中文译法时可使用，必要时首次附英文；同一概念保持同一名称，不把不同概念合并成同一个词。

中文或中英混合输出使用本文件的中文规则与流程。仅当用户明确要求纯英文改写时，读取 references/english-writing.md。英语词数、词性、时态、短语动词和受控词典限制不适用于中文，不把 20 words 换成 20 个汉字。英文分支也不能保证官方 STE 合规。

默认自然简洁，以消除歧义为目标，不逐句机械套用规则。操作说明和安全文本需要更严格地检查条件、动作和风险。规则按当前写作任务应用，不因一次调用接管后续整个会话；用户指定的格式与范围优先。

中文改写规则

• 先理解原意，再简化表达。保留事实、条件、否定、范围、例外、顺序、比较关系、数值、单位和标识符。没有依据时，不补充原因、频率、机制或操作。
• 明确谁做什么，优先使用直接动词，例如“检查日志”，而不是“进行日志的检查”。原文未说明执行者时，不凭空指定；能从上下文确定才补全。
• 每句集中表达一个动作或主要判断。必要条件写在对应动作前，例如“仅当备份完成且校验通过时，才删除源文件”。拆句时保留“且 / 或 / 仅当 / 除非”等逻辑关系，避免把条件写成无条件命令。
• 把风险与禁止事项放在相关操作前。保留风险的严重性、发生条件与可能性；不得为简短而删除安全限制。原文缺少必要安全条件时，标明缺失，不编造安全操作规程。
• 保留要求强度和置信度：“必须 / 不得”“应当 / 建议”“可以”“可能 / 通常 / 已确认”各有含义。不要把“应当”改成强制命令，把“可能”改成必然，或把“可以”改成“必须”。只有同义且不损失信息时才删除重复缓和语。
• 使用准确、常用的词；必要专业术语保留并按读者需要解释。不要为了口语化而换掉有特定技术含义的名称。保留表达时间、状态和不确定性所需的“已 / 正在 / 将 / 曾”等信息。
• 一段集中讨论一个主题。多步骤操作按执行顺序列出；并列条件保持其组合关系。优先拆开过密句子，但不设机械字数上限；中文分号并非一律禁止。精度优先于短句。
• 删除没有信息的套话；不要把未量化的评价改写成凭空编造的指标。对不清楚的原文，保留歧义并指出需要澄清的关键点，不猜测作者想法。

中文流程与输出

1. 阅读原文，确认主体、动作、条件、风险、范围和要求强度。写作任务以用户提供的事实为依据。
2. 按中文规则改写。参考 examples/before-after.md 的示例。
3. 将改写逐项对照原文，检查事实和逻辑是否保留，特别是条件的作用范围、否定、例外、数值单位、引用和置信度。仅靠词匹配不能完成这一步。
4. 改写任务默认只输出可直接使用的中文正文。不添加模式说明、违规数量或“合规 / PASS”结论。原文已经清楚时，保留原文；若用户询问检查结果，可说明无需修改。
5. 必须保留较长表达以避免信息损失时，可在正文后加一行“保留说明：……”。存在阻碍准确改写的歧义或缺失信息时，简短说明问题；必要时向用户澄清。
6. 用户要求对比或解释时，用“调整依据 / 原文 / 改写”表格说明中文规则与具体变化，避免宣称违反了官方中文 STE 规则。用户要求补充建议时，把新增建议明确标为建议，与原文改写分开。

工程任务汇报

汇报代码改动、排查结果或验证情况时，使用以下规则。正文改写不自动套用汇报结构。

• 结果先行：首句说明结果或当前结论，再给关键依据。进度更新直接说明当前工作和待解决的问题，不提前声称完成；用户要求过程时按需解释。
• 分开说明改动与验证：修改了文件不等于功能通过验证，局部检查不等于端到端通过。给出支持主要结论的实际检查方法、结果和适用范围；未执行或失败的关键检查说明原因或相关错误。
• 证据可定位：按需要提供文件位置、命令、提交号或来源链接。只使用实际读取或执行得到的信息，不补造测试数量、行号或检查结果，也不要求每句话重复验证标签。
• 状态准确：可使用“已完成”“部分完成”“未验证”“失败”等词，也可自然地写“已修复”。词语必须符合证据；存在影响交付的未完成事项时，直接说明事项与影响。无需固定状态词表或空栏目。
• 区分不确定性：事实尚未核实时，说明未知点和必要的核实方式；有依据的概率、范围与建议强度仍按原意保留。“可能发生”不等于“事实未确认”，不要用统一标签取代概率或推测内容。
• 需要用户决定时，清楚列出可选动作和主要后果；多项选择可编号，有充分依据时给出推荐。仅在缺少关键输入或确需授权时请求决定，写作格式本身不构成额外确认要求。

简短任务用一段话即可。复杂任务可按“结果、改动、验证、未完成事项”组织，省略无内容的部分。需要具体写法时，读取 examples/result-report.md。

此部分参考 dualface/ste-zh 的结论先行、验证证据和汇报结构思想，按本技能的信息保真原则独立编写。

工具与标准边界

scripts/ste-lint.py 仅是英语启发式检查器，不检查中文语义或中文合规性。含汉字输入的 CLI 检查会返回退出码 2（未检查），英文片段需单独提取后检查。其 lint() 内部函数仍是上游英语算法，不是中文检查接口。纯英文返回 0 也只表示配置的英语结构检查未发现硬问题，不代表保真、词典检查或官方符合性。不要为中文自动生成合规证书。

本仓库不提供官方规范全文或受控词典。MIT 覆盖本仓库可许可的代码与说明，不授予 ASD 官方规范、词典、PDF 或第三方材料的再分发权。需要官方符合性时，使用从官方合法取得的标准和适当的人工评审。