菜单
项目 README 规范化生成与打磨。基于代码事实审计功能声明，按统一视觉规范（徽章语义、Mermaid 色板、章节命名、引用块标注）输出可信、清晰、适合展示的项目入口。支持从零创建和基于已有 README 迭代两种模式。Use when 用户说"帮我写 README"、"打磨一下 README"、"生成项目首页"、"优化 README"，或任何涉及 README.md / 项目首页 / 仓库入口文档创建、重写、迭代的场景。即使 README 已经存在，只要用户提到优化、打磨、调整排版、加徽章、加架构图，也应触发。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | readme-polish |
| description | 项目 README 规范化生成与打磨。基于代码事实审计功能声明，按统一视觉规范（徽章语义、Mermaid 色板、章节命名、引用块标注）输出可信、清晰、适合展示的项目入口。支持从零创建和基于已有 README 迭代两种模式。Use when 用户说"帮我写 README"、"打磨一下 README"、"生成项目首页"、"优化 README"，或任何涉及 README.md / 项目首页 / 仓库入口文档创建、重写、迭代的场景。即使 README 已经存在，只要用户提到优化、打磨、调整排版、加徽章、加架构图，也应触发。 |
不是营销式吹项目，而是基于代码事实，把 README 打磨成可信、清晰、适合展示的项目入口。
用户输入包含以下任一意图时，执行本 skill：
读取以下文件，总结项目定位：
README.md（已有则审计，无则从零）package.json / pom.xml / build.gradle / pyproject.toml（如有）src/ / docs/ / examples/ / tests/ / assets/（如有）__index__.md / WEEK.md / TASK.md 等结构文件输出：项目事实摘要（定位、技术栈、核心模块、运行方式）
列出现有 README 的所有功能声明，标注证据状态：
| 状态 | 含义 |
|---|---|
verified | 有代码/配置/文档/测试依据 |
outdated | 曾正确，但项目已变更 |
partial | 部分正确，需补充或修正 |
planned | 规划中，尚未实现 |
unsupported | 找不到任何依据 |
输出：Claim Audit 表
先问用户 README 面向谁：
默认假设：比赛评委 + 面试官（学习营项目性质）
基于审计结果和定位，输出 README 大纲：
# Project Name
## Header（标题 + 描述 + Banner + Badges + 导航锚点）
## ✨ Highlights（亮点聚焦，3-5 条核心主张）
## 🌱 Origin / Motivation（起源与动机，可选）
## 📊 Progress / Status（当前进度，动态更新）
## 📂 Repo Structure（仓库结构，文字 + Mermaid）
## ⚙️ Workflow / Architecture（工作流或架构，Mermaid 图）
## 💡 Key Insights（核心判断/技术观点，引用块 + 斜体）
## 🏆 Hackathon / Roadmap（方向或路线图）
## 🔗 Links（关键链接）
## 🔒 Privacy / License（隐私提醒或协议）
## 🤝 Thanks / Credits（鸣谢，可选）
不要机械套用。根据项目类型增删：代码项目加 Quick Start / Usage；纯文档项目加学习路径 / 每日索引。
按 references/conventions.md 执行：
> *内容* 格式| 元素 | 规范 |
|---|---|
| Header | 标题 → 描述 → Banner(100%宽) → Badges(for-the-badge) → 导航锚点(·分隔)，全部居中 |
| 徽章语义 | 蓝=周期/信息，亮绿=完成/状态，橙=进行中/待定，红=警告/阻塞 |
| 章节标题 | ## emoji English (中文)，二级 ### 不加 emoji |
| Mermaid 色板 | 紫(#6C3CE1)=工具/起点，蓝(#3B82F6)=辅助，黄(#F59E0B)=进行中(文字#000)，绿(#10B981)=产出/完成，红(#EF4444)=里程碑/危险 |
| 引用块 | 技术观点/判断用 > *斜体内容*，核心结论用 > **粗体内容** |
| 代码/工具 | 反引号包裹，如 Claude Code、.claude/skills/ |
| 中英混排 | 英文术语前后留空格，如 "Agent 编排"、"README Polish" |
每次执行必须输出：
用户确认后，再生成最终 README.md 全文。
链式维护：当一个源文件变更后，自动检测并更新所有下游关联文件。用户说"帮我维护一下"、"cascade 一下"、"同步一下目录"时触发。适用于 web3career-study-track 项目中任何可能导致多文件联动变更的场景。
一天学习结束后，同步 daily-log、更新状态、按模块分组 commit & push。当用户说"写一下今天的 daily-log"、"同步一下今天的日志"、"commit 一下"时触发。适用于 web3career-study-track 项目的每日收尾流程。
Git 提交规范化指引。当用户说"提交一下"、"commit"、"帮我写 commit"时，按此规范生成 commit message。 覆盖全部 type 定义、scope 规则、subject 风格和 body 格式。
将 Handbook 原文整理为预习笔记（原文+批注格式）。当用户提供 Handbook 原文、课件内容或学习材料，需要整理成带批注的预习笔记时使用此 skill。适用于 AI × Web3 School 学习流程中 pre_study/ 目录下的所有模块。即便用户只说"整理笔记"或"帮我批注一下"，只要上下文是学习材料，也应触发。支持单篇和批量模式。
从 WCB Agent API 自动拉取每日任务和事件，落到对应日期的 TASK.md。当用户说"拉一下今天任务"、"wcb sync"、"同步任务"、"看看今天有什么活动"时触发。适用于 web3career-study-track 项目的每日任务收集流程。免去手动从 web3career.build 页面复制任务的步骤。
Git 提交规范化指引。当用户说"提交一下"、"commit"、"帮我写 commit"时，按此规范生成 commit message。 覆盖全部 type 定义、scope 规则、subject 风格和 body 格式。