1实现原理 · 为什么它能做到

整个 skill 零自有代码：能力全部由 Playwright MCP 的浏览器工具 + SKILL.md 的流程指令构成，仓库里唯一的『运行时』是 .mcp/settings.json 声明的 MCP server。

.mcp/settings.json

{ "playwright": { "command": "npx", "args": [ "@playwright/mcp@latest" ] } }

这里在做什么：把 @playwright/mcp 注册成宿主可用的工具服务器，于是 agent 获得浏览器导航/快照/点击/输入能力；skill 正文只是调用规范（browser_navigate / browser_snapshot / browser_click / browser_type / browser_wait_for）。仓库内无 .py/.js 脚本，全部文件为 markdown/json/png。

主流程是写死的 8 步状态机：检查当日 tracking 文件 → 选 subreddit → 浏览新帖选帖 → 深读帖与已有评论 → 写评论 → 16 项个性化复审循环 → 发帖 → 判线索 + 记账。

.claude/skills/reddit-commenter/SKILL.md

1. Check today's date file in tracking/reddit/ folder → File name: YYYY-MM-DD.md (e.g., 2026-01-12.md) → If file doesn't exist, create new one referencing template.md

步骤边界显式编号（Step 1..Step 8），并在 Step 7/8 分别接 leads/reddit.md 与 tracking/reddit/[date].md，形成可审计闭环。

配额与节奏由文档硬编码：每个 subreddit 每日 3 条、同 subreddit 评论间隔至少 5-10 分钟，批量模式总配额 24 条（8×3），并规定了限流/掉登录的处置。

.claude/skills/reddit-commenter/BATCH.md

- Total 24 (8 subreddits × 3) - Subtract today's written comments - Remaining quota = 24 - Today's written comments

BATCH.md 另有 '[4] Move to next subreddit (wait 5-15 minutes)' 与错误表『Rate limit detected → Wait 30 min then resume』『Login session expired → Stop batch, notify user』。这是把『反封号节奏』写进提示词的典型做法，而非代码层面的限流器。

『像人写的』靠一份 16 项个性化清单 + 8 种句式模板 + 长度分布强制配额来逼近，而不是靠模型自由发挥。

.claude/skills/reddit-commenter/resources/personalization_reddit.md

### Length Distribution (Required) For daily activity (e.g., 24 comments): - **Short (1-2 sentences)**: Minimum 30% = 7-8 - **Medium (3-5 sentences)**: About 50% = 12 - **Long (6+ sentences)**: Maximum 20% = 4-5

清单第 14 项是 'AI detection prevention'，并有专节列出要避开的 AI 腔模式（统一长度、每帖必以问句结尾、对梗帖做严肃技术分析）。发帖前还有一次『把最近 10 条评论并排看』的自检。

内容真实性靠两条硬约束兜住：必须先深读原帖（禁止只看关键词判断），若评论涉及对方站点则必须真的用浏览器访问后再写反馈。

.claude/skills/reddit-commenter/SKILL.md

• Visit actual site with browser_navigate(provided link) • Check UI/UX with browser_snapshot() • Write feedback based ONLY on what you actually saw • Absolutely NO speculative feedback on things you didn't see

同文件 Cautions 第 6 条回扣：'⚠️ Step 3 Required: NEVER write comment without analyzing post content. Judging only by keywords can cause serious errors'。

商业目的内建：Step 7 按 leads/reddit.md 的『Lead Selection Criteria』把发帖人判成高/中/低相关线索并计入线索表；resources/product.md 提供产品话术模板（价值主张、痛点、竞品对比、自然推广措辞）。

leads/reddit.md

## Lead Selection Criteria ### High Relevance - Directly mentions your product category - Complains about problems your product solves

README 自述定位即营销自动化：'A marketing automation framework using Claude Skills and Playwright MCP for authentic community engagement.' + '- **Identifies leads** automatically based on your product fit'。

