SuperAPI AI 工具集

technical-writing

写作与研究

查看项目

更新于 10-16 09:30

技能介绍

用途:撰写比功能说明更深入的技术文章,讲清系统如何运作。适用于架构文章、内部机制解析、工程决策记录,以及读者想理解系统而非仅使用系统的场景。面向高级用户、开发者与有技术兴趣的读者。若文章适合放在工程博客或最佳实践系列中,就属于本技能。

主要能力:提供五类文章结构。架构/系统设计:待解决问题、约束与需求、考虑过的方案、选定架构(含图)、接受的取舍、结果与经验。深度解析:概念是什么及为何重要、简化心智模型、详细机制、真实示例、取舍与不适用场景、延伸阅读。教程:先展示最终结果、前置条件、分步实现、完整代码、后续扩展;要求每个代码块可运行、含错误处理、解释原因。事故复盘:摘要、时间线、根因分析、修复、防复发措施、经验教训。基准对比:对比对象与原因、可复现方法、结果图表、分析、带注意事项的建议、原始数据。

使用方式:先确认要讲解的产品或系统、每篇2至3个机制、文章类型、系列名与受众水平。若用户只说写某主题的技术文章,先提出2至3个最有价值的子主题再动笔。输出文章与最多3条推文线程。

限制与规范:每篇2至3个主题,每个主题需有足够深度,写不出200字以上实质内容就不应放入。明确标注假定受众水平。代码块须可运行、含语言标识、展示输出、使用真实变量名、固定依赖版本。架构涉及三个以上组件时用图。避免营销语气,须讨论取舍。禁用破折号、水平分隔线及“不是X而是Y”句式。

资料未提供具体产品示例文件内容、实际收费或平台支持信息。