| 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 发布
- 输入"预览" → 查看完整文章
- 输入"重新生成" → 修改三要素重新生成
错误处理
依赖
- Python 3.7+
- 笔尖 API 脚本：
scripts/bijian_api.py（已内置）
变更日志
- v1.1.0 (2026-03-10)：配置路径说明优化；统一版本号。
- v1.0.0 (2026-03-10)：首次发布。三要素收集、笔尖API对接、素材增强策略（5种文章类型）。发布功能拆分至 inkroam-publisher。
