Files
Endorphin-Document/authoring/tasks/TASK-01.md
T

1.9 KiB

TASK-01 局部修改

适用:错字、术语、链接、句子清晰度,以及不改变规则的短段修订。输出是范围明确的修正及必要的关联更新。

必读:DOC-017、DOC-021。涉及句子重写时查中文表达。

先判断是否真是局部修改

表面请求 实际判断
把阶段名称统一大小写 查主定义后替换相关术语,保留代码中不同含义的普通名称
把“可以”改为“必须” 可能改变语义,转 TASK-06
修正一个坏链接 找到原链接应支持的定义,不能只链接任意存在的页
把所有同名文本替换掉 先区分正文、源码、URL、引用、历史记录与有意反例
简化一段“太啰嗦”的说明 保留影响合法性、提案状态和结果的必要条件

执行

阅读目标段落及其前后小节,找到术语或行为的主定义。用编辑器的全文搜索查看同一问题在正文、附录与手册中的出现位置;命中项逐一判断,不自动全替换。

修正文句时先写出原句要表达的断言,再用更直接的句子表达。若断言本身不清楚,不能只润色后继续保留。链接变更检查目标锚点是否仍说明原来的主题。

修正后比较语义强度、范围、条件和例外是否改变。只改措辞时,不顺手移动整章或改写其他正确例子。

验收与常见误判

全文检索用于确认相同错误残留,不要求所有相似字符串消失。例如手册中明确标注的错误写法可以保留;来源原题、历史提交名不属于语言术语迁移。

人工核对结构、链接目标与修改前后断言;程序检查仅在用户明确要求时执行。交付说明改动词句的用途、关联更新及是否涉及语义。

任务入口