readme-stewardlisted

# README Steward 你维护的是 cc-master 的项目入口，不是生成一个通用 README 模板。README 的任务是让第一次打开仓库的人迅速理解：这是什么、为什么值得信、怎么开始、哪些承诺是真的、接下来该去哪。 本 skill 用于 `README.md` 和 `README_zh.md` 的创建、更新、审查与同步。深层标准见 `references/readme-standards.md`；做最终检查时读 `references/review-checklist.md`。 ## 心智锚 ### README 是信任入口和路径入口，不是完整说明书 README 首屏要建立方向感和信任感，随后给清晰路径。不要把 feature manual、ADR、AGENTS、安装细节、内部工程规约全塞进 README。README 只承载读者做下一步决策所需的最小真相：用户价值、可运行路径、诚实能力边界、进一步阅读入口。 ### 先讲清项目，再做漂亮 视觉、徽章、截图、hero 语气都只能服务理解。cc-master 的 README 可以有产品感，但不能变成营销堆料：不夸大已落地能力，不用无法由仓库事实支撑的形容词，不让图片和口号遮住安装、使用、限制和真实机制。 ### 双语是同一产品叙事的两种原生表达 `README.md` 和 `README_zh.md` 不是逐句机器翻译关系，也不是两份各写各的文档。它们必须承诺同一组事实、同一条读者路径、同一套能力边界；表达可以按语言自然调整。改动一边时，必须检查另一边是否需要同步。 ### Claim 必须能回指事实源 凡是说“已经支持”“会自动”“能估算”“会切号”“不会超支”“适配 Claude Code / Codex”的句子，都必须能回指仓库事实：代码、安装器、feature manual、design spec、ADR、测试或 README 已有上下文。拿不准就降级措辞或加明确边界。 ## 工作流 1. **判定任务类型。** 是新建、重写、局部更新、双语同步、安装路径更新、能力 claim 审查，还是 README 质量 review。只做必要范围，不顺手大改整篇。 2. **读最小事实源。** 至少读相关 README、[`AGENTS.md`](../../../AGENTS.md) 中 README / skill / release 相关纪律、以及本次改动涉及的事实源。涉及能力状态时读 `design_docs/feature-manual.md` 或对应 ADR；涉及安装时读 `install.sh` / release 文档；涉及贡献者路径时读 `AGENTS.md` 和相关脚本。 3. **分类读者路径。** 判断这次改动服务谁：第一次来的用户、非工程用户、工程用户、潜在贡献者、当前维护者。README 的正文优先服务用户和潜在采用者；维护者细节放到贡献者段落或链接出去。 4. **按入口结构编辑。** 先保证首屏价值、用法入口、能力边界和下一步路径成立，再处理语言润色、图片、徽章、目录和细节。 5. **同步双语事实。** 改 `README.md` 时检查 `README_zh.md`，反之亦然。允许语言风格不同，不允许事实、版本线、安装命令、能力边界漂移。 6. **跑最终审查。** 读 `references/review-checklist.md`，按 checklist 检查过度承诺、模板化、断链、安装命令、图片路径、中文/英文事