活动需求文档智能检查

我会帮你分析活动需求文档的完整度和质量，确保文档符合标准要求。

🤖 AI 执行指令

当用户调用此 skill 时，请按照以下步骤执行：

步骤 1：获取文档内容

如果用户提供了文档路径，使用 Read 工具读取文档内容
如果用户直接粘贴了文档内容，直接使用
如果用户没有提供文档，询问用户提供文档路径或内容

步骤 2：执行全面检查

按照以下维度检查文档，记录所有发现的问题：

2.1 必填章节完整性检查

检查以下核心章节是否存在且有实质内容：

## **活动时间** 或 ## 活动时间 或 # 活动时间 （必填）
## **活动原型** 或 ## 活动原型 或 # 活动原型 （必填）
## **人员排期** 或 ## 人员排期 或 # 排期说明 （必填）
# 三、活动玩法说明 或类似的玩法说明章节（必填）
# 四、数值设计 或类似的数值设计章节（必填）

以下为可选章节（建议填写但不强制）：

## **活动名称** - 如果标题已包含活动名称可不单独设置
## **Figma** - 如果暂无设计稿可标注"待补充"
参考活动链接 - 全新玩法可不提供

判断标准：

❌ 核心必填章节不存在 → 记录"缺少必填章节：[章节名]"
⚠️ 必填章节存在但内容为空或少于10字符 → 记录"章节 '[章节名]' 内容为空或过于简单"
⚠️ 只有模板示例文本（"示意："、"复用页面："、"使用页面："、"待补充"等）→ 记录"章节 '[章节名]' 仅包含模板文本，未实际填写"
💡 可选章节缺失 → 仅作为建议提示，不计入问题数量

2.2 玩法表格检查

查找"活动玩法说明"相关章节下的玩法表格：

表头应包含核心列：目的、主题/主体、玩法介绍
可选列：序号、目标用户、设计参考、备注等

必填列检查（按重要性排序）：

玩法介绍 - 必填，需要详细说明玩法规则
目的 - 必填，需说明玩法目的（充值/消耗/活跃等）
主题/主体 - 必填，需说明玩法主题
目标用户 - 建议填写，如缺失仅作提示
序号 - 可选，表格清晰即可

判断标准：

❌ 表格不存在 → 记录"未找到玩法说明表格"
❌ 表格无数据行 → 记录"玩法说明表格没有任何数据行"
⚠️ 核心必填列（玩法介绍、目的、主题）为空 → 记录"玩法表格第 X 行缺少 '[列名]'"
💡 建议填写列（目标用户）为空 → 作为建议提示，不计入严重问题

2.3 内容质量检查

检查玩法介绍列的内容质量：

判断标准：

⚠️ 玩法描述少于15字 → 记录"玩法表格第 X 行的玩法介绍过于简单（少于15字）"
💡 提到"参考"但没有提供链接（不包含 http） → 仅作为建议提示"建议补充参考活动链接"，不计入严重问题
💡 缺少关键信息（奖励对象、保底规则、循环机制等）→ 作为优化建议提示

2.4 参考玩法库标准（可选）

如果需要，可以读取 references/ 目录下的玩法库文件，对比文档中的玩法描述是否包含了玩法库中定义的关键要素。

2.5 玩法风险分析 ⚠️

重要功能：深度分析文档中可能存在的风险项，帮助提前发现问题。

分析框架：

第一步：核心逻辑梳理 🔍

在进行风险分析前，先梳理文档的核心业务流程：

目标： 确保完整理解文档描述的玩法机制，避免误判 方法：

总结核心业务流程（用户如何参与、如何获得奖励）
识别关键节点（充值点、消耗点、奖励发放点）
绘制逻辑流程图（文字描述）

示例输出：

核心流程梳理：
1. 用户通过充值获得金币
2. 使用金币购买/赠送礼物（盲盒1888金币、礼盒666金币）
3. 礼物触发随机奖励（按概率表分配）
4. 累计消耗达标后获得额外奖励

第二步：逻辑漏洞与数值异常检查 🚨

这是风险分析的核心环节，重点识别可能导致严重问题的设计缺陷。

2.1 数值前后不一致检查

