SuperAPI AI 工具集

diataxis

写作与研究

查看项目

更新于 10-15 23:45

技能介绍

用途:该技能用 Diátaxis 框架治理文档。Diátaxis 按用户需求把文档分为四类:教程(tutorials)、操作指南(how-to guides)、参考(reference)、解释(explanation),每类写法不同,必须保持象限纯粹。

主要能力:支持四种模式。classify 判断内容属于哪个象限;audit 分析文档集的缺口、失衡与违规;generate 在指定象限生成新文档;restructure 拆分或重组混合模式内容。模式需从用户请求推断或明确说明,无法确定时先询问。

分类方法:用“行动/认知 × 获取/应用”两问定位唯一象限。教程面向学习、以行动为主;操作指南面向工作、以行动为主;参考面向工作、以认知为主;解释面向学习、以认知为主。

生成策略:生成前必须满足其一——用户明确指定目标象限,或代理先分类并给出置信度与证据、经用户确认。若无法维持象限纯粹,带解释的拒绝也是有效结果。

输出要求:分类或标记违规时须给出象限、置信度(高/中/低)与证据,如祈使动词、目标导向标题、缺少概念框架等。

违规检测:会标记教程夹带解释、操作指南变成教学、参考含叙事、解释含步骤、单文档混合多象限等反模式。

限制:不发明文档策略或信息架构,不决定产品架构或功能范围,不把多个象限合并进单一文档,不覆盖仓库特定文档规则或风格指南,不在未明确象限分类时生成内容。Diátaxis 由 Daniele Procida 提出,采用 CC-BY-SA 4.0 许可。