公众号诊断

SKILL.md 节选

# 公众号诊断

> 版本：v0.2.0· 作者：零一数科

把自己的号整体看一遍：选题结构、更新节奏、定位一致性、健康度信号灯、偏弱维度与策略建议。

解析、评分、聚合、归纳、洞察、报告渲染全部在远端服务完成。脚本 `scripts/wx_analyze.py` 负责全部
HTTP 调用，接口说明见 `references/api.md`。你的职责是：确认账号（或收集本地输入）与定位自述、在
交互节点等用户确认、把服务端返回的七区块结论讲给用户听。

**默认不需要用户上传任何文件**：给出公众号名字、确认账号后，全量层与深度层数据都由服务端自动获取。
后台导出表格是可选增强（阅读数精确、含涨粉/来源等私域口径），不是前置条件。

## 执行流程

0. **读配置**（任何命令之前先做）：读技能目录下 `config.json`；文件不存在就把包内 `config.json.example` 复制成 `config.json` 再读（模板里 `BASE_URL` 已是生产地址 `https://service.lingyishuke.com`，一般不用改，只需补 `LY_API_KEY`）。若 `config.json` 里 `BASE_URL` 仍是旧地址 `https://claw.lingyishuke.com/services`，就地改成新地址——域名已迁移，且 `config.json` 优先级高于 `config.json.example`，**升级新包不会自动改它**。
1. **取 API Key**：读技能目录下 `config.json` 的 `LY_API_KEY`（回退环境变量）。缺失按「鉴权」引导获取写入。`BASE_URL` 同文件配置（生产地址 `https://service.lingyishuke.com`），缺失时脚本退出码 2。
2. **输入判定**：见「节点 1」。默认路径是账号直连——用户说出公众号名字 → `search` 出候选 → **等用户确认是哪个账号** → 直接发起诊断；全量层数据由服务端自动获取，**不要追问用户要不要上传后台表格**。同一轮顺带问一句定位自述。选中的候选「可直连」为 ✗ 时见「节点 1b」（换关键词重搜 / 用文章链接 `--account-url` 继续），不要就此结束。
3. **扣点确认**：告知「本次账号诊断预计扣 深度层篇数×20 + 30 点（只上传全量层表格、不做深度层时约 30 点），实际扣点以服务端为准」，账号直连模式按 count 计（count×20 + 30），等用户明确同意；`--task-id` 恢复轮询不重复扣点，跳过本步。
4. **提交 + 轮询**：`account submit`（建任务与轮询一体；深度层评分较慢，进度打在 stderr）。用户主动给了 `--tables` 时，脚本内部走「申请上传票据 → 表格直传对象存储 → 确认落库 → 只提交上传凭证」，已自动处理，命令与用户操作都不变。
5. **选题归纳**：`account groupings`，展示归类表并问是否调整（见「节点 2」）。
6. **洞察结论**：`account insights`，七区块一次性输出（见「节点 3」）。
7. **报告**：固定问「要生成包含选题分布/产量表现四象限/7 维低分占比/发文间隔时间轴的 HTML 报告吗？」，确认后 `account report`。
8. **收尾**：告知实际扣点（`WX_ANALYZE_POINTS_USED`）与报告路径。

## 脚本定位（任何命令之前先做这一步）

后文命令里的 `"$SKILL"` 指本技能的安装目录。已知部分运行时（WorkBuddy）不注入
`CLAUDE_SKILL_DIR`，所以必须按以下顺序解析（成功一级即停，marker 是 `scripts/wx_analyze.py`）：

```bash
SN=wx-account-diagnose
SKILL=""
if [ -n "$CLAUDE_SKILL_DIR" ] && [ -f "$CLAUDE_SKILL_DIR/scripts/wx_analyze.py" ]; then
  SKILL="$CLAUDE_SKILL_DIR"
else
  D="$PWD"
  while [ "$D" != "/" ]; do
    case "$D" in */$SN|*/"$SN"__skillhub) [ -f "$D/scripts/wx_analyze.py" ] && { SKILL="$D"; break; };; esac
    D=$(dirname "$D")
  done
  if [ -z "$SKILL" ]; then
    SKILL=$(find "$HOME/.claude" "$HOME/.codebuddy" "$HOME/.workbuddy" -maxdepth 9 -type d \
      \( -name "$SN" -o -name "$SN"__skillhub \) 2>/dev/null | while read -r d; do
        [ -f "$d/scripts/wx_analyze.py" ] && echo "$d"; done | head -1)
  fi
fi

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 6 个文件，合计 89.0 KiB