🔴 检查项：文档中同一数值在不同位置是否一致
示例问题：
- 玩法介绍说保底500次，数值设计表格写保底1000次
- 玩法说明写活动7天，时间表却是10天
判断标准：发现不一致 → 标记为高风险，要求明确

2.2 保底异常检查（重点）

🔴 过低风险：保底过低导致 ROI 异常高
- 检查：保底次数 × 单价 ÷ 奖励价值 < 1（用户必赚）
- 示例："稀有戒指价值50000，保底10次，单价100，用户仅花1000即可必得50000价值道具"
- 标准：保底成本应 ≥ 奖励价值的 2-3 倍
🔴 过高风险：保底过高导致用户参与意愿低
- 检查：保底 > 1000 次或成本过高（见上一版本标准）
- 示例："至高之境戒指保底1252个宝箱，成本833832金币"

2.3 概率异常检查（重点）

🔴 倒挂风险：高价值道具概率 > 低价值道具概率
- 检查：按价值排序，检查概率是否递减
- 示例："普通礼物（100金币）概率0.01%，稀有礼物（10000金币）概率0.05%" ❌
- 标准：价值越高，概率应越低
🔴 概率总和异常：所有概率加和 ≠ 100%
- 检查：奖池概率总和是否等于1（或100%）
- 示例："奖池概率总和为0.98，缺少2%兜底奖励" ⚠️

2.4 数量配置错误检查（重点）

🔴 高价值道具数量过多
- 检查：高价值奖励的数量配置
- 示例："顶级称号*10个，单个价值20000，总价值200000" ❌
- 标准：高价值道具通常数量为1，除非有特殊设计
🔴 奖励倍数错误
- 检查：奖励倍数是否合理
- 示例："充值100返还1000%（10倍）" ❌
- 标准：返还倍数通常 < 100%

2.5 逻辑闭环缺失

🔴 未明确的触发条件
- 示例："用户满足条件后可获得奖励"（什么条件？）
- 标准：所有触发条件必须明确可量化
🔴 奖励发放时机不明确
- 示例："活动结束后发放排行榜奖励"（具体几点？多久内？）
- 标准：发放时间必须精确到小时或明确说明"实时"
🔴 边界条件缺失
- 示例："用户可以重复参与"（有次数限制吗？有冷却时间吗？）
- 标准：必须说明限制条件

2.6 描述模糊/歧义

🟡 数值表达不清
- 示例："赠送约20%金币"（是20%还是约20%？范围是多少？）
- 标准：数值必须精确，不能用"约"、"大概"等模糊词
🟡 规则描述矛盾
- 示例：同一玩法在不同章节描述不一致
- 标准：同一规则在全文描述必须一致

第三步：多维度风险评估 ⚠️

3.1 业务风险

目标无法达成风险
- 🔴 返还率过高（>70%）→ 活动亏损，无法达成营收目标
- 🔴 返还率过低（<30%）→ 用户参与度低，无法达成流水目标
- 🟡 档位设置不合理 → 用户集中在某个档位，其他档位无人参与
负面舆情风险
- 🔴 极低概率未公示 → 可能涉嫌欺诈，引发投诉
- 🔴 中途修改规则 → 用户信任度下降
- 🟡 奖励价值感不足 → 用户吐槽"活动抠门"

3.2 风控/数值风险

被刷奖风险
- 🔴 保底过低+可循环 → 用户通过保底机制薅羊毛
- 🔴 接口无限制 → 可通过脚本刷接口获取奖励
- 🟡 多账号刷奖 → 需要风控策略（单设备限制、实名限制）
数值崩坏风险
- 🔴 通货膨胀 → 大量道具/金币发放导致经济系统失衡
- 🔴 稀有度失控 → 本应稀有的道具大量产出，价值归零
- 🟡 档位价值倒挂 → 高档位性价比低于低档位
ROI 异常风险
- 🔴 某个玩法ROI明显高于其他 → 用户只玩这一个，其他玩法无人参与
- 🟡 大R小R档位不明确 → 无法精准刺激不同用户群体

3.3 体验风险

