| name | forum-posting |
| version | 1.2.0 |
| description | Discourse论坛（forum.trae.cn）自动化操作。当用户需要发帖、编辑帖子、更新帖子、回复帖子、跟帖、发布论坛内容、清理草稿、读取帖子、操作forum.trae.cn、使用forum-bot脚本时，必须使用此技能。支持双方案：forum-bot.py（Playwright脚本，本地/CI首选，支持dry-run预览、幂等检查、登录持久化）和integrated_browser MCP（IDE内即时操作，零配置）。覆盖读取、编辑替换、开头追加（如日期标记）、回复、清理草稿全流程。不要手动拼接浏览器操作——本Skill封装了双方案选择逻辑和安全防线。 |
| argument-hint | <操作类型> [帖子URL/ID] |
| user-invocable | true |
| paths | [".agents/scripts/forum-bot.py","docs/knowledge/operations/forum-automation.md",".agents/commands/forum-posting.md"] |
| title | 论坛发帖与维护 (Forum Posting) |
| x-toml-ref | ../../../.meta/toml/.agents/skills/forum-posting/SKILL.toml |
论坛发帖与维护 (Forum Posting)
⚠️ 本Skill是命令入口门面（L1索引层），遵循渐进式披露三层架构：
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
python .agents/scripts/forum-bot.py login
python .agents/scripts/forum-bot.py read 44601
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日"
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. 安全检查清单（逐项确认）
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_006 | 429频率限制 | 间隔增加到5秒，等待Retry-After |
| FORUM_007 | JS语法错误（MCP） | 只用标准DOM API，不用:has-text() |
| FORUM_010 | prepend被跳过 | 内容已存在，正常现象无需操作 |
完整错误码表（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. 已管理帖子
12. 关键参考
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方案）。
