用途:撰写可复现的技术内容,使文中的论断、代码、命令和版本都能追溯到证据来源。适用于技术教程、集成指南、部署文章、工程实践记录和项目文档,输出为 Markdown。
主要能力:提供证据分级模型,将材料分为官方事实、源码观察、运行验证、推断、待确认五类,要求不得把推断或待确认当作已验证事实;涉及版本、API、支持矩阵等时效性内容时需查阅权威来源。提供工作流:定义读者契约、建立验证矩阵、选择结构、基于可执行产物写作、验证、冷读检查。附带 assets/technical-blog-template.md 模板,可用 Mermaid 画 Markdown 原生流程、PlantUML 画 UML/C4。
使用方式:当需要完整文章骨架时复制 assets/technical-blog-template.md,删除无关章节而非填充泛泛内容。典型结构包括成果与范围、前置条件与已验证环境、架构或请求流、分步实现、配置与安全、运行与验证、故障排查、限制与生产注意事项、验证记录与来源。写作时优先使用当前仓库中的代码与配置,片段保持最小但语法完整,密钥用占位符并脱敏令牌、个人数据和内部端点。验证部分需记录验证日期、操作系统、运行时版本、框架/SDK 版本、执行命令、结果、未验证内容和官方资料链接。
路由:产品文档套件或 PRD 层级交给 full-stack-doc 技能,安装命令 npx skills add full-stack-skills/document-skills --skill full-stack-doc;仅 API 文档交给 api-doc-generator,安装命令 npx skills add full-stack-skills/document-skills --skill api-doc-generator;协作式提案/RFC 起草交给 doc-coauthoring,安装命令 npx skills add full-stack-skills/document-skills --skill doc-coauthoring。
限制:仅在授权时运行安全命令与测试;无法执行时须说明并提供精确验证步骤,不得声称成功。不得仅凭开发示例给出通用生产结论。除非允许再分发,不要复制官方图片。需校验相对链接与本地图片引用。保留用户既有文章结构,除非改动能实质提升理解。完成时需报告输出文件、已验证命令/测试、使用的来源链接、测试环境及所有剩余的推断或待确认项。