SuperAPI AI 工具集

nemoclaw-maintainer-refactor-docs

编程与开发

查看项目

更新于 10-16 07:24

技能介绍

用途:面向 NemoClaw 仓库的文档结构重构,在不改变产品含义的前提下重组有边界的文档章节,提升可查找性,同时保留全部有用事实、每个主题唯一规范归属以及所有已支持的已发布路由。

主要能力与流程:从仓库根目录工作,先遵循共享的文档写作与评审约定;编辑前通读目标页面、docs/index.yml 中的导航条目、fern/docs.yml 中的重定向及入站链接。区分交付物:仅规划/审计请求止于信息架构、归属图与 URL 迁移方案;重构请求则实施、验证并报告迁移。跨章节移动仅在规范归属需要时允许,但须在方案与迁移报告中明确标注。仅当涉及主题归属、公开 URL、支持变体或用户工作流时才暴露选择项,常规细节沿用仓库既有约定。按阶段加载:审计或结构方案用 Structure and Ownership;变更已发布路由或移动内容前用 Migration(改 URL 的方案须含路由与锚点映射);实施完成用 Validation and Review,修复问题并重跑受影响检查。

完成条件(实施重构时):可点击目录项均为真实主题页;可折叠分组节点不可点击且无页面内容;每页只负责一个主主题或任务;每个旧章节映射到目标地址或有理由地移除;故障排查与参考指南各有唯一规范归属;任何受支持变体都不渲染指向未发布页面的链接或重定向;旧 URL 直接重定向到最终已发布页面;共享内容在所有适用 agent 变体中正确渲染;源与生成变体页面无未解决的超大或多用途段落块;简单列表保持紧凑;文档构建、路由检查、链接检查与 diff 检查通过。

报告结果:规划请求报告拟定结构、归属、路由与待决事项;实施重构则总结最终基于旅程的目录、创建/移动/合并/删除的页面、规范故障排查与参考归属决策、保留的重定向与旧路由、变体差异、对密集段落可读性的编辑、验证命令与结果、以及有意延后的相邻清理。

限制:本技能聚焦结构化文档重构,不改变产品含义;具体命令、仓库路径细节除上述文件与检查名外暂未提供。