用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/entropy-cloud/nop-entropy --skill nop-doc-audit命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
Create roadmaps and mission configs, then drive the mission-driver AI dev-loop engine. mission-driver lives at tools/mission-driver/ — it reads missions/<name>.json and loops CHECK → REVIEW_PLANS → EXEC_PLANS → DRAFT_PLANS → DEEP_AUDIT until the roadmap is done or the audit budget is exhausted. Use this skill when the user wants to: (1) plan a development goal as a roadmap ("create roadmap", "make a roadmap", "new dev goal"); (2) bootstrap a mission config from an existing roadmap ("create mission", "config mission", "draft mission"); (3) launch / resume / monitor a mission ("run mission", "start mission-driver", "continue mission", "mission stuck"); (4) mentions "roadmap", "mission-driver", "dev loop", "auto development", "AGE loop". Trigger words: roadmap, mission, mission-driver, dev loop, draft-mission, list-missions.
Git Bundle导出工作流 — 将未推送提交或分支差异打包为.bundle文件,用于离线同步或跨机器传输。触发词:bundle、导出、sync、离线同步。
Nop项目Git专家 - 智能提交、Rebase、历史搜索(基于项目风格固化)
基于 SOC 职业分类
正在显示 SKILL.md
| name | nop-doc-audit |
| description | 文档审计工作流 — 交叉验证docs文档与实际代码的一致性,修复不准确的引用和描述。触发词:文档审查、doc audit、核查文档、文档准确性。 |
交叉验证 docs-for-ai/ 文档与实际代码的一致性,修复不准确、过时或缺失的内容。
审查文档 / doc audit / 核查文档 — 验证文档准确性文档引用检查 — 验证文档中的代码引用是否存在文档一致性 — 检查多处文档是否描述一致docs-for-ai/ 是规范性文档# 确定审计范围
# 选项1:指定模块
MODULE="nop-auth" # 或 nop-orm, nop-core 等
# 选项2:指定文档
DOC="docs-for-ai/02-core-guides/service-layer.md"
# 选项3:全量审计(谨慎使用)
# 扫描所有 docs-for-ai/ 下的 .md 文件
# 1. 提取文档中的代码引用(类名、方法名、文件路径)
# 2. 在实际代码中搜索验证
# 示例:验证类名引用
CLASS_NAME="OrmEntityModelInitializer"
find . -name "*.java" | xargs grep -l "class $CLASS_NAME" 2>/dev/null
# 示例:验证方法名引用
METHOD_NAME="addInternalProps"
find . -name "*.java" | xargs grep -l "$METHOD_NAME" 2>/dev/null
# 示例:验证文件路径引用
test -f "nop-orm-model/src/main/resources/_vfs/nop/orm/imp/orm.imp.xml" && echo "EXISTS" || echo "MISSING"
# 1. 文档声称的行为 vs 代码实际行为
# 2. 检查参数、返回值、异常类型是否匹配
# 3. 检查配置项名称、默认值是否匹配
# 示例:验证配置项
grep -rn "nop.ai.timeout" --include="*.java" --include="*.xml" .
# 示例:验证方法签名
grep -n "public.*authenticate" nop-auth/service/src/main/java/**/*.java
# 1. 检查多处文档是否描述同一概念一致
# 2. 检查 INDEX.md 路由是否正确
# 3. 检查文档间的交叉引用是否有效
# 验证链接
grep -rn '\[.*\](.*\.md)' docs-for-ai/ | while read line; do
# 检查链接目标是否存在
done
根据审计结果,按优先级修复:
# 验证 ORM 模型文档中的实体定义
# 1. 提取文档中声称的实体名
# 2. 在 *.orm.xml 中搜索验证
# 3. 检查字段、关系、域定义是否匹配
# 示例
grep -rn "entity.*name=" docs-for-ai/ | head -10
find . -name "*.orm.xml" | head -5
# 验证 API 文档中的接口定义
# 1. 提取文档中声称的 API 路径
# 2. 在 *.api.xml 或 GraphQL schema 中搜索验证
# 3. 检查参数、返回值是否匹配
# 验证配置文档中的配置项
# 1. 提取文档中声称的配置项
# 2. 在 *.xml 或 *.properties 中搜索验证
# 3. 检查默认值是否匹配
# 文档审计报告 - [模块名]
## 审计范围
- 文档: `docs-for-ai/xxx.md`
- 代码: `nop-xxx/`
## 发现问题
### High - 不存在的描述
| 位置 | 问题 | 建议 |
|------|------|------|
| line 42 | 声称存在 `FooBar` 类,但代码中不存在 | 删除该段落 |
### Medium - 行为不一致
| 位置 | 文档描述 | 实际行为 | 建议 |
|------|---------|---------|------|
| line 78 | 返回 `List<String>` | 返回 `List<Integer>` | 更新文档 |
### Low - 缺失信息
| 位置 | 缺失内容 | 重要性 | 建议 |
|------|---------|--------|------|
| line 100 | 未说明异常处理 | 中 | 补充说明 |
## 修复建议
1. ...
2. ...
项目中已有的文档检查工具:
# 链接检查
node ai-dev/tools/check-doc-links.mjs --strict
# 文档索引检查
node ai-dev/tools/check-doc-index.mjs
# 文档乱码检查
node ai-dev/tools/check-docs-garbled.mjs
# 超大文件检查
node ai-dev/tools/check-oversized-files.mjs
# ORM图标检查
node ai-dev/tools/check-orm-icons.mjs