操作门槛过高
- 🔴 玩法规则超过5步 → 用户理解困难，参与意愿低
- 🟡 操作路径过长 → 用户中途流失
交互设计混乱
- 🔴 多个系统交叉，用户不知道从哪里开始
- 🟡 奖励反馈不明确 → 用户不知道自己得到了什么
体验极差场景
- 🔴 无保底+极低概率 → 用户大量消费后一无所获
- 🔴 奖励延迟发放 → 用户以为没获得奖励

3.4 技术实现风险

🔴 新功能/复杂功能：实时推送、动态排行榜、复杂计算
🟡 性能风险：高并发场景、大数据量查询
🟢 复用现有功能：低风险

第四步：完善性评估 📋

评估文档是否足够支撑技术研发，识别描述不清晰的地方。

4.1 需求描述完整性

🔴 缺失的必要信息
- 触发条件不明确
- 奖励发放时机不明确
- 边界条件缺失（次数限制、时间限制）
- 异常情况处理（用户中途退出、网络异常等）
🟡 技术细节缺失
- 数据统计维度不明确
- 排行榜更新频率不明确
- 道具/奖励的ID未提供

4.2 可研发性评估

✅ 足够清晰：技术人员可直接开发，无需反复确认
⚠️ 需要补充：关键信息缺失，需要运营补充说明
❌ 无法研发：核心逻辑不清，无法开始开发

示例：

完善性评估：
✅ 玩法规则描述清晰，可直接开发
⚠️ 需补充：排行榜更新频率（实时？每小时？每天？）
⚠️ 需补充：达标奖励的xxx值未明确（需要运营提供具体数值）
❌ 致命问题：露台入场券获取方式描述矛盾（需明确是保底必得还是随机掉落）

第五步：改进建议 💡

针对发现的问题，给出具体、可执行的修改建议。

建议分级：

P0（必须解决）：影响业务目标或可能导致严重问题
P1（强烈建议）：影响用户体验或数值平衡
P2（可选优化）：优化建议，不解决也可上线

建议格式：

P0：调整盲盒返还比至45%-55%
  - 当前问题：返还比33.79%，明显偏低
  - 优化方案：增加中等价值奖励（1000-5000金币）的概率
  - 预期效果：提升用户参与意愿，增加流水

P1：降低至高之境戒指保底至500
  - 当前问题：保底1252个，成本过高
  - 优化方案：调整概率至0.0005（保底500）
  - 预期效果：增加用户获得感，降低投诉风险

风险分析输出格式：

⚠️ 玩法风险分析
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【步骤1：核心逻辑梳理】🔍

核心业务流程：
1. 用户充值获得金币
2. 使用金币参与玩法（礼物、盲盒、累消等）
3. 触发随机奖励/达标奖励
4. 排行榜奖励在活动结束后发放

关键节点识别：
• 充值点：充值优惠、礼包购买
• 消耗点：礼物赠送、盲盒购买、放大镜消耗
• 奖励点：随机奖励、累消奖励、达标奖励、排行榜奖励

------------------------------------------------------------

【步骤2：逻辑漏洞与数值异常】🚨

🔴 严重问题（必须修复）：
  • 【保底过高】至高之境戒指保底1252个，成本833832金币，远超价值
  • 【概率异常】威尔的宝箱概率总和为1.0002，超出100%（四舍五入误差）
  • 【数值不一致】达标奖励描述中xxx值未明确，需补充具体数值

⚠️ 中等问题（建议修复）：
  • 【返还率偏低】盲盒返还比33.79%，低于标准区间（40%-60%）
  • 【描述模糊】露台入场券获取方式有两种说法（保底必得 vs 随机掉落），需明确

💡 优化建议（可选）：
  • 【逻辑复杂】玩法页涉及6个系统联动，建议简化或增强引导

✅ 检查通过项：
  • 小礼物保底502个，合理
  • 小鹿戒指保底226个，合理
  • 威尔的宝箱概率按价值递减，符合规则

------------------------------------------------------------

【步骤3：多维度风险评估】⚠️

🔴 业务风险：
  • 盲盒返还率过低（33.79%）→ 用户参与意愿可能不足 → 影响流水目标
  • 极低概率（0.01%）未明确是否公示 → 可能引发投诉

🔴 风控/数值风险：
  • 至高之境戒指保底成本过高 → 实际获得用户极少 → 可能导致稀有度失控（其他途径产出）
  • 小礼物直接返还10% → 若无其他限制，可能被脚本刷

