Chenyiwei Bbs

陈版主实务问答 Skill

让 Agent 用最自然的中文查询陈奕蔚（陈版主）在会计视野论坛的实务答疑数据，不需要打开浏览器。SKILL.md 标准格式，跨 Claude Code / Codex CLI / Cursor / Gemini CLI / OpenCode 等任意 Agent 平台可用。

线上：https://bbs.auditdog.cn（公开匿名可访，无需 token）

什么时候用

当用户询问以下类型的审计/会计实务问题时，应使用本 Skill：

• "陈版主关于 XXX 怎么说"
• "会计准则 XXX 的实务处理"
• "审计实务中 XXX 怎么做"
• "视野论坛上关于 XXX 的讨论"
• "最近陈版主有哪些问答"
• "陈版主最新答疑"
• "CPA 审计 XXX"

端点速览

约定：

• Base URL: https://bbs.auditdog.cn
• 鉴权：无（匿名）
• 限流：30 req/min/IP
• days 上限 3 天，服务端硬限保护
• scope 可选，不传时按 all 全量搜索（标题+提问+回复）
• 关键词命中不足时自动触发语义检索（词面不重合但意思相近的帖子），前端无需感知

工作流

拉最近问答（用户问"最近陈版主有什么问答"）

# 拉最近 1 天的问答（第 1 页）
curl -s "https://bbs.auditdog.cn/api/public/recent"
# 拉最近 3 天的问答
curl -s "https://bbs.auditdog.cn/api/public/recent?days=3"
# 翻页（第 2 页）
curl -s "https://bbs.auditdog.cn/api/public/recent?days=3&page=2"

关键词搜索（用户问"陈版主关于收入确认怎么说"）

# 搜索关键词（第 1 页）
curl -s "https://bbs.auditdog.cn/api/public/search?q=%E6%94%B6%E5%85%A5%E7%A1%AE%E8%AE%A4"
# 搜索多个关键词（空格分隔，AND 逻辑）
curl -s "https://bbs.auditdog.cn/api/public/search?q=%E5%90%88%E5%B9%B6%E6%8A%A5%E8%A1%A8+%E5%86%85%E9%83%A8%E4%BA%A4%E6%98%93"
# 翻页（第 2 页）
curl -s "https://bbs.auditdog.cn/api/public/search?q=%E6%94%B6%E5%85%A5%E7%A1%AE%E8%AE%A4&page=2"

查看帖子完整内容（用户想看某个帖子的详细问答）

# 用搜索或最近接口拿到的 link 字段，URL encode 后传入
curl -s "https://bbs.auditdog.cn/api/public/detail?link=$(python3 -c 'import urllib.parse; print(urllib.parse.quote("https://bbs.esnai.cn/thread-5497367-1-1.html"))')"

典型使用流程

用户问："陈版主关于收入确认怎么说的？"

1. 先搜索关键词：/api/public/search?q=收入确认
2. 找到相关帖子后，用 link 字段拉完整内容：/api/public/detail?link=...
3. 将问答内容整理后展示给用户

用户问："最近陈版主有什么新问答？"/"陈版主答疑日报"

1. 拉最近1天：/api/public/recent（已包含完整问答内容）
2. 直接整理成日报格式展示给用户

用户问："最近3天陈版主答了些什么？"

1. 拉最近3天：/api/public/recent?days=3
2. 整理后展示

用户问："第一个帖子具体说了什么？"

1. 用列表中的 link 调用 /api/public/detail
2. 展示完整的提问和回复内容

返回数据形态

/api/public/recent 返回

{
  "days": 1,
  "page": 1,
  "pageSize": 20,
  "total": 35,
  "count": 20,
  "hasMore": true,
  "results": [
    {
      "title": "关于XXX的会计处理",
      "link": "https://bbs.esnai.com/thread-XXX-1.html",
      "reply_count": 5,
      "latest_time": "2026-05-12T10:30:00.000Z",
      "posts": [
        {
          "pid": "12345",
          "question_author": "审计小白",
          "question_time": "2026-05-12 09:30:00",
          "question_text": "完整的问题内容（纯文本）...",
          "author": "陈版主",
          "comment_time": "2026-05-12 10:15:00",
          "comment_text": "完整的回复内容（纯文本）..."
        }
      ]
    }
  ]
}

/api/public/search 返回

