Skip to content

xinetzone/SpecWeave / .agents/skills/forum-posting

forum-posting

Verified

Discourse论坛(forum.trae.cn)自动化操作。当用户需要发帖、编辑帖子、更新帖子、回复帖子、跟帖、发布论坛内容、清理草稿、读取帖子、操作forum.trae.cn、使用forum-bot脚本时,必须使用此技能。支持双方案:forum-bot.py(Playwright脚本,本地/CI首选,支持dry-run预览、幂等检查、登录持久化)和integrated_browser MCP(IDE内即时操作,零配置)。覆盖读取、编辑替换、开头追加(如日期标记)、回复、清理草稿全流程。不要手动拼接浏览器操作——本Skill封装了双方案选择逻辑和安全防线。

论坛发帖与维护 (Forum Posting)

⚠️ 本Skill是命令入口门面(L1索引层),遵循渐进式披露三层架构:

  • L0:.agents/ONBOARDING.md(入口速查)
  • L1:本文件(<200行,触发词+决策树+核心步骤+安全清单)
  • L2:forum-automation.md(DOM选择器+JS函数+完整MCP步骤+故障排查)

1. Skill ID

forum-posting

2. 功能描述

操作 forum.trae.cn(Discourse 论坛)的技能,提供双方案支持,由技能根据场景自动选择,也可由用户指定:

方案推荐场景优势
forum-bot.py⭐ 独立运行/命令行/CI,需要 dry-run 预览登录持久化、幂等检查、自动重试、完善日志
integrated_browser MCP⭐ Trae IDE 内即时操作零配置、复用浏览器已登录状态、可交互调试

核心功能:读取帖子、编辑正文(完整替换)、开头追加(如更新日期标记)、发布回复、清理草稿。

为什么双方案? forum-bot.py 适合可重复、可验证的操作(推荐写操作先用它 dry-run);MCP 适合 IDE 内快速交互式操作。两者覆盖不同使用场景,不冲突。

3. 何时使用本技能

当用户提到以下任何内容时触发:

  • "发帖"、"发布"、"更新论坛"、"更新帖子"、"编辑帖子"、"修改帖子"
  • "回复帖子"、"跟帖"、"发布回复"、"清理草稿"、"删除草稿"
  • "读取帖子"、"查看帖子"、"forum-bot"、"Playwright脚本"
  • 任何涉及 forum.trae.cn 的操作请求

关于触发:即使没有明确说"用 skill",只要涉及论坛操作就应该使用本技能,不要自己手动拼接浏览器操作。

4. 方案选择决策树

需要操作论坛?
├─ 在 Trae IDE 内临时操作、浏览器已登录? → MCP方案(第5节核心步骤)
├─ 需要独立运行/命令行/CI/dry-run预览? → forum-bot.py方案(第6节命令速查)
└─ 首次使用未登录? → 先 forum-bot.py login 保存状态

⚠️ 强制:触发时记录输入参数日志

决策前输出CMD_START日志(session前缀 forum-YYYYMMDD-<topic>):

[CMD-LOG] | level=INFO | cmd=forum-posting | step=S0 | event=CMD_START | session=forum-... | msg=开始论坛操作:<操作类型> <topic_id/URL> | ctx={"operation":"...","topic_id":"...","method":"auto/script/mcp","dry_run":true/false}

为什么决策前必须记录日志? 论坛帖子一旦发布对外可见,双方案选择(script vs MCP)和dry-run决策直接影响安全性。CMD_START记录原始参数,操作失误后可回溯"当时选了什么方案、有没有开dry-run"。

写操作(编辑/回复)原则:优先使用 forum-bot.py 的 --dry-run 预览内容,确认无误再正式执行。

为什么 dry-run 是最重要的安全防线? 论坛帖子一旦发布就对外可见,错误的编辑或回复无法"悄悄撤销"——修改会被记录为编辑历史,删除也会留下痕迹。dry-run 在完全不提交的情况下展示完整内容,是成本最低的防误操作手段。MCP 方案无内置 dry-run,必须先向用户展示 diff 并获得明确确认。

5. 核心步骤(快速开始)

步骤1:读取L2知识库 docs/knowledge/operations/forum-automation.md(DOM选择器可能随Discourse更新)
步骤2:通过决策树选择方案(script/mcp/auto)
步骤3:确认登录状态
步骤4:写操作必须先dry-run/展示diff → 获得用户明确确认
步骤5:执行操作(脚本参数或MCP步骤序列)
步骤6:验证结果(刷新/snapshot确认内容生效)
步骤7:清理草稿(编辑/回复后自动执行)

完整MCP操作步骤(JavaScript工具函数、DOM选择器、9.1-9.6详细序列)见L2知识库第4-6章。

6. 常用命令速查(forum-bot.py)

脚本路径:forum-bot.py

cd d:\spaces\SpecWeave

# 首次登录(浏览器打开后手动登录,回终端按Enter)
python .agents/scripts/forum-bot.py login

# 读取帖子
python .agents/scripts/forum-bot.py read 44601

# 编辑帖子(先dry-run预览!)
python .agents/scripts/forum-bot.py edit 44601 --file new-content.md --dry-run
python .agents/scripts/forum-bot.py edit 44601 --file new-content.md

# 开头追加(如更新日期标记,内置幂等检查防重复)
python .agents/scripts/forum-bot.py edit 44601 --prepend "📅 最新更新:2026年7月1日"

# 发布回复(先dry-run!)
python .agents/scripts/forum-bot.py reply 44601 --content "回复内容" --dry-run
python .agents/scripts/forum-bot.py reply 44601 --file reply.md