🟡 体验风险：
  • 玩法页系统复杂（6个联动系统）→ 用户理解困难
  • 盲盒4步链路（开盒→点亮→集齐→开箱）→ 操作门槛较高

🟡 技术实现风险：
  • NPC随机出现需实时推送 → 需确认技术可行性
  • 排行榜实时更新 → 可能有性能压力

------------------------------------------------------------

【步骤4：完善性评估】📋

✅ 描述清晰，可直接开发：
  • 玩法规则描述详细
  • 数值设计完整（概率、保底、ID等）
  • 奖励配置明确

⚠️ 需补充的信息：
  • 达标奖励的xxx值（需提供具体数值）
  • 排行榜更新频率（实时？每小时？）
  • NPC出现时间（随机时段还是固定时间？）
  • 露台入场券获取方式（需明确统一描述）

------------------------------------------------------------

【步骤5：改进建议】💡

P0（必须解决）：
  1. 补充达标奖励的具体数值（当前为xxx）
  2. 统一露台入场券获取方式描述（避免歧义）
  3. 降低至高之境戒指保底至500或提高概率

P1（强烈建议）：
  4. 调整盲盒返还比至45%-55%
     • 方案：增加中等价值奖励（1000-5000金币）的概率
     • 预期：提升用户参与度
  5. 简化玩法页系统复杂度
     • 方案：去掉NPC猜拳或达标奖励其中一个
     • 预期：降低开发难度和用户理解成本

P2（可选优化）：
  6. 累消增加中档过渡档位（10000-50000之间）
  7. NPC改为固定时间出现，降低技术实现难度
  8. 增强盲盒玩法的新手引导

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

步骤 3：计算星级评分

根据问题总数计算星级：

0 个问题 → ⭐⭐⭐⭐⭐ (5星) - 优秀
1-2 个问题 → ⭐⭐⭐⭐ (4星) - 良好
3-5 个问题 → ⭐⭐⭐ (3星) - 一般
6-10 个问题 → ⭐⭐ (2星) - 较差
10+ 个问题 → ⭐ (1星) - 不合格

步骤 4：输出检查报告

使用以下格式输出完整报告（包含文档完整性检查 + 玩法风险分析）：

============================================================
📋 活动需求文档质量检查报告
============================================================

【文档完整性检查】

[如果有问题]
发现 X 个问题：

  ❌ 缺少必填章节：活动原型
  ⚠️  章节 '人员排期' 内容为空或过于简单
  ⚠️  玩法表格第 2 行缺少 '玩法介绍'
  ...

[如果没有问题]
✅ 恭喜！文档完整性检查全部通过，未发现问题。

📊 完整度评分: ⭐⭐⭐ (3/5)

[评价建议]
💚 文档质量良好，可以继续推进。（4-5星）
💛 文档基本完整，建议修复标注的问题后再提交。（3星）
❤️  文档存在较多问题，请仔细检查并完善后再提交。（1-2星）

------------------------------------------------------------

【玩法风险分析】⚠️

[步骤1：核心逻辑梳理] 🔍
核心业务流程：
1. ...
2. ...

关键节点识别：
• 充值点：...
• 消耗点：...
• 奖励点：...

------------------------------------------------------------

[步骤2：逻辑漏洞与数值异常] 🚨

🔴 严重问题（必须修复）：
  • 【保底异常】xxx
  • 【概率异常】xxx
  • 【数值不一致】xxx

⚠️ 中等问题（建议修复）：
  • 【返还率】xxx
  • 【描述模糊】xxx

💡 优化建议（可选）：
  • 【逻辑复杂】xxx

✅ 检查通过项：
  • xxx合理
  • xxx符合规则

------------------------------------------------------------

[步骤3：多维度风险评估] ⚠️

🔴 业务风险：
  • xxx → 影响业务目标

🔴 风控/数值风险：
  • xxx → 可能被刷奖
  • xxx → 数值崩坏

🟡 体验风险：
  • xxx → 用户体验差

🟡 技术实现风险：
  • xxx → 需确认可行性

------------------------------------------------------------

[步骤4：完善性评估] 📋

