// 结构化编写、重构、润色和验收 Markdown / MDC 文档。 只要用户要创建、编辑、润色、改写、评审或整理任何 `.md` / `.mdc` 文件， 或需要整理规则文档、普通说明文档、PR review 评论、GitHub 评论、零散草稿，就应使用这个 skill。
管理工作区知识对象的检索与全生命周期操作，路径涉及 `knowledge/`，知识对象包括 issue（需求）、plan（方案 / 计划）、snippet（代码片段）和 troubleshooting（排障经验）。 当用户询问事项进展、最近做了什么、周报 / 日报 / 总结素材，或者问题依赖历史结论、过往决策时，应优先使用本 skill。 当用户要求将结论沉淀到知识对象体系，或者要求检索、创建、修改、归档、迁移知识对象时，应使用本 skill 执行相关操作。 外部资料调研、纯代码实现 & 调试 & 测试等无需落地知识对象的行为不属于本 skill 场景。
执行代码审查、PR review、复查、处理未解决 review threads、发 review 评论、request changes 或 approve 前必须使用。适用于检查 GitHub PR diff、本地变更、相关源码、测试覆盖、项目规范和既有评论，并输出对话草稿，或在明确授权后发布 inline / conversation review 评论。
同步 AI 工作区文档到 iWiki、从 iWiki 回写本地、做日常增量对齐时使用。只要用户提到“同步到 iWiki”“从 iWiki 拉取”“双向更新”“补齐映射”“重传文档”“个人空间目录对齐”，都应立即使用本 Skill。
通过 repos.json 注册和管理工作区中的项目。当用户想要接入项目、移除项目、询问项目设置规范，或消息中提到已注册项目名并需要定位 local_path 时使用。
处理通用代码风格与实现约束。用于源码读取、编辑、评审和规则迁移。
准备和修复 Go、Node.js、Python 本地开发环境。用于版本切换、工具链缺失、依赖环境异常、虚拟环境问题，以及编译、测试、检查命令中的环境类失败。
| name | doc-style |
| description | 结构化编写、重构、润色和验收 Markdown / MDC 文档。 只要用户要创建、编辑、润色、改写、评审或整理任何 `.md` / `.mdc` 文件， 或需要整理规则文档、普通说明文档、PR review 评论、GitHub 评论、零散草稿，就应使用这个 skill。 |
doc-style 负责 Markdown / MDC 文档的结构设计、表达压缩与交付前润色。
适用范围：
.md / .mdc 文档编辑、重构、润色与验收。职责边界：
【CRITICAL（必须执行，不可协商）】无论文档类型是什么，都必须先读 references/common/ 下全部 5 个文件：
common/ 全部 5 个文件。0x04。完成初稿后执行润色闭环：
common/ 规则逐节核对，违例就地修复。paragraph.md 的载体选择规则，确认不是源码硬换行或连续孤立短段。5 张主观审稿清单。【CRITICAL（必须执行，不可协商）】审稿自检不能用自动检查替代。
清单执行约束：
| 清单 | 定义 | 判定要点 |
|---|---|---|
| 黑话清单 | 仅在特定圈层成立、脱离圈层即丢失语义的词语 | 圈外读者无法独立读懂，依赖默会知识、内部缩写、外文夹杂或隐喻 |
| 晦涩清单 | 读完仍需回看才能理解的语句 | 术语堆叠、被动嵌套、省略主语、长定语前置 |
| 冗余清单 | 对结论无新增信息量的内容 | 过程叙述、跨节重述、为衔接而衔接的句子 |
| AI 味清单 | 模板化、与具体上下文脱钩也照样成立的表达 | 句子换主题仍然读得通，或堆积空泛形容词与机械承接转折 |
| 审美缺点清单 | 以「极高文档审美的专业领域评审专家」视角列出的缺点 | 结构、行文、叙事节奏、信息层级、留白与对齐 |