inkroam-bijian-writing

name	inkroam-bijian-writing
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

• 1个空间 → 自动选择
• 多个空间 → 列出让用户选择
• 用户输入 -切换空间 → 重新查询

Step 2：收集三要素

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

请提供文章三要素：

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

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

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

收集策略：

• 只给主题 → 追问观点要点（至少3条）
• 没有素材 → 不留空，AI 按文章类型主动补充（见下方策略）

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

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

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
生成失败	提示重新组织三要素，不盲目重试

依赖

• Python 3.7+
• 笔尖 API 脚本：scripts/bijian_api.py（已内置）

变更日志

• v1.1.0 (2026-03-10)：配置路径说明优化；统一版本号。
• v1.0.0 (2026-03-10)：首次发布。三要素收集、笔尖API对接、素材增强策略（5种文章类型）。发布功能拆分至 inkroam-publisher。