القائمة
文档审计工作流 — 交叉验证docs文档与实际代码的一致性，修复不准确的引用和描述。触发词：文档审查、doc audit、核查文档、文档准确性。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
استنادا إلى تصنيف SOC المهني
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/entropy-cloud/nop-entropy --skill nop-doc-auditيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
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、历史搜索（基于项目风格固化）
| 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