菜单
Discourse论坛（forum.trae.cn）自动化操作。当用户需要发帖、编辑帖子、更新帖子、回复帖子、跟帖、发布论坛内容、清理草稿、读取帖子、操作forum.trae.cn、使用forum-bot脚本时，必须使用此技能。支持双方案：forum-bot.py（Playwright脚本，本地/CI首选，支持dry-run预览、幂等检查、登录持久化）和integrated_browser MCP（IDE内即时操作，零配置）。覆盖读取、编辑替换、开头追加（如日期标记）、回复、清理草稿全流程。不要手动拼接浏览器操作——本Skill封装了双方案选择逻辑和安全防线。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
当用户提到'CI检查'、'提交前检查'、'综合检查'、'ci-check'、'流水线检查'、'提交门禁'、'全量检查'、'跑一下CI'、'pre-commit'、'预检'、'检查所有'时，必须使用此技能。提供项目CI/CD综合检查能力，按标准流水线顺序执行10项核心检查：仓库合规→链接检查→Spec一致性→模式成熟度→文档生成→重复代码检测→阶段守卫日志→SG仪表盘→文件放置校验→.temp生命周期检查。提交前必跑，确保代码符合项目规范。不要手动逐个执行检查脚本——本Skill已按正确顺序编排，并处理了跨平台兼容（Windows用.ps1，Linux/Mac用.sh）。
当用户提到'链接检查'、'检查链接'、'断链'、'链接修复'、'fix links'、'check links'、'验证链接'、'死链'、'链接有效性'、'提交前检查'时，必须使用此技能。提供Markdown链接有效性检查与自动修复能力：本地文件引用验证、外部URL可达性检测、file:///绝对路径转相对路径、相对路径层级自动校正。不要手动查找断链——本Skill封装了缓存机制、并发检测、自动修复和dry-run预览，是提交前质量门禁的核心工具。
当用户提到'原子化收尾'、'finalize atomization'、'文档拆分完成'、'文件移动后处理'、'断链修复导航更新'、'一键收尾'、'重构完成后整理'时，必须使用此技能。原子化/文件移动/目录重构后的一键收尾工具：自动断链修复→导航表更新→Spec看板刷新→验证摘要。不要手动逐个执行后处理步骤——本Skill封装了正确的执行顺序和dry-run预览机制，是文档原子化工作流的标准最后一步。
当用户提到'萃取'、'extraction'、'模式沉淀'、'萃取模式'、'模式入库'、'沉淀为模式'、'可复用模式'、'更新模式库'、'生成模式文档'时，必须使用此技能。提供标准化的模式萃取流程：案例收集→本质抽象→结构化模板→反模式提炼→迁移验证→入库。不要手动组织萃取流程——本Skill封装了六步标准萃取法、反模式对等原则和可迁移性验证。替代旧的pattern-extraction-cmd（v1.0.0）。
当用户提到'知识图谱'、'knowledge graph'、'概念关系可视化'、'交互式知识图谱'、'节点关系网络'、'生成知识图谱'、'可视化知识库'、'概念网络'、'knowledge graph config'时，必须使用此技能。从结构化Markdown文档集（术语表/文档索引/时间线等）自动提取节点和关系，生成交互式vis-network HTML知识图谱。支持TOML声明式配置和Python API两种方式，内置节点去重、孤立节点检测、类型筛选、可信度分级显示。不要手动拼接vis-network代码——本Skill封装了表格解析、关系构建、HTML模板渲染和自包含输出，确保产出质量可预测。
当用户提到'mermaid'、'流程图'、'时序图'、'状态图'、'画个图'、'图表'、'架构图'、'思维导图'、'ER图'、'类图'、'甘特图'、'饼图'、'UML图'、'可视化流程'、'画流程图'、'mermaid图'、'可视化'、'流程可视化'时，必须使用此技能。提供标准化的Mermaid图表创建、检查、修复流程，引导完成从设计→编码→检查→修复→验证→交付的完整闭环。不要手写Mermaid代码绕过本Skill——本Skill封装了安全编码六规则、模板选择、自动检查修复流程，确保图表质量可预测。
| 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 |
⚠️ 本Skill是命令入口门面（L1索引层），遵循渐进式披露三层架构：
- L0：.agents/ONBOARDING.md（入口速查）
- L1：本文件（<200行，触发词+决策树+核心步骤+安全清单）
- L2：forum-automation.md（DOM选择器+JS函数+完整MCP步骤+故障排查）
forum-posting
操作 forum.trae.cn（Discourse 论坛）的技能，提供双方案支持，由技能根据场景自动选择，也可由用户指定：
| 方案 | 推荐场景 | 优势 |
|---|---|---|
| forum-bot.py | ⭐ 独立运行/命令行/CI，需要 dry-run 预览 | 登录持久化、幂等检查、自动重试、完善日志 |
| integrated_browser MCP | ⭐ Trae IDE 内即时操作 | 零配置、复用浏览器已登录状态、可交互调试 |
核心功能：读取帖子、编辑正文（完整替换）、开头追加（如更新日期标记）、发布回复、清理草稿。
为什么双方案？ forum-bot.py 适合可重复、可验证的操作（推荐写操作先用它 dry-run）；MCP 适合 IDE 内快速交互式操作。两者覆盖不同使用场景，不冲突。
当用户提到以下任何内容时触发：
关于触发：即使没有明确说"用 skill"，只要涉及论坛操作就应该使用本技能，不要自己手动拼接浏览器操作。
需要操作论坛？
├─ 在 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 并获得明确确认。
步骤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章。
脚本路径：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章。
--dry-run；MCP：先展示diff并获得确认）.create，回复有.create）执行论坛操作时按CMD-LOG规范输出：
cmd=forum-posting，session前缀 forum-YYYYMMDD-<topic_id>SCHEME_SELECTED、LOGIN_REQUIRED、DRY_RUN_OK、BUTTON_CONFUSION_RISK、IDEMPOTENT_SKIP、VERIFY_PASS、DRAFTS_CLEANED完整字段说明、事件表格、MCP方案特殊注意事项（:has-text()不可用、按钮区分等）见L2知识库；日志格式规范见 cmd-log-specification.md。
| 错误码 | 场景 | 处理方式 |
|---|---|---|
| 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章。
为什么需要Gotchas？ 错误处理记录"已知错误码及修复方式"，Gotchas记录"容易踩的坑、反直觉行为、容易被忽略的约束条件"——不会产生明确错误码但会导致结果不符合预期的隐性陷阱。
.browser_data/目录下。不要删除此目录，否则需要重新手动登录；此目录已加入.gitignore，不要提交到仓库。| 名称 | URL | topic_id |
|---|---|---|
| SpecWeave Demo帖 | https://forum.trae.cn/t/topic/44601 | 44601 |
| SpecWeave报名帖 | https://forum.trae.cn/t/topic/44402 | 44402 |
| 参考 | 层级 | 路径 | 何时查阅 |
|---|---|---|---|
| 论坛自动化知识库（DOM/JS/步骤） | L2 | forum-automation.md | 每次MCP操作必读，选择器更新时查阅 |
| CMD-LOG日志规范 | L2 | cmd-log-specification.md | 日志格式、事件定义 |
| forum-bot.py 脚本 | 工具 | forum-bot.py | 脚本参数、debug模式 |