Solo Topics
- 脚本:与本
SKILL.md同目录下的scripts/solo-topics.js(Node 18+,fetch,无额外依赖) - 环境:
MIXDAO_API_KEY(必填;脚本亦接受API_KEY);BASE_URL可选;articles可省略参数时用TOPIC_ID - 命令(在 skill 根
cd后,或node指向脚本绝对路径):node scripts/solo-topics.js topicsnode scripts/solo-topics.js articles <TOPIC_ID>node scripts/solo-topics.js add <TOPIC_ID> <文件.md|->(stdin 为整篇 Markdown;路径相对当前工作目录)
- 省 token:可加
--compact(单行 JSON 输出) add(Markdown):脚本根据正文自动生成id(SHA-256 的短 hex,默认前 12 位)、title(首行#或第一行非空)、content(全文)、date(本地时区YYYY-MM-DD)、summary、url、source、sortOrder。细节见references/api-details.md。topics输出:每条含label(展示名,不是name)、description、keywords(常很长)、reportPrompt等;向用户呈现时只摘 id + label(可加一句 description),勿默认整段贴keywords/reportPrompt。
详细参考
端点、认证、错误处理、add 请求体与示例见 references/api-details.md(按需读取;该目录便于后续扩展长文档而不撑满主上下文)。
Agent 约定
- 读:解析脚本输出,用列表/摘要呈现给用户,勿默认整段粘贴 raw JSON(用户要求除外)。
topics:id +label(必要时一行description);articles:title、url、date(需要时再带summary/source);列表空要说明。 - 写:仅用户明确要求时投稿;
add仅接受 Markdown(标题/日期等由脚本从正文推导并拼 JSON)。事前确认专题 id;成功回报返回 id/对象;失败原样说明、不重试。 - 错:非零退出 / stderr;用自然语言解释(如 401 → 检查
MIXDAO_API_KEY)。 - API:仅支持 POST 创建文章,不能按 id 更新或删除。