用途:扫描 NemoClaw 仓库的近期 git 提交,找出影响用户可见行为的变更,并为每个相关提交起草或更新对应文档页面。
前提:需位于 NemoClaw git 仓库中,且 docs/ 目录已存在当前文档集。
主要能力与流程:确定提交范围(用户可指定,否则默认自主分支头起);用 git log v0.1.0..HEAD --oneline --no-merges 或 git log -50 --oneline --no-merges 等命令筛选可能影响文档的提交,重点关注 feat、fix、refactor、perf,以及涉及 nemoclaw/src/、nemoclaw-blueprint/、bin/、scripts/、策略相关代码的改动,忽略 test/、.github/ 等。随后把提交映射到文档页,例如命令相关映射 docs/reference/commands.md,blueprint 映射 docs/about/architecture.md,策略映射 docs/reference/network-policies.md,推理相关映射 docs/reference/inference-profiles.md;无法映射但引入用户可见概念时标记为需要新页面。再用 git show <commit-hash> 阅读完整 diff,提取改了什么、为何改、有无破坏性变更,并先阅读现有目标页面再编辑。
写作规范:主动语态、现在时、第二人称;不加多余粗体;少用破折号;标题不使用编号与冒号;NVIDIA、NemoClaw、OpenShell 大小写需正确;代码示例使用 console 与 $ 前缀;新建页面需含 SPDX 头、匹配 frontmatter 并加入 docs/index.md 的 toctree。
结果呈现与验证:输出更新页面、需新建页面、无文档影响提交的汇总,最后执行 make docs 检查构建警告、错误与失效交叉引用。
限制:仅适用于 NemoClaw 仓库;需手动判断提交是否影响文档;文档中未提供更多平台、价格或自动化程度信息暂未提供。