用途:为 ZIO 库中的某个数据类型撰写一页参考文档。当用户要求记录某个数据类型、编写 API 参考时触发。资料显示这是 zio/zio-skills 中的技能,依赖 docs-writing-style 与 docs-mdoc-conventions 两个前置技能分别约束行文与代码块语法。
主要能力与流程:技能以提示形式给出完整代理工作流,分为三阶段。阶段一为研究与规划:先做深度源码研究(委派 docs-researcher 代理,要求不与主对话共享上下文),再规划页面(深度层级、可选章节、API 分组),并为每个章节及步骤 4 至 10 建任务,交用户确认。阶段二写作(步骤 3)。阶段三验证与收尾(步骤 4 至 10,按序执行合规检查、示例、方法覆盖、mdoc、事实核查、集成、评审)。资料强调顺序不可调换,示例须先于 mdoc 落地。
使用方式:技能接受一个目标类型名参数($ARGUMENTS);若未提供类型名,须先询问用户,不得自行编造。文档文件放在 docs/reference/<type-name-kebab-case>.md,文件头含 id、title、description、keywords 四个字段。核心类型需覆盖开篇定义、Motivation、Usage、Installation、Creating Values、预定义实例、按能力分组的核心操作、子类型、可选比较、高级用法、集成、运行示例等章节;支撑类型仅保留开篇定义与 Usage。
适用场景:ZIO 生态文档库中数据类型 API 参考页的生成与维护。
限制:资料未提供具体安装命令、依赖坐标、支持的平台或版本等事实,暂未提供;输出结构、分组与写作规则严格,代理不得跳过步骤或凭惯例臆造构造器与方法签名。