القائمة
LLM-as-Judge 文档质量评估 Skill。利用大模型对 PRD 和架构文档进行深层语义质量评估，超越结构 Lint 检测「写了但写得不好」的问题。触发条件：(1) 文档质量评估/评审，(2) LLM-as-Judge，(3) PRD 语义审查，(4) 架构文档深度评审，(5) doc-quality-judge，(6) 文档语义评分。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
工作流度量仪表盘 Skill。一条命令扫描 pm-assistant 项目目录的本地产物（gate-results JSON、PRD 文档、wireframes、hifi-wireframes），生成含 Chart.js 图表的自包含 HTML 仪表盘（dashboard.html）。展示：7 阶段流程进度时间轴、产物统计卡片（Module PRD 数 / 低保真原型数 / 高保真原型数 / Gate 评审轮次）、Gate 评审雷达图 + 堆叠条形图（pass/warn/fail）、待改进事项清单。触发条件：(1) 查看/生成项目指标或度量，(2) 生成工作流仪表盘，(3) 可视化 Gate 评审结果，(4) 流程健康检查，(5) 产物覆盖率统计，(6) 生成 dashboard，(7) 查看评审进度或产物状态。
文档质量 Lint 检查 Skill。对 PRD、架构文档进行结构化 Lint 检查，自动生成需求追溯矩阵（RTM），追踪 Gate Warning 闭环。触发条件：(1) PRD Lint/文档检查，(2) 架构文档 Lint，(3) 生成 RTM/需求追溯矩阵，(4) Warning 追踪/扫描，(5) 文档质量检查，(6) Gate 预检，(7) doc-lint。
通过飞书远程 MCP 服务查询和操作飞书云文档。支持搜索文档、读取文档内容、创建/更新文档、查看知识库目录、获取评论等。触发条件：(1) 查询飞书文档，(2) 搜索飞书云文档内容，(3) 读取飞书文档/知识库，(4) 创建或更新飞书文档，(5) 同步飞书文档内容到本地，(6) 查看飞书文档评论。
工作流度量仪表盘 Skill。一条命令扫描 pm-assistant 项目目录的本地产物（gate-results JSON、PRD 文档、wireframes、hifi-wireframes），生成含 Chart.js 图表的自包含 HTML 仪表盘（dashboard.html）。展示：7 阶段流程进度时间轴、产物统计卡片（Module PRD 数 / 低保真原型数 / 高保真原型数 / Gate 评审轮次）、Gate 评审雷达图 + 堆叠条形图（pass/warn/fail）、待改进事项清单。触发条件：(1) 查看/生成项目指标或度量，(2) 生成工作流仪表盘，(3) 可视化 Gate 评审结果，(4) 流程健康检查，(5) 产物覆盖率统计，(6) 生成 dashboard，(7) 查看评审进度或产物状态。
技术架构设计 Skill。根据产品需求文档（PRD）设计完整的技术架构方案，输出结构化的架构设计文档。覆盖技术栈选型、系统架构、数据模型、API 设计、部署方案、非功能需求、安全设计等。触发条件：(1) 设计技术架构，(2) 从 PRD 推导技术方案，(3) 系统设计/技术选型，(4) 数据库设计，(5) API 设计，(6) 部署架构设计。
代码审查规范 Skill。对代码进行系统化审查，按 MUST/SHOULD/NIT 三级分类输出审查意见，覆盖正确性、安全性、可维护性、性能、规范性五大维度。触发条件：(1) 代码审查/Code Review，(2) PR Review/Pull Request 审查，(3) 审查代码质量，(4) MUST/SHOULD/NIT 分级审查，(5) 代码走查，(6) 审查这个 PR。
| name | doc-quality-judge |
| description | LLM-as-Judge 文档质量评估 Skill。利用大模型对 PRD 和架构文档进行深层语义质量评估，超越结构 Lint 检测「写了但写得不好」的问题。触发条件：(1) 文档质量评估/评审，(2) LLM-as-Judge，(3) PRD 语义审查，(4) 架构文档深度评审，(5) doc-quality-judge，(6) 文档语义评分。 |
利用大模型对 PRD 和架构文档进行深层语义质量评估。与 doc-lint 互补：doc-lint 检查结构完整性（写了没有），本 Skill 评估内容质量（写得好不好）。
| 维度 | 权重 | 评估要点 |
|---|---|---|
| 目标清晰度 | 20% | 背景与目标是否明确、可衡量（SMART） |
| 用户故事质量 | 20% | Persona 是否具体、AC 是否可测试 |
| 需求完整性 | 20% | 功能列表无遗漏、非功能需求有量化指标 |
| 优先级合理性 | 15% | RICE 评分是否与业务价值一致 |
| 可追溯性 | 15% | 需求→模块→架构→Issue 链路清晰 |
| 一致性 | 10% | 术语、版本号、状态在各文档间一致 |
| 维度 | 权重 | 评估要点 |
|---|---|---|
| 技术选型合理性 | 20% | 选型理由充分、与业务规模匹配 |
| 架构完整性 | 20% | 系统图覆盖所有组件、无孤岛模块 |
| 数据模型质量 | 20% | ER 图规范、字段类型明确、索引策略 |
| API 设计质量 | 15% | RESTful 规范、错误码完整、版本策略 |
| 安全设计 | 15% | 认证授权方案、数据保护、审计日志 |
| 运维友好度 | 10% | 监控方案、部署策略、容灾设计 |
# 先运行结构 Lint，获取基线数据
node .github/skills/doc-lint/scripts/prd-lint.js <project>
node .github/skills/doc-lint/scripts/arch-lint.js <project>
Agent 读取以下文件进行评估：
prd-{project}.md 或 architecture-{project}.mdgate-results/prd-lint-*.json 或 gate-results/arch-lint-*.jsongate-results/rtm-*.json（如已生成）modules/prd-*.md（如存在）输出到 projects/prd-{PROJECT}/gate-results/quality-judge-{date}.md，格式：
# 文档质量评估报告 — {project}
> **评估日期**：{date}
> **评估类型**：PRD / 架构 / 全量
> **总分**：{score}/100
## 维度评分
| 维度 | 权重 | 得分 | 等级 | 关键发现 |
|------|------|------|------|---------|
| ... | ... | .../10 | A/B/C/D | ... |
## 关键发现
### 🔴 阻断问题 (必须修复)
1. ...
### 🟡 改进建议 (强烈建议)
1. ...
### 🟢 优化建议 (可选)
1. ...
## 与结构 Lint 结果对比
| 检查类型 | 结果 | 说明 |
|----------|------|------|
| prd-lint | X pass / Y warn / Z fail | ... |
| LLM 评估 | 总分 N/100 | ... |
| 差异 | Lint 通过但语义不足的项 | ... |
| 等级 | 分数范围 | 含义 |
|---|---|---|
| A | 90-100 | 优秀，可直接提交 Gate |
| B | 75-89 | 良好，少量改进后可提交 |
| C | 60-74 | 合格，需明确改进计划 |
| D | <60 | 不合格，需重大修改 |
| 工具 | 关系 |
|---|---|
doc-lint | 互补 — doc-lint 检查结构，本 Skill 评估语义 |
gate_review | 前置 — 本 Skill 结果作为 Gate Review 参考输入 |
pm_workflow_evaluator | 数据源 — Dim5 需求质量信号引用评分 |
code-review | 平行 — 代码审查 Skill，本 Skill 聚焦文档审查 |