✅ 描述清晰，可直接开发：
  • xxx

⚠️ 需补充的信息：
  • xxx（需明确）
  • xxx（需补充）

------------------------------------------------------------

[步骤5：改进建议] 💡

P0（必须解决）：
  1. xxx
     • 当前问题：xxx
     • 优化方案：xxx
     • 预期效果：xxx

P1（强烈建议）：
  2. xxx
     • 方案：xxx
     • 预期：xxx

P2（可选优化）：
  3. xxx

============================================================

步骤 5：提供改进建议

在报告后，提供具体的改进建议：

针对发现的每个问题，说明如何修复
如果涉及玩法描述，可以参考玩法库给出示例
如果用户需要，可以提供修改后的文档片段

工作流程

当你调用此 skill 时，我会：

1. 获取文档内容

首先，请提供文档路径或直接粘贴文档内容。我会：

如果提供路径：使用 Read 工具读取文档
如果直接提供内容：直接进行分析

2. 执行全面检查

我会从以下维度分析你的文档，并输出详细的质量报告：

发现的所有问题列表
问题分类（缺失、不完整、质量问题）
星级评价（1-5星）
具体改进建议

3. 分析检查维度

我会从以下维度全面检查你的文档：

a) 必填章节完整性

检查以下核心章节是否存在且有实际内容：

活动时间：是否明确了时间范围和时区 ✅ 必填
活动原型：是否提供了原型链接 ✅ 必填
人员排期：是否有排期信息或截图 ✅ 必填
活动玩法说明：是否有玩法表格 ✅ 必填
数值设计：是否有数值配置内容 ✅ 必填

以下为可选章节：

活动名称：如果标题已包含活动名称可不单独设置
Figma：如果暂无设计稿可标注"待补充"

我会识别的问题：

❌ 必填章节完全缺失
⚠️ 必填章节存在但内容为空或过于简单
⚠️ 只有模板示例文本（如"示意："、"复用页面："、"待补充"），没有实际填写
💡 可选章节缺失 - 仅作建议，不计入严重问题

b) 玩法表格必填列检查

检查活动玩法说明表格的核心列是否填写：

必填列（按重要性排序）：

玩法介绍 ✅ 必填 - 需要详细说明玩法规则
目的 ✅ 必填 - 需说明玩法目的（充值/消耗/活跃等）
主题/主体 ✅ 必填 - 需说明玩法主题

建议填写列：

目标用户 💡 建议 - 如缺失仅作提示
序号 💡 可选 - 表格清晰即可

我会识别的问题：

❌ 表格不存在或格式错误
⚠️ 核心必填列（玩法介绍、目的、主题）为空
💡 建议填写列为空 - 仅作提示，不计入严重问题

c) 描述完整性和质量

检查玩法介绍内容的详细程度：

描述长度：玩法描述是否足够详细（至少 15 字）
参考活动：提到参考活动时是否提供了链接（可选，全新玩法可不提供）
关键信息：是否包含规则、奖励、条件等关键信息
奖励说明：奖励的对象、保底描述是否清晰
保底机制：保底的计数和关联对象是否描述清楚

我会识别的问题：

⚠️ 玩法描述过于简单（少于15字）
💡 提到参考但未提供链接 - 仅作建议，不计入严重问题
💡 缺少关键信息（奖励对象、保底规则等） - 作为优化建议

d) 玩法风险分析 ⚠️ NEW!

这是 v2.0 新增的核心功能，我会深度分析文档中可能存在的风险项。

五步风险分析框架：

步骤1：核心逻辑梳理 🔍

总结核心业务流程
识别关键节点（充值点、消耗点、奖励点）
确保完整理解玩法机制

步骤2：逻辑漏洞与数值异常检查 🚨 （重点）

✓ 数值前后不一致检查
✓ 保底异常检查（过低/过高）
✓ 概率异常检查（倒挂/总和异常）
✓ 数量配置错误检查
✓ 逻辑闭环缺失检查
✓ 描述模糊/歧义检查

步骤3：多维度风险评估 ⚠️

🔴 业务风险：目标无法达成、负面舆情
🔴 风控/数值风险：被刷奖、数值崩坏、ROI异常
🟡 体验风险：操作门槛高、交互混乱
🟡 技术实现风险：新功能、性能问题

