ln-612-semantic-content-auditor by levnikolaevich/claude-code-skills
npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-612-semantic-content-auditor路径说明: 文件路径(
shared/、references/、../ln-*)是相对于技能仓库根目录的。如果在当前工作目录未找到,请定位此 SKILL.md 文件所在的目录,然后向上返回一级以找到仓库根目录。如果缺少shared/目录,请通过 WebFetch 从https://raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path}获取文件。
专门用于审计项目文档语义准确性的工作者。
仅针对项目文档调用(不包括参考/任务文档):
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 文档 | 验证重点 |
|---|---|
CLAUDE.md | 指令服务于既定目的,无离题内容 |
docs/README.md | 导航范围正确,描述相关 |
docs/documentation_standards.md | 标准适用于本项目类型 |
docs/principles.md | 原则与项目架构相关 |
docs/project/requirements.md | 需求范围完整,无过时项 |
docs/project/architecture.md | 架构范围涵盖所有层次 |
docs/project/tech_stack.md | 技术栈范围符合项目实际 |
docs/project/api_spec.md | API 范围涵盖所有端点组 |
docs/project/database_schema.md | 数据库模式范围涵盖所有实体 |
docs/project/design_guidelines.md | 设计范围涵盖活动组件 |
docs/project/infrastructure.md | 基础设施范围涵盖所有部署目标 |
docs/project/runbook.md | 运行手册范围涵盖设置与运维 |
排除: docs/tasks/、docs/reference/、docs/presentation/、tests/
必读: 加载 shared/references/audit_worker_core_contract.md。
每次调用从协调器接收:
| 字段 | 描述 |
|---|---|
doc_path | 待审计文档的路径(例如 docs/project/architecture.md) |
output_dir | 报告输出目录(来自 contextStore) |
project_root | 项目根路径 |
tech_stack | 检测到的技术栈 |
<!-- SCOPE: ... --> 注释根据声明的范围分析文档各章节:
| 检查项 | 发现类型 |
|---|---|
| 章节不服务于范围 | OFF_TOPIC |
| 范围方面未覆盖 | MISSING_COVERAGE |
| 超出范围的过多细节 | SCOPE_CREEP |
| 内容在其他地方重复 | SSOT_VIOLATION |
评分:
根据范围对齐情况计算最终分数:
overall_score = weighted_average(coverage, relevance, focus)
覆盖率:范围被阐述的完整程度。相关性:服务于范围的内容比例。聚焦度:无离题内容。
必读: 加载 shared/references/audit_worker_core_contract.md 和 shared/references/audit_scoring.md。
必读: 加载 shared/references/audit_worker_core_contract.md 和 shared/templates/audit_worker_report_template.md。
将报告写入 {output_dir}/612-semantic-{doc-slug}.md,其中 doc-slug 源自文档文件名(例如 architecture、tech_stack、claude_md)。
设置 category: "Semantic Content" 和检查项:scope_alignment。
向协调器返回摘要:
Report written: docs/project/.audit/ln-610/{YYYY-MM-DD}/612-semantic-architecture.md
Score: X.X/10 | Issues: N (C:N H:N M:N L:N)
必读: 加载 shared/references/audit_worker_core_contract.md。
必读: 加载 shared/references/audit_worker_core_contract.md。
{output_dir}/612-semantic-{doc-slug}.md(原子性单次写入调用)shared/references/audit_output_schema.md版本: 2.0.0 最后更新: 2026-03-01
每周安装次数
98
仓库
GitHub 星标数
245
首次出现
2026年3月1日
安全审计
已安装于
cursor92
claude-code91
codex91
opencode90
github-copilot90
amp90
Paths: File paths (
shared/,references/,../ln-*) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root. Ifshared/is missing, fetch files via WebFetch fromhttps://raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path}.
Specialized worker auditing semantic accuracy of project documentation.
Called ONLY for project documents (not reference/tasks):
| Document | Verification Focus |
|---|---|
CLAUDE.md | Instructions serve stated purpose, no off-topic content |
docs/README.md | Navigation scope correct, descriptions relevant |
docs/documentation_standards.md | Standards applicable to this project type |
docs/principles.md | Principles relevant to project architecture |
docs/project/requirements.md | Requirements scope complete, no stale items |
docs/project/architecture.md |
Excluded: docs/tasks/, docs/reference/, docs/presentation/, tests/
MANDATORY READ: Load shared/references/audit_worker_core_contract.md.
Receives from coordinator per invocation:
| Field | Description |
|---|---|
doc_path | Path to document to audit (e.g., docs/project/architecture.md) |
output_dir | Directory for report output (from contextStore) |
project_root | Project root path |
tech_stack | Detected technology stack |
<!-- SCOPE: ... --> commentAnalyze document sections against stated scope:
| Check | Finding Type |
|---|---|
| Section not serving scope | OFF_TOPIC |
| Scope aspect not covered | MISSING_COVERAGE |
| Excessive detail beyond scope | SCOPE_CREEP |
| Content duplicated elsewhere | SSOT_VIOLATION |
Scoring:
Calculate final score based on scope alignment:
overall_score = weighted_average(coverage, relevance, focus)
Coverage: how completely the scope is addressed. Relevance: how much content serves the scope. Focus: absence of off-topic content.
MANDATORY READ: Load shared/references/audit_worker_core_contract.md and shared/references/audit_scoring.md.
MANDATORY READ: Load shared/references/audit_worker_core_contract.md and shared/templates/audit_worker_report_template.md.
Write report to {output_dir}/612-semantic-{doc-slug}.md where doc-slug is derived from document filename (e.g., architecture, tech_stack, claude_md).
With category: "Semantic Content" and checks: scope_alignment.
Return summary to coordinator:
Report written: docs/project/.audit/ln-610/{YYYY-MM-DD}/612-semantic-architecture.md
Score: X.X/10 | Issues: N (C:N H:N M:N L:N)
MANDATORY READ: Load shared/references/audit_worker_core_contract.md.
MANDATORY READ: Load shared/references/audit_worker_core_contract.md.
{output_dir}/612-semantic-{doc-slug}.md (atomic single Write call)shared/references/audit_output_schema.mdVersion: 2.0.0 Last Updated: 2026-03-01
Weekly Installs
98
Repository
GitHub Stars
245
First Seen
Mar 1, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
cursor92
claude-code91
codex91
opencode90
github-copilot90
amp90
Skills CLI 使用指南:AI Agent 技能包管理器安装与管理教程
44,900 周安装
Context7 MCP:AI编程助手文档查询工具,实时获取最新代码库文档和API参考
598 周安装
Crucix 智能仪表板:自托管开源情报(OSINT)监控与实时数据可视化平台
649 周安装
Go依赖注入最佳实践:手动注入与库选择指南,提升代码可测试性与松耦合设计
685 周安装
Rust 所有权与生命周期指南:解决 E0382/E0597 等常见错误,优化内存管理设计
653 周安装
Chrome Bridge 自动化:Midscene 真实浏览器自动化工具,保留登录状态
657 周安装
Rust错误处理最佳实践指南:Result、Option、panic!与thiserror/anyhow使用技巧
663 周安装
| Architecture scope covers all layers |
docs/project/tech_stack.md | Stack scope matches project reality |
docs/project/api_spec.md | API scope covers all endpoint groups |
docs/project/database_schema.md | Schema scope covers all entities |
docs/project/design_guidelines.md | Design scope covers active components |
docs/project/infrastructure.md | Infrastructure scope covers all deployment targets |
docs/project/runbook.md | Runbook scope covers setup + operations |