token 纪律写进 skill：调用 MCP 只传最少指令、直接按 URL 导航而不是点元素、且明令禁止截图（快照用无障碍树）。

.claude/skills/reddit-commenter/SKILL.md

**⚠️ No screenshots**: Do NOT use `browser_take_screenshot`. Always use only `browser_snapshot` for page verification (accessibility tree is sufficient and doesn't save files)

配套资源按步引用（'| `resources/personalization_reddit.md` | Step 5 (review) |'，并注 '→ Reference only at relevant Step, don't read in advance'），用文件引用代替把全部规则塞进上下文。

2核心能力

01用浏览器登录态在 Reddit 发评论（单条模式：选帖→深读→写→复审→发→记账）

02批量模式：按剩余配额跨 subreddit 连续执行，含进度报告与终止条件

03文风复刻：16 项清单 + 8 种句式模板 + 长度分布配额，要求读起来像本人所写

04反 AI 检测：显式列出 AI 腔模式并禁止（统一长度、每帖必问句、过度积极、商业黑话）

05按帖子性质分流回复策略（幽默帖轻回、求助帖给方案、讨论帖表态），不套统一模板

06问答意图分类（求经验/求方法/求观点/求排障）与站点实证要求

07去重与防重复：禁止同日对同一帖二次评论，并通过当日 tracking 的 URL 列表校验

08活动记账与线索沉淀（tracking/reddit/YYYY-MM-DD.md、leads/reddit.md，含评论全文与 permalink）

3外部依赖

Kind	Dependency / Endpoint
package	@playwright/mcp
network	Reddit（列帖与导航）
network	Reddit（rising 列表）
network	帖子内 OP 提供的外部站点（被要求真访问以给出实证反馈）
package	claude（npm，^0.1.1）

4管控建议与判定依据

建议配套管控措施

面向 Agent

隔离环境，逐次授权

面向管理者

严格授权、全量审计、合规确认

判定依据（文件路径与关键语句摘要）

本地凭据 / 浏览器配置: 读取用户登录 Cookie/会话/密钥环: 隐式：Playwright MCP 以本机持久化浏览器 profile 驱动，Reddit 登录态（浏览器 cookie/会话）被复用；SETUP.m
scripts/: 执行本地脚本或命令: 仓库本身无脚本（全仓为 md/json/png）；运行时由宿主启动 MCP server：npx @playwright/mcp@latest（.mc
scripts/ 或 SKILL.md: 声明动态安装外部语言包依赖
网络端点: 声明外部网络访问: https://www.reddit.com/r/{subreddit}/new|rising/（列帖）
本地工作目录: 文件读写与工件输出: tracking/reddit/YYYY-MM-DD.md（创建当日文件并追加：活动表 + 评论全文 + permalink）

审计说明： 。按统一分档：本 skill 通过 Playwright MCP 复用本机浏览器的 Reddit 登录态并在真实社区公开发帖，属『涉及凭证/cookie 读取 + 外部副作用不可逆』；外发对象为 reddit.com 及帖内任意第三方链接（不可预期）；同时内建规避平台 AI 检测与线索挖掘（营销用途）。自身无脚本、无网络库、无密钥硬编码，故不因供应链或代码执行升档；橙色来自实际接触面（登录态 + 公开发帖 + 反检测意图）。

5第二遍独立确认

[ok] 仓库零脚本、能力来自 Playwright MCP — git ls-tree -r 全量仅 .claude/skills/reddit-commenter/{SKILL.md,BATCH.md,resources/*.md}、README/SETUP/QUICK_REFERENCE/CONTRIBUTING/CHANGES/LICENSE、.mcp/settings.json、package.json(-lock)、leads/reddit.md、tracking/reddit/template.md、assets/og_image.png、.github 模板；无任何可执行脚本。
[ok] MCP server 声明与 SKILL.md 工具名一致 — .mcp/settings.json 注册 playwright/@playwright/mcp@latest；SKILL.md 使用 browser_navigate/browser_snapshot/browser_click/browser_type/browser_wait_for，并显式禁用 browser_take_screenshot，SETUP.md 另确认 'This installs the Playwright MCP server.'。
[ok] 每社区每日 3 条 + 5-10 分钟间隔 — SKILL.md Step 1 'Check subreddits under daily limit (3)'、'Check last comment time (minimum 5-10 minute intervals)'；BATCH.md 配额公式 24=8×3 与 '[4] ... (wait 5-15 minutes)' 存在（两文件对等待区间的措辞略有差异：5-10 vs 5-15）。
[ok] 16 项个性化清单与 8 种句式模板 — personalization_reddit.md 内 '## Personalization Checklist (16 Items)' 表逐项 1-16（含 #14 AI detection prevention、#16 Site verification），'## 8 Style Patterns' 1-8 节均存在；SKILL.md Step 5 要求逐项检查。
[ok] 反 AI 检测 / 反重复结构 — 原文 '## Avoid Repetitive Structure (CRITICAL)'、'Repeating this structure makes it look AI-generated'、'## AI-Like Comment Prevention (CRITICAL)' 与长度分布配额均逐字存在。
[ok] 『先看帖再写』与『真访问站点』两条真实性约束 — Step 3 全段（含 'Absolutely NO speculative feedback on things you didn't see'）与 Cautions 第 6 条一致，无夸大。
[ok] 无凭证/密钥硬编码 — 全仓关键词扫描仅 3 处无关命中（MCP token 优化、Login Required、CONTRIBUTING 的 credential 讨论）；无 .env、无 API key 常量。
[discrepancy] 登录态来源（凭证面）最终定性 — 第一遍曾想写『无凭证读取』，第二遍修正：skill 文件确实不读密钥，但 SETUP.md 要求账号已在本机浏览器登录、BATCH.md 专门处理 'Login session expired'，说明运行时依赖浏览器登录态（cookie 级）。故按『凭证据实接触』定档 orange，并在 credential_reads 以『隐式复用浏览器登录态』如实记录，而非直报『无』。

6结论

流程工程化程度高：8 步固定流水线 + 批量状态机 + 配额/间隔/错误处置表，把『随性发评论』变成可重复执行、可记账的操作。

文风复刻做得细：16 项清单 + 8 种句式模板 + 长度分布强制配额 + 发帖前『最近 10 条并排看』自检，是目前开源社群里少见的系统化反 AI 腔设计。

有真实性底线：禁止只看关键词判断帖意、禁止对没看过的站点编造反馈、禁止同帖重复评论。

token 与上下文经济：MCP 调用只传最小指令、按 URL 直连、禁截图用无障碍树；资源文件按步懒加载。

开源化脱敏干净：个人资料、公司产品文件、真实活动日志、个人文风文件均已删除并替换为模板，使用者拿到的是可复用骨架。

适合： 适合：已有明确产品/话题、希望以『每个社区少量、真实风格』参与讨论的个人开发者或小团队，用它把『每天挑几帖、按自己语气认真回』的重复劳动流程化；也适合想研究『如何把个人文风编码进 prompt』的 skill 作者参考其 16 项清单与 8 种句式模板设计。使用前应先按 README/SETUP 把 personalization/subreddits/product 换成自己的真实资料，并在隔离的浏览器 profile 里运行。

不适合： 不适合：想批量刷量、跨大量社区扩音的场景（BATCH 配额上限 24/日，且 skill 明确禁止复制粘贴与同帖重复）；不能在未授权的情况下代他人账号运行（需要真实登录态，行为可追溯到账号所有者）；不适合把『合规』交给 skill 的团队——它不检查平台规则变化、不保证内容真实，且设计上就是要绕过 AI 检测；不适合期望有代码级沙箱/审计的工程环境（无脚本，全部行为经宿主与 MCP）。

Install Agent-Ready

① Verified Mirror 2026-09-15

Option A · Direct DownloadDownload auto-commenter.tar.gz

sha256: 31277b2a576dd188…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit e7fdda137e.