步骤4：完善性评估 📋

评估文档是否足够支撑技术研发
识别需求描述不清晰的地方
判断可研发性（足够清晰/需补充/无法研发）

步骤5：改进建议 💡

P0（必须解决）：影响业务目标或导致严重问题
P1（强烈建议）：影响体验或数值平衡
P2（可选优化）：优化建议

4. 输出检查报告

我会输出结构化的质量报告，格式如下：

============================================================
📋 活动需求文档质量检查报告
============================================================

发现 3 个问题：

  ❌ 缺少必填章节：活动原型
  ⚠️  章节 'Figma' 内容为空或过于简单
  💡 玩法表格第 2 行提到参考但未提供链接

📊 完整度评分: ⭐⭐⭐ (3/5)

💛 文档基本完整，建议修复标注的问题后再提交。

============================================================

5. 参考玩法库标准

我会使用 references/ 目录下的玩法库作为玩法描述的参考标准。玩法库包含 150+ 种实际使用的活动玩法，全部来自真实活动案例。

在分析玩法介绍时，我会参考玩法库中的标准描述模板，评估你的玩法描述是否包含了必要的关键要素。

玩法库文件结构：

references/
├── README.md                               # 玩法库使用说明
├── 玩法库索引.md                            # 📑 完整索引（150+种）
├── WP活动玩法库_👉玩法汇总_玩法汇总表.csv   # 原始数据
├── 储值优惠类.md                            # 充值优惠相关（10种）
├── 爆礼物玩法类.md                          # 礼物消耗相关（30+种）
├── 抽奖类玩法.md                            # 抽奖相关玩法
├── 任务活动类.md                            # 任务活动相关
└── [你的分类].md                            # 可自行添加

玩法库内容：

玩法库按类别组织，每个分类文件包含：

该分类的所有玩法列表
每个玩法的标准描述模板
关键要素清单（玩法描述必须包含的信息）
活动文档和 Figma 参考链接
常见问题解答

示例（储值优惠类标准模板）：

### 固定储值优惠

**标准描述模板：**
储值任意金币再赠送 20% 金币，不做挡位区分。储值金币返还比例如下：
- 首次储值：赠送 30% 金币
- 二次储值：赠送 25% 金币
- 三次储值及以后：赠送 20% 金币

奖励自动发放到账户，活动期间可重复参与。
参考活动：2024年春节充值活动

**关键要素：**
- ✅ 赠送比例（首次、二次、后续）
- ✅ 是否区分档位
- ✅ 是否可重复参与
- ✅ 奖励发放方式
- ✅ 参考活动链接

6. 星级评价标准

星级基于发现的问题数量：

星级	问题数量	评价	建议
⭐⭐⭐⭐⭐	0 个	优秀	文档质量良好，可以提交
⭐⭐⭐⭐	1-2 个	良好	文档质量良好，可以继续推进
⭐⭐⭐	3-5 个	一般	文档基本完整，建议修复标注问题后再提交
⭐⭐	6-10 个	较差	文档存在较多问题，请仔细检查并完善
⭐	10+ 个	不合格	文档存在严重问题，需要大幅修改

典型使用场景

场景 1：提交前自查

用户： 请帮我检查这个活动需求文档：/path/to/my_activity_doc.md

我会：

读取文档内容
执行全面检查
输出详细的质量报告
提供具体的改进建议

你可以根据报告修复问题后，再次让我检查，直到达到 4-5 星评级。

场景 2：评审他人文档

用户： 分析一下这份需求文档的质量

我会：

分析文档的完整度和质量
列出所有发现的问题
评估每个问题的严重程度
给出星级评价和改进建议

你可以将报告发送给文档作者，指出需要改进的地方。

场景 3：对比分析

用户： 这份文档比上次的改进了吗？

我会：

检查当前文档
如果你提供了历史版本，我可以对比分析
说明改进的地方和仍需优化的部分

如何使用此 Skill

方式一：提供文档路径

直接告诉我文档的路径：

请检查这个文档：/Users/xxx/documents/activity_doc.md

方式二：直接粘贴内容

如果文档内容不长，可以直接粘贴：

