中文文档 AI 味重写待办清单
生成时间：2026-09-02。来源：第二轮全站句子级扫描（104 篇全覆盖）。 第一轮已完成的 17 篇重写见文末”已完成记录”。
改写原则
- 面向中文用户的产品化表述，专业、对用户友好的用词
- 只改文字表达，保留原有加粗、引号等强调标记；强调本身是空话营销时才连标记一起删
- 数据、命令、hash、链接、实验数字、Mintlify 组件不动
- 技术博客保留作者第一人称，只校对不改文风
- 先改中文，英文待用户确认后再动
P0 成片重灾区（整节改）
P1 中等（每篇约 5 处）
P2 句级点改（每篇 1-3 处）
直译词
- zh/cli/creator.mdx、zh/cli/bundle.mdx：“用户 CLI 表面”（surface）→“入口”；bundle 另有”薄确定性外壳”
- zh/cli/dashboard.mdx：“有界汇总”
- zh/cli/publish.mdx：“预设的心智模型”
- zh/cli/skill.mdx：“所有文件 IO 都沙箱化在”
- zh/cli/init.mdx：“事实源”（source of truth）
- zh/cli/doctor.mdx：“需要授权的项目修复”→“需要确认”
- zh/scripts/comet-handoff.mdx：“物理对接”
- zh/scripts/comet-archive.mdx：“稳定、确定性入口”、“悬在工作树”
- zh/scripts/comet-native.mdx：“会等待用户”
- zh/scripts/comet-state.mdx：“进入明确的工作目标后先执行”拗口定语
- zh/skill-creator/overview.mdx：“状态表面”、“负责……的确定性”、“确定性后端”
- zh/eval/eval-driven-evolution.mdx 残留：“一等评测对象”、长定语链（169 行）
- zh/eval/comet-native-clarification-experiment.mdx：“失败面”
- zh/eval/comet-native-vs-rc1-beta16-experiment.mdx：“噪声壳”、“经验性 trade-off”、“说明……参考值”动宾不搭
- zh/classic/configuration.mdx：“逃逸口”（escape hatch）、description 名词串
- zh/native/native-loop.mdx：标题”闭环式实现与验收”（第一轮漏改）
- zh/native/recovery-playbook.mdx:46：“从仓库中可以证明的状态”
- zh/native/scenarios/requirement-changes.mdx:141：“可证明仍然有效的事实”
- zh/native/scenarios/parallel-changes.mdx:101：“不会授权清理无关修改”
- zh/native/configuration.mdx:107：“不会替你授权 merge”
- zh/concepts/state-management.mdx：“失败关闭”待加 fail closed 注释、2 句名词串病句（83、93 行）
- zh/concepts/intermediate-artifacts.mdx：“SubAgent”与中文间缺空格×7
GPT 腔残留
- zh/concepts/native-workflow.mdx：“本质上”（33 行）、“换句话说”（43 行）、“确定性转发”（114 行）
- zh/concepts/intent-routing.mdx：224 行”换句话说”、87-88 行冒号格式残留
- zh/tech-blog/comet-0.4.0-rc1.mdx：开头三连排比、“恢复时丢失后”歧义、“不能授权提交”
- zh/eval/overview.mdx：“作为一个产品能力”、“信息性”独立成句
- zh/eval/quickstart.mdx:172 悬空句；zh/eval/agent-setup.mdx:253 悬空句
- zh/eval/harness.mdx:21”错误顺序”；zh/eval/runtime.mdx:100”Agent 候选”
- zh/eval/why-eval.mdx:84”实质深度”残留
格式与笔误
- zh/skill-creator/preferences.mdx:54：“只允许这四个 key”实列 5 个（事实错误）
- zh/skill-creator/publishing.mdx:34：draft hash 指代不清；224 行”确定性状态”
- zh/skill-creator/workflow.mdx:432：“常用命令”标题下无命令
- zh/presets/hotfix.mdx:223：“升级后绝不会自动归档”疑似笔误（本节讲归档必停）
- zh/phases/design.mdx:129：“你可能被要求手动压缩”
- zh/phases/archive.mdx:125：多层定语长句
- zh/home.mdx：“全面自动的Coding”、“Engineer驱动”、“更多的HITL”中英混排
- zh/tech-blog/index.mdx:14：“不止Skill”冒号与空格（与 beyond-skill 标题联动）
- zh/plugins/personal-memory.mdx:16：“一次性授权边界”；personal-memory-principles.mdx:110”授权边界”、59”规范化机器状态”
- zh/guides/state-recovery.mdx:8：“恢复真实事实”（ground truth）
- zh/guides/mid-workflow-changes.mdx 残留：129 行”将 phase 返回 design”、153 行”授权丢弃”
- zh/guides/classic-layout-migration.mdx 残留：description 状语错位、128 行”保留所有 Classic 事实”
- zh/guides/project-structure.mdx:6：Understanding…helps you 句式
- zh/guides/install-and-update.mdx:58：“不正确处理”否定错位
- zh/native/scenarios/document-driven-execution.mdx 结尾：“同一套可恢复、可验收的长程执行流程”抽象名词串
全局统一项
- “一等产物”（workflow/tweak/hotfix）vs”正式产物”（intent-routing）→ 统一为”正式产物”
- “归档授权”×5 → “归档批准”
- “实质深度”×3（why-eval/scoring/eval-driven-evolution）→ “是否有实质内容”
- “确定性”非固定搭配约 10 处、“授权”滥用约 8 处 → 逐句改自然表达
- 半角引号批量清理（prd-splitting、existing-project、resuming-workflow、0.3.9-to-0.4.0、baseline-experiment）；beyond-skill 的”他→它、的→地”
- 非文风问题：eval 4 篇（quickstart/agent-setup/harness/faq）代码块 Windows 路径双反斜杠
\\.comet\\eval\\.env，渲染会显示两个反斜杠，改单反斜杠
已完成记录（第一轮，2026-09-02）
- 整页重写：zh/overview.mdx
- 理念段落：concepts/intent-routing、context-compression、native-workflow、native/native-loop、native/scenarios/supervisor-change-delivery、eval/why-eval、eval/eval-driven-evolution、tech-blog/comet-vs-industry
- 直译句修复：cli/update、cli/resume-probe、guides/classic-layout-migration、guides/existing-project、changelog 0.3.x 段
- 格式清洗：guides/mid-workflow-changes（全篇标点）、guides/install-and-update（第 3 节）、native/faq（孤儿段落收进 Accordion）
- 全局：home 页 3 处、“失败闭合”→“失败关闭”统一、AGENTS.md 补“改写保留强调标记”规则
已完成记录（第二轮，2026-09-02）
- P0 六篇整节改写：concepts/faq、tech-blog/comet-beyond-skill（校对）、plugins/project-knowledge-principles、concepts/auto-transition（半角标点）、concepts/workflow、concepts/review-mode
- P1 十一篇中等改写全部完成（含 guides/resuming-workflow、prd-splitting、plugins/project-rules、eval/scoring、tech-blog/comet-0.3.9-to-0.4.0、eval/comet-baseline-experiment、plugins/agent-learning-loop、skill-creator/engine、concepts/decision-points、guides/existing-project）
- P2 直译词、GPT 腔、格式笔误全部处理（约 25 篇点改）
- 全局统一：“一等产物”→“正式产物”、“归档授权”→“归档批准”、“实质深度”→“是否有实质内容”、“制品”→“产物”、eval 四篇 Windows 路径双反斜杠改单反斜杠
- 复核修正三处过度弱化：scoring 恢复“产物是否有实质内容”加粗、workflow“按项目配置固定进入”、resuming-workflow“确定性保证”
- AGENTS.md 新增“AI 味与直译防护”和“亮点与强调保留（改写红线）”两节
- 本轮共 68 个文件，改后经 git diff 加粗短语对比复查，卖点句与强调标记无丢失
已完成记录（第三轮，2026-09-02）
- 四路并行全站复审（guides/presets/phases、concepts/native、cli/scripts/skill-creator/plugins、eval/tech-blog/门面页），共处理约 70 条问题
- 门面页（home/overview/quickstart）：Loop Engineering、HITL、Rubric/Pass@k、DAG、Rule/Router/Guard 等内部术语改为白话或首现加解释
- 重写 concepts/native-workflow“让 Skill 回归本质”一节（原 AGENTS 反例句）；清理 concepts 页内部标识符（CometIntentFrame、classic-state-command.ts、REQUIRED_CLASSIC_KEYS）
- 术语统一：machine-owned 首现加“由 Comet 自动维护”、tripwire→文件数阈值、stale pause→残留的暂停标记、dirty worktree→未提交改动、verbatim→原样写入、portable→可跨设备同步、canonical Spec→主 Spec、readiness→发布就绪状态、lane→创作通道（三名归一）、正文 artifacts→产物、事实来源→唯一可信来源/依据、冲突雷达→冲突检测
- 删除正文中的源码标识符（resolveSkill、reviewBundle、buildEvalArgs、manifests.py、compare_baselines.py 等），eval 入门页为 harness/treatment/analysis set/Judge 补中文解释
- 引号批量清理：guides/presets/phases 半角引号与 tweak 直角引号改中文弯引号
- AGENTS.md 术语对照表扩充（新增第三轮 12 个词条）并补“源码标识符不入正文”规则
- 复核修正：首页被误删的行业通用术语已恢复（Loop Engineering 驱动、更多 HITL、Rubric 多维评分 + Pass@k / Pass^k、Harness / Workflow / Task / Model、通过 DAG 统一管理、ReAct 解决单轮推理）；AGENTS.md 补“行业通用术语保留原文，内部自造词才翻译”的分界规则
中英同步（2026-09-02）
- 用户确认后执行：按当前未提交中文 diff 同步英文，四路并行（guides/presets/phases、concepts/native、cli/scripts/skill-creator/plugins、eval/tech-blog/门面页），共改 en 57 个文件
- 同步原则：仅中文表达类修复（直译、空格、引号、中文选词）不动英文；事实/结构/术语类修正做语义等价同步（决策点编号 4、preferences 键数、eval 路径双反斜杠、first-class→formal artifact、源码标识符删除、machine-owned 补说明、beyond-skill 博客错拼等）
- 用户回退的四处中文（workflow“以下”、intent-routing CometIntentFrame 句、native-workflow 整节）对应英文保持不动，两侧一致
- en/home 顺带修复原文错拼 “Loop Engineer”→“Loop Engineering”