一键导入
doc-style
结构化编写、重构、润色和验收 Markdown / MDC 文档。 只要用户要创建、编辑、润色、改写、评审或整理任何 `.md` / `.mdc` 文件, 或需要整理规则文档、普通说明文档、PR review 评论、GitHub 评论、零散草稿,就应使用这个 skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
结构化编写、重构、润色和验收 Markdown / MDC 文档。 只要用户要创建、编辑、润色、改写、评审或整理任何 `.md` / `.mdc` 文件, 或需要整理规则文档、普通说明文档、PR review 评论、GitHub 评论、零散草稿,就应使用这个 skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
需求排期录入工具——将工作事项同步到企业微信智能表格。 当用户提到"加入排期"、"录入排期"、"更新排期表"、"需求排期"、"把 xxx 加到排期"等意图时触发。 也适用于用户提供新周期 schema/key 要求配置新文档的场景。
管理工作区知识对象的检索与全生命周期操作,路径涉及 `knowledge/`,知识对象包括 issue(需求)、plan(方案 / 计划)、snippet(代码片段)、article(文章)和 troubleshooting(排障经验)。 当用户询问事项进展、最近做了什么、周报 / 日报 / 总结素材,或者问题依赖历史结论、过往决策时,应优先使用本 skill。 当用户要求将结论沉淀到知识对象体系,或者要求检索、创建、修改、归档、迁移知识对象时,应使用本 skill 执行相关操作。 外部资料调研、纯代码实现 & 调试 & 测试等无需落地知识对象的行为不属于本 skill 场景。
准备和修复 Go、Node.js、Python 本地开发环境。 用于版本切换、工具链缺失、依赖环境异常、虚拟环境问题,以及编译、测试、检查命令中的环境类失败。 典型信号:系统已装版本低于 `go.mod`、`.nvmrc`、`pyproject.toml` 要求,出现 `invalid go version`,找不到 `gvm`、`nvm`、`uv`,或 `uv sync` 报错。 在判定环境不可用或跳过、假装跳过编译、测试前,必须先用本 skill 尝试切换或修复环境。
统一通用代码风格与实现约束:按目标项目规范(AGENTS.md / CONTRIBUTING.md)与语言参考约束命名、格式、复杂度与错误处理。 编写、修改、评审任意语言源码或迁移代码规则时使用,交付代码前据此确保改动符合项目与工作区风格。
Git 提交规范。 用户要求提交、commit、拆分提交、起草 commit message、整理待提交范围或处理暂存区时必须使用。 用于区分工作区知识库提交与非工作区项目提交:默认按工作区规范,用户明确要求提交其他项目时遵循项目自身规范。
同步 AI 工作区文档到 iWiki、从 iWiki 回写本地、做日常增量对齐时使用。 只要用户提到“同步到 iWiki”“从 iWiki 拉取”“双向更新”“补齐映射”“重传文档”“个人空间目录对齐”,都应立即使用本 Skill。
| 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。0x02 提及的全部文档和 Humanizer,作为润色规范修订后的文本必须满足:
【CRITICAL(必须执行,不可协商)】审稿自检不能用自动检查替代,低于 90 分时,回到 0x04.a 重新润色。
| 维度 | 评估标准 | 得分 |
|---|---|---|
| 直接性 | 直接陈述事实还是绕圈宣告?(8 分:直截了当,1 分:充满铺垫) | /8 |
| 节奏 | 句子长度是否变化?(8 分:长短交错,1 分:机械重复) | /8 |
| 信任度 | 是否尊重读者智慧?(8 分:简洁明了,1 分:过度解释) | /8 |
| 真实性 | 听起来像真人说话吗?(8 分:自然流畅,1 分:机械生硬) | /8 |
| 精炼度 | 还有可删减的内容吗?(8 分:无冗余,1 分:大量废话) | /8 |
| 黑话清单 | 仅在特定圈层成立、脱离圈层即丢失语义的词语。圈外读者无法独立读懂,依赖默会知识、内部缩写、外文夹杂或隐喻 | /8 |
| 晦涩清单 | 读完仍需回看才能理解的语句。常见问题包括术语堆叠、被动嵌套、省略主语、长定语前置 | /8 |
| 冗余清单 | 对结论无新增信息量的内容。常见问题包括过程叙述、跨节重述、为衔接而衔接的句子 | /8 |
| 审美缺点清单 | 以「极高文档审美的专业领域评审专家」视角检查结构、行文、叙事节奏、信息层级、留白与对齐 | /8 |
| common 规范 | 按 0x02 的 5 个 common 文件检查。不满足一点扣 2 分,扣分上限为 28 分 | /28 |