SuperAPI AI 工具集

nuke-docs

写作与研究

查看项目

更新于 10-15 17:23

技能介绍

用途:检查文档是否仍与现实一致并修复,触发场景包括“nuke docs”“README 是否还准确”“修复文档”“docs drift”。不编辑代码:若代码看似有误,只作为发现项报告并建议 nuke-debug 或 nuke-audit。

主要能力:把每一条可测试声明登记为 C-###,含原文引用、file:line 与类型(command、path、env-var、port/url、script、api-example、config-sample、link、behavior);逐条给出判定:true、drifted、code-suspect、unverifiable,并附原文证据。修复 drifted 后由更高一层验证者复核。产物放在 .nuke/<YYYY-MM-DD>-<HHmmss>-docs-<slug>/,包含 plan.md、claims.md、report.md。

用法:参数 [mode] 取 light(默认)| full | plan;[scope] 为文档路径或默认全仓库文档(README*、docs/、CONTRIBUTING 及代码相邻 *.md 指南;变更日志与 ADR 作为历史记录排除);--ask 在预检计划处暂停确认,默认不设门直接执行。流程为 Phase 0 预检、Phase 1 声明提取、Phase 2 验证、Phase 3 修复与验证(上限 light 2 次、full 3 次)、Phase 4 报告后停止。

限制:必须运行或追踪验证,不得只看表面;破坏性命令(安装、部署、发布、删除)永不执行,仅追踪并标注 traced;不改动文风,只修正失实内容;不执行 git add、git commit、git stash,保留工作区供审阅。文档未提供安装方式、平台、收费等信息,暂未提供。