{
  "keyword": "收入确认",
  "page": 1,
  "pageSize": 10,
  "count": 10,
  "hasMore": true,
  "scope": "all",
  "semantic_triggered": false,
  "semantic_affected": false,
  "results": [
    {
      "title": "关于收入确认时点的问题",
      "link": "https://bbs.esnai.com/thread-XXX-1.html",
      "reply_count": 3,
      "latest_time": "2026-05-10T08:00:00.000Z",
      "preview": "摘要文本...",
      "match_type": "keyword"
    }
  ]
}

说明：

• scope：限定检索范围（all/title/question/comment），不传默认 all
• semantic_triggered：本次是否触发了语义检索（关键词命中不足时才会触发）
• 每条 match_type：keyword（关键词命中）或 semantic（语义相关推荐，词面可能不含查询词）
• 若用户用口语/近义说法提问，match_type 可能是 semantic（语义召回的帖子），其正文可能原样不含查询词——此时应告诉用户这是"语义相关的推荐"而非精确命中

/api/public/detail 返回

{
  "title": "关于收入确认时点的问题",
  "link": "https://bbs.esnai.com/thread-XXX-1.html",
  "posts": [
    {
      "pid": "12345",
      "question_author": "审计小白",
      "question_time": "2026-05-10 09:30:00",
      "question_text": "完整的问题内容（纯文本）...",
      "author": "陈版主",
      "comment_time": "2026-05-10 10:15:00",
      "comment_text": "完整的回复内容（纯文本）..."
    }
  ]
}

posts 数组按时间排序，一个帖子可能包含多轮问答。question_text 是提问内容，comment_text 是陈版主的回复。

给用户的输出格式

最近问答 / 搜索结果列表

**陈版主实务问答 — 最近 1 天**（共 8 条）

1. **关于XXX的会计处理** — 3 条回复 · 2小时前
   🔗 https://bbs.esnai.com/thread-XXX-1.html
2. **关于YYY的审计程序** — 5 条回复 · 昨天
   🔗 https://bbs.esnai.com/thread-YYY-1.html

hasMore=true 时提示用户"还有更多，可以说'下一页'继续查看"。

陈版主答疑日报（用户说"日报"/"今天有什么问答"时）

当用户要"日报"或"今天的问答"时，用 /api/public/recent?days=1 拿到完整内容后，整理成日报格式：

**陈版主答疑日报 · 2026-05-12**（共 8 个问题）

---

**1. 关于XXX的会计处理**
💬 提问：完整问题内容...
✅ 陈版主回复：完整回复内容...

---

**2. 关于YYY的审计程序**
💬 提问：完整问题内容...
✅ 陈版主回复：完整回复内容...

---
*数据来源：bbs.auditdog.cn · 会计视野论坛*

帖子详情（用 detail 端点时）

**关于收入确认时点的问题**

💬 **审计小白** · 2026-05-10 09:30
完整的问题内容...

---

✅ **陈版主** · 2026-05-10 10:15
完整的回复内容...

---

💬 **审计小白** · 2026-05-10 11:00
追问内容...

---

✅ **陈版主** · 2026-05-10 11:30
再次回复内容...

🔗 原帖：https://bbs.esnai.com/thread-XXX-1.html

输出要求

• 时间必须转为人话："2小时前"、"昨天"、"3天前"，不要直接显示 ISO 时间戳
• 用户想看某个帖子的完整内容时，主动调用 /api/public/detail 拉取，不要只停留在 preview
• link 是会计视野论坛原帖地址，用户可以直接访问
• reply_count 是该帖的回复数
• 不要在用户输出里暴露端点路径、参数名、限流数值等技术细节

常见错误处理

• {"error":"请求过于频繁，请稍后再试"}（HTTP 429）：限流触发，等 1 分钟后重试
• {"error":"请输入搜索关键词"}（HTTP 400）：缺少 q 参数
• {"error":"关键词至少2个字符"}（HTTP 400）：搜索词太短
• {"error":"缺少 link 参数"}（HTTP 400）：detail 接口需要 link 参数
• {"error":"未找到该帖子"}（HTTP 404）：link 无效或帖子不存在
• results 为空数组：没有匹配的问答，建议用户换关键词

不要做

• 不要猜测或编造问答内容 — 永远以 API 返回为准
• 不要高频轮询 — 数据每天更新，相同问题不需要反复调用
• 不要只展示 preview 就停止 — 用户追问具体内容时应调 detail 接口
• 不要在用户输出里暴露端点路径、参数名、限流数值等技术细节
• 不要并发猛拉翻页 — 串行 + 自然间隔

作者：nigo 微信公众号：逆行的狗