帮我检查这份文档：

# 【模板】活动方案（新）
...（文档内容）

方式三：多个文档对比

如果需要检查多个文档或版本对比：

请分别检查这两个文档，并对比它们的质量：
1. /path/to/doc_v1.md
2. /path/to/doc_v2.md

扩展玩法库

如果你发现某类玩法在玩法库中缺少标准模板，可以扩展玩法库：

方式一：在现有分类中添加玩法

在对应的分类文件（如 储值优惠类.md）底部添加新玩法模板。

方式二：创建新的分类文件

如果需要创建全新的玩法分类：

在 references/ 目录创建新文件：[分类名称]类.md
参考其他分类文件的格式编写
在 references/README.md 中添加说明
告诉我，我会在检查时参考新的分类

常见问题

Q: 我的章节明明有内容，为什么报告说"内容为空"？ A: 我会识别并过滤掉模板示例文本（如"示意："、"复用页面："、"使用页面："等）。如果章节只有这些文本而没有实际内容，会被标记为空。请添加实际的活动信息。

Q: 玩法表格看起来正常，为什么检查失败？ A: 请确保表格符合以下要求：

表头必须包含"序号"列
使用标准 markdown 表格格式（用 | 分隔）
每行至少有 7 列（序号、目标用户、目的、主题、玩法介绍、设计参考、备注）
必填列（序号、目标用户、目的、主题、玩法介绍）不能为空

Q: 如何快速提高星级评分？ A: 按照我的报告逐一修复问题：

优先处理 ❌ 标记的问题（缺失章节）- 这些是最严重的
然后处理 ⚠️ 标记的问题（内容为空或不完整）
最后处理 💡 标记的建议（质量改进）
参考玩法库丰富玩法描述内容
添加参考活动链接提高可信度

Q: 可以自定义检查标准吗？ A: 可以。检查标准主要在 SKILL.md 中定义。你可以：

修改必填章节列表
调整玩法描述的最小长度要求（默认 15 字）
修改星级评价的问题数量阈值
告诉我你的定制需求，我会按新标准检查

Q: 如果我的文档格式与模板不完全一致怎么办？ A: 我会尽量适应不同的文档格式，但为了最佳检查效果，建议：

章节标题尽量与模板保持一致
玩法表格的列名和顺序参考模板
如果格式差异较大，告诉我你的文档结构，我会相应调整检查方式

技术说明

我的分析能力：

理解 Markdown 格式文档
识别章节结构和表格格式
评估内容完整度和质量
参考玩法库标准进行对比分析
提供结构化的检查报告

支持的文档格式：

Markdown (.md) 文件
UTF-8 编码
符合活动需求文档模板结构
兼容各种 Markdown 变体格式

检查逻辑： 我会按照 scripts/check_document.py 中定义的规则进行检查，同时结合对文档内容的理解，提供更智能和人性化的分析。如果需要，我也可以直接运行 Python 脚本进行检查。

activity-doc-checker

活动需求文档智能检查

🤖 AI 执行指令

步骤 1：获取文档内容

步骤 2：执行全面检查

2.1 必填章节完整性检查

2.2 玩法表格检查

2.3 内容质量检查

2.4 参考玩法库标准（可选）

2.5 玩法风险分析 ⚠️

第一步：核心逻辑梳理 🔍

第二步：逻辑漏洞与数值异常检查 🚨

第三步：多维度风险评估 ⚠️

第四步：完善性评估 📋

第五步：改进建议 💡

步骤 3：计算星级评分

步骤 4：输出检查报告

步骤 5：提供改进建议

工作流程

1. 获取文档内容

2. 执行全面检查

3. 分析检查维度

a) 必填章节完整性

b) 玩法表格必填列检查

c) 描述完整性和质量

d) 玩法风险分析 ⚠️ NEW!

4. 输出检查报告

5. 参考玩法库标准

6. 星级评价标准

典型使用场景

场景 1：提交前自查

场景 2：评审他人文档

场景 3：对比分析

如何使用此 Skill

方式一：提供文档路径

方式二：直接粘贴内容

方式三：多个文档对比

扩展玩法库

方式一：在现有分类中添加玩法

方式二：创建新的分类文件

常见问题

技术说明