笔尖写作专家 Skill

---

name: inkroam-bijian-writing

version: 1.1.0

description: 笔尖写作专家：三要素收集 → 调用笔尖AI生成文章 → 输出可发布内容。Use when user asks to 用笔尖写文章 / 生成公众号文章 / 写一篇文章.

---

# 笔尖写作专家 Skill

三要素驱动的 AI 写作工具，调用笔尖AI平台生成高质量文章。

**职责边界：** 本 Skill 只负责**写作**（三要素收集 → 生成 → 输出），不负责发布。发布请使用 `inkroam-publisher`。

配置

笔尖 API Token

在工作区创建配置文件 `<workspace>/.bijian_config`（或 `$OPENCLAW_WORKSPACE/.bijian_config`）：

export BIJIAN_API_TOKEN='你的token'
export BIJIAN_TOKEN_HEADER='X-API-KEY'
export BIJIAN_TOKEN_PREFIX=''
export BIJIAN_BASE_URL='https://bj.aizmjx.com/api'

Token 获取地址：https://sso.aizmjx.com/home/apikey

**配置检查：**

# 按优先级查找配置文件
CONFIG_FILE="${OPENCLAW_WORKSPACE}/.bijian_config"
[ -f "$CONFIG_FILE" ] || CONFIG_FILE="$HOME/.openclaw/workspace/.bijian_config"
[ -f "$CONFIG_FILE" ] && source "$CONFIG_FILE" && echo "✅ 配置已加载" || echo "❌ 请创建 .bijian_config"

⚠️ **不要向用户询问 token，直接从配置文件读取。**

工作流

Step 1：查询写作空间

source "$CONFIG_FILE" && python3 scripts/bijian_api.py spaces

Step 2：收集三要素

**必须收集完整三要素才能生成。**

请提供文章三要素：

1️⃣ 主题（必填）
   例：花了3万养了一只金融虾（OpenClaw），到底值不值

2️⃣ 观点要点（必填）
   你最想表达的3-5条核心观点
   例：金融虾难在信任建立；值不值看系统可控性；五层架构设计思路

3️⃣ 参考素材（重要！）
   相关链接、操作步骤、安装命令、使用案例、数据来源等
   例：完整安装教程 + 对话案例 + 效果数据

**收集策略：**

**⚠️ 素材质量直接决定笔尖输出质量。素材越具体，文章越有干货。**

素材增强策略（按文章类型分场景）

AI 先判断文章类型，再主动补充对应素材：

| 类型 | 重点补充 |

|------|---------|

| 📐 教程/干货/工具 | 安装命令、使用案例、效果数据、技术架构、资源链接 |

| 🔥 热点/时事 | 事件时间线、多方观点、数据支撑、信息来源 |

| 💛 情感/故事/IP | 真实细节、情感锚点、人物画像、共鸣场景、金句 |

| ⚔️ 军事/历史/知识 | 事实数据、权威来源、对比分析、独特视角 |

| 🛒 种草/测评/变现 | 亲身体验、价格对比、效果证据、避坑提醒 |

Step 3：调用笔尖生成

source "$CONFIG_FILE" && python3 scripts/bijian_api.py generate \
  --space-id ${SPACE_ID} \
  --topic-theme "${TOPIC_THEME}" \
  --viewpoints "${VIEWPOINTS}" \
  --reference-content "${REFERENCE_CONTENT}" \
  --user-require "${USER_REQUIRE}" \
  --is-need-picture false

Step 4：轮询状态

source "$CONFIG_FILE" && python3 scripts/bijian_api.py task --article-id ${ARTICLE_ID}

状态码：`1`=生成中 `2`=成功 `3`=失败。每 3-5 秒查一次，最多 10 次。

Step 5：获取文章

source "$CONFIG_FILE" && python3 scripts/bijian_api.py article --article-id ${ARTICLE_ID}

**展示给用户：**

✅ 文章生成成功！

标题：xxx
字数：1402字
封面图：已生成

[预览前200字]

下一步：
- 输入"发布" → 调用 inkroam-publisher 发布
- 输入"预览" → 查看完整文章
- 输入"重新生成" → 修改三要素重新生成

错误处理

| 错误 | 处理 |

|------|------|

| 令牌无效（401） | 提示重新获取：https://sso.aizmjx.com/home/apikey |

| 空间不存在 | 提示创建空间：https://bj.aizmjx.com/space |

| 生成失败 | 提示重新组织三要素，不盲目重试 |

依赖

变更日志