# 清理草稿
python .agents/scripts/forum-bot.py clean-drafts

完整参数表、脚本内置安全机制(幂等检查/自动重试/内容校验)见L2知识库第2-3章。

7. 安全检查清单(逐项确认)

  • 已读知识库 forum-automation.md(选择器可能更新)
  • 登录状态已确认(多信号检测:Discourse全局变量+meta标签+头像链接)
  • 写操作已 dry-run 预览(脚本:--dry-run;MCP:先展示diff并获得确认)
  • 幂等性检查已执行(prepend 操作确认内容不存在;编辑操作确认不会意外覆盖)
  • 内容已向用户展示并获得明确确认
  • 操作间隔≥3秒(避免429频率限制)
  • 保存/回复按钮已正确区分(保存无.create,回复有.create)
  • MCP方案设置textarea后触发了input/change事件(否则Discourse不认)
  • 操作完成后验证了结果(刷新/snapshot确认内容生效)
  • 操作完成后检查并清理了草稿

8. 执行日志(CMD-LOG)

执行论坛操作时按CMD-LOG规范输出:

  • cmd=forum-posting,session前缀 forum-YYYYMMDD-<topic_id>
  • 步骤编号 S0-S7(启动→方案选择→登录→dry-run→执行→验证→清草稿→完成)
  • 7个特有事件:SCHEME_SELECTED、LOGIN_REQUIRED、DRY_RUN_OK、BUTTON_CONFUSION_RISK、IDEMPOTENT_SKIP、VERIFY_PASS、DRAFTS_CLEANED

完整字段说明、事件表格、MCP方案特殊注意事项(:has-text()不可用、按钮区分等)见L2知识库;日志格式规范见 cmd-log-specification.md。

9. 常见错误处理

错误码场景处理方式
FORUM_001登录丢失脚本:重新login;MCP:提示在浏览器中手动登录
FORUM_002找不到编辑按钮wait延长到3秒,滚动到帖子可见区域;脚本有多选择器兜底
FORUM_003保存按钮无效检查:文本精确"保存"且排除.create类
FORUM_006429频率限制间隔增加到5秒,等待Retry-After
FORUM_007JS语法错误(MCP)只用标准DOM API,不用:has-text()
FORUM_010prepend被跳过内容已存在,正常现象无需操作

完整错误码表(FORUM_001~FORUM_010)见L2知识库第8章。

10. Gotchas(陷阱与反直觉行为)

为什么需要Gotchas? 错误处理记录"已知错误码及修复方式",Gotchas记录"容易踩的坑、反直觉行为、容易被忽略的约束条件"——不会产生明确错误码但会导致结果不符合预期的隐性陷阱。

  • forum-bot.py优先于integrated_browser:本地脚本方案内置dry-run预览、幂等检查、自动重试和完善的日志记录,写操作(编辑/回复)应优先选择forum-bot.py。MCP方案适合IDE内快速只读操作或临时交互调试。
  • 登录态持久化在.browser_data/目录:首次login成功后,Playwright会将浏览器状态(cookies/localStorage)保存在.browser_data/目录下。不要删除此目录,否则需要重新手动登录;此目录已加入.gitignore,不要提交到仓库。
  • 内容替换使用唯一old_string:使用Edit工具进行内容替换时,old_string必须在帖子正文中唯一匹配。如果有多处相同文本,替换会失败。遇到重复内容时,应扩大上下文范围使old_string唯一。
  • 发帖前必须dry-run预览:Playwright支持无头模式(headless)dry-run,会打开浏览器渲染完整内容但不会实际点击提交按钮。正式发帖前务必先用dry-run确认内容格式、换行、链接都正确。
  • 日期标记追加在帖子开头:使用prepend功能追加日期标记时,内容会被插入到帖子最开头(在标题之后、正文之前)。脚本内置幂等检查,如果标记已存在会自动跳过,不用担心重复追加。

11. 已管理帖子

名称URLtopic_id
SpecWeave Demo帖https://forum.trae.cn/t/topic/4460144601
SpecWeave报名帖https://forum.trae.cn/t/topic/4440244402

12. 关键参考

参考层级路径何时查阅
论坛自动化知识库(DOM/JS/步骤)L2forum-automation.md每次MCP操作必读,选择器更新时查阅
CMD-LOG日志规范L2cmd-log-specification.md日志格式、事件定义
forum-bot.py 脚本工具forum-bot.py脚本参数、debug模式

13. Changelog

  • v1.2.0 (2026-07-01): 遵循markdown-as-interface v2.0六要素标准+L1门面模式重构:删除废弃字段disable-model-invocation;添加L0/L1/L2三层架构引用块;决策前添加CMD_START强制日志;添加CMD-LOG执行日志章节(7个特有事件,L2引用模式);将174行详细MCP步骤/JS工具函数/DOM选择器表迁移到L2知识库,SKILL.md从312行精简到~170行;核心步骤采用5步快速开始格式;添加关键参考索引表;常见错误精简为6个高频错误(完整错误码见L2)。
  • v1.1.1 (2026-06-29): 合规修复:绝对路径改为相对路径;统一Why解释格式;安全检查清单增加幂等性显式项。
  • v1.1.0 (2026-06-29): 新增forum-bot.py双方案支持;补充方案选型决策树;整合可复用JS工具函数;增加已管理帖子索引。
  • v1.0.0 (2026-06-29): 初始版本,支持编辑/回复/清理草稿(MCP方案)。
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall