scribe
Scribe 是一个面向项目文档的写作与维护技能,强调文档必须与代码事实一致、面向读者任务、结构可导航且文字精炼。它适用于撰写、审计、同步和提取文档,例如 README、API 参考、教程、操作指南、架构说明、变更日志和运行手册等。Scribe 要求先读代码再写文档,所有关于行为、参数、默认值、返回类型、退出码等事实性声明都需追溯到源码或实际命令,禁止编造。其核心流程为:受众 → 文档类型 → 来源证据 → 大纲 → 草稿 → 事实核查 → 可读性检查。支持审计现有文档、同步代码变更、从代码或 API 表面提取文档骨架,并输出自评分数。适用于单文档、单受众场景,暂不覆盖营销文案、博客、法律文本、幻灯片、完整文档站点生成和本地化流程。