SuperAPI AI 工具集

turn-incident-into-content

写作与研究

查看项目

更新于 10-16 03:41

技能介绍

用途:当你解决了一个用户问题、回答了支持提问或帮人处理了技术故障后,用这个技能把具体事件提炼成可分享的内容方向。它产出的是内容框架,不是成品稿件:不写打磨好的博客、不写可直接提交的文档 PR、也不写社交媒体串(后者用 /repurpose-talk)。

使用方式:运行前先检查 ~/.devadvokit.md 是否存在。存在则静默读取并在整个过程中使用;不存在则停止并提示用户先运行 /setup-devadvokit。随后逐个提问,等每个回答后再问下一个:问题是什么(具体错误、异常行为、困惑点)、你尝试了什么(调试过程与失败方案)、什么真正解决了问题(命令、配置改动或思路转变)、如果对第一次遇到的人说一句话会说什么、用户是谁(影响受众定位)。

主要能力:问答完成后输出三部分。一是 TIL 格式,含标题、2–3 句正文(先讲没用的、再讲解法、最后讲收获)和格式适配建议。二是完整上下文格式,含工作标题、问题、调查过程、解决方案、可迁移的经验教训和受众。三是格式推荐,在文档更新、博客文章、演讲种子、小型一次性内容中选一个主推荐并说明理由,必要时给出文档位置或叙事角度。若 ~/.devadvokit.md 的内容库中已覆盖同一问题,会提示是否补充新信息或更新旧文。

适用场景:开发者关系、技术布道、支持工程等需要把零散排障经验沉淀为内容的人。

限制:依赖 ~/.devadvokit.md 提供上下文,缺失时无法运行;只给方向和结构,不产出成品;具体输出质量取决于问答信息的完整度。