用途:owl-archive 面向各类用户可读文本的撰写,包括帮助中心文章、技术文档、规格草稿、用户引导文案、提示信息与错误信息、落地页文案,以及对现有文档做语气一致性检查。触发条件包括用户要求“写文档”“记录一下”“写帮助文章”,或调用 /owl-archive、提到 owl/documenting。
主要能力:采用 OBSERVE(观察)、HUNT(搜寻)、GATHER(收集)、NEST(组织)、TEACH(分享)五阶段流程。观察阶段明确目的、受众与用户疑问;搜寻阶段加载语言风格指南,确认用户身份术语(如 Wanderer、Rooted、Pathfinder、Wayfinder),判断内容所处的语气区间;收集阶段强调避开 AI 化写作模式,如破折号滥用、“not X but Y”句式、常见 AI 用词和多种句法、语气、行文套路,并建议短段落、混合句长、朗读检查;组织阶段按内容类型选择模板并为读者阅读顺序排版,错误信息要说清发生了什么和能做什么;分享阶段运行自查清单、确认链接可用、代码示例可运行、步骤可跟随。
使用方式:按上述阶段推进,并根据阶段加载对应参考文件——HUNT 阶段加载 references/grove-voice-guide.md,GATHER 阶段加载 references/anti-patterns.md,NEST 阶段在构建特定文档结构时加载 references/documentation-templates.md。可与 swan-design(技术规格)和 museum-documentation(叙事型深度文档)配合使用。
适用场景:帮助文章、工具提示、错误信息、引导文案、快速参考指南、API 文档、落地页文案等面向用户的写作任务。
限制:资料未说明该技能的具体安装方式、运行平台、收费或价格;也未提供可直接执行的命令行安装步骤。其质量依赖所引用的参考文件是否可用。