Skip to content
Back to search

x-skills

自动收集素材,确认选题,并创作x推文,最后并发布到草稿箱的Claude Skills

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kangarooking--x-skills/badge.svg)](/listings/kangarooking--x-skills)

HTML

<a href="/listings/kangarooking--x-skills"><img src="/api/listings/kangarooking--x-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

将 skill 文件夹复制到 Claude skills 目录:

# macOS/Linux
cp -r x-collect x-filter x-create x-publish ~/.claude/skills/

# 或者创建符号链接(推荐,方便更新)
ln -s $(pwd)/x-collect ~/.claude/skills/
ln -s $(pwd)/x-filter ~/.claude/skills/
ln -s $(pwd)/x-create ~/.claude/skills/
ln -s $(pwd)/x-publish ~/.claude/skills/

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 335 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # X-Skills
  2. [English](./README_EN.md) | **简体中文**
  3. > 一套用于 X (Twitter) 内容创作自动化的 Claude Skills,帮助你高效收集素材、筛选选题、创作爆款推文并发布到草稿箱。
  4. [![Version](https://img.shields.io/badge/Version-2.0-green.svg)](./RELEASE_NOTES_v2.0.md)
  5. [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
  6. [![Claude Code](https://img.shields.io/badge/Claude-Code-orange)](https://claude.ai/claude-code)
  7. ---
  8. ## ✨ 功能特性
  9. ```
  10. 素材收集 → 选题筛选 → 推文创作 → 发布草稿 → 反馈闭环
  11. 📚 🎯 ✍️ 📤 🔄
  12. ```
  13. | Skill | 命令 | 功能描述 |
  14. |-------|------|----------|
  15. | **x-collect** | `/x-collect [话题]` | 4轮深度搜索,支持画像增强与探索模式 |
  16. | **x-filter** | `/x-filter` | 多维加权打分 + 负样本过滤 + 多样性衰减 |
  17. | **x-create** | `/x-create [选题]` | 意图路由 + A/B变体 + Critic自检 |
  18. | **x-publish** | `/x-publish` | 自动发布到X草稿箱 + 事件记录 |
  19. ### 核心亮点
  20. - **智能推荐算法**:借鉴 X For You 推荐算法,引入多源候选、加权评分、多样性控制
  21. - **A/B 变体 + Critic**:默认生成两个版本并自检打分,低于阈值自动重写一次
  22. - **意图驱动路由**:根据目标动作(收藏/转发/讨论)自动选择最佳创作模式
  23. - **反馈闭环**:支持正/负样本库(liked/rejected topics)+ 事件日志(JSONL)
  24. - **相似度过滤**:基于字符 n-gram 的轻量相似度算法,避免重复低质选题
  25. - **状态持久化**:Python 脚本管理状态文件,支持 hooks 自动收集反馈
  26. ---
  27. ## 🚀 快速开始
  28. ### 1. 安装 Skills
  29. 将 skill 文件夹复制到 Claude skills 目录:
  30. ```bash
  31. # macOS/Linux
  32. cp -r x-collect x-filter x-create x-publish ~/.claude/skills/
  33. # 或者创建符号链接(推荐,方便更新)
  34. ln -s $(pwd)/x-collect ~/.claude/skills/
  35. ln -s $(pwd)/x-filter ~/.claude/skills/
  36. ln -s $(pwd)/x-create ~/.claude/skills/
  37. ln -s $(pwd)/x-publish ~/.claude/skills/
  38. ```
  39. ### 2. 首次设置
  40. 运行 `/x-create`,回答几个简单问题完成初始化:
  41. - **账号定位**:你主要分享什么内容?(AI/科技、创业、个人成长等)
  42. - **目标受众**:你的读者是谁?(中文用户、英文用户、双语用户)
  43. - **人设风格**:你想塑造什么形象?(专业严肃、轻松幽默、犀利观点等)
  44. ### 3. 开始使用
  45. ```bash
  46. # 步骤1: 收集素材
  47. /x-collect Claude MCP协议
  48. # 步骤2: 筛选选题
  49. /x-filter
  50. # 步骤3: 创作推文
  51. /x-create "MCP协议详解" --type thread
  52. # 步骤4: 发布到草稿
  53. /x-publish
  54. ```
  55. ---
  56. ## 📖 详细使用
  57. ### x-collect 素材收集
  58. 使用4轮搜索策略,模拟人类调研思维:
  59. | 轮次 | 策略 | 目标 |
  60. |------|------|------|
  61. | 第1轮 | 官方信息 | 官方文档、GitHub、公告 |
  62. | 第2轮 | 技术解析 | 详细介绍、教程、原理 |
  63. | 第3轮 | 对比评测 | vs竞品、评测、优缺点 |
  64. | 第4轮 | 补充验证 | 填补信息空白、最新动态 |
  65. **输出**:结构化的素材报告,包含来源、摘要、关键点、推荐推文类型
  66. ### x-filter 选题筛选
  67. 10分制打分系统:
  68. | 维度 | 分值 | 说明 |
  69. |------|------|------|
  70. | 热度/趋势 | 4分 | 当前热门程度、讨论量 |
  71. | 争议性 | 2分 | 是否能引发讨论和对立观点 |
  72. | 高价值 | 3分 | 信息密度、可操作性 |
  73. | 账号相关 | 1分 | 与你账号定位的契合度 |
  74. **≥7分** 进入创作池,推荐优先创作
  75. ### x-create 推文创作
  76. 支持3种输出格式:
  77. - **短推文**:≤280字符,单条推文
  78. - **Thread**:3-10条串联推文
  79. - **评论回复**:用于蹭热点回复
  80. ### x-publish 发布到草稿
  81. 使用 Playwright 浏览器自动化:
  82. 1. 打开 X 编辑器
  83. 2. 填入推文内容
  84. 3. 保存到草稿箱
  85. 4. **永不自动发布**,用户手动审核
  86. ---
  87. ## 🎨 推文风格
  88. 5种爆款推文模式,可在 `x-create/references/post-patterns.md` 查看详细 prompt:
  89. | 风格 | 特点 | 适用场景 |
  90. |------|------|----------|
  91. | **高价值干货** | 数字开头、清单结构、可收藏 | 教程、工具推荐、方法论 |
  92. | **犀利观点** | 反常识、有立场、引发讨论 | 行业评论、热辣观点 |
  93. | **热点评论** | 快速反应、独特角度 | 新闻点评、事件评论 |
  94. | **故事洞察** | 具体场景、转折、金句 | 案例分析、经验复盘 |
  95. | **技术解析** | 原理拆解、类比解释 | 技术讲解、源码分析 |
  96. ### 自定义参考推文
  97. 将你喜欢的爆款推文放入对应目录,创作时会优先学习这些风格:
  98. ```
  99. x-create/assets/templates/
  100. ├── high-value/ # 高价值干货类
  101. ├── sharp-opinion/ # 犀利观点类
  102. ├── trending-comment/ # 热点评论类
  103. ├── story-insight/ # 故事洞察类
  104. └── tech-analysis/ # 技术解析类
  105. ```
  106. ---
  107. ## ⚙️ 配置说明
  108. ### 用户配置文件
  109. `x-create/references/user-profile.md`:
  110. ```yaml
  111. initialized: true
  112. account:
  113. domains:
  114. - AI/科技
  115. - 创业
  116. - 个人成长
  117. target_audience: "中文用户"
  118. persona_style: "专业严肃、犀利观点、偶尔小幽默"
  119. language: "zh-CN"
  120. scoring:
  121. trending: 4 # 热度权重
  122. controversy: 2 # 争议性权重
  123. value: 3 # 高价值权重
  124. relevance: 1 # 相关性权重
  125. threshold: 7 # 入选阈值
  126. experiments:
  127. ab_variants: true # 默认生成 A/B 变体
  128. critic_enabled: true # 启用自检打分
  129. critic_threshold: 7 # 低于阈值触发重写
  130. auto_rewrite_once: true # 最多自动重写一次
  131. ```
  132. ### 状态与反馈闭环
  133. 状态文件默认存储在:`~/.claude/skills/x-create/state/`
  134. ```bash
  135. state/
  136. ├── liked_topics.json # 正样本库(采纳的选题)
  137. ├── rejected_topics.json # 负样本库(淘汰的选题)
  138. └── events.jsonl # 事件日志(追加写入)
  139. ```
  140. **管理脚本**:`x-create/scripts/x_state.py`
  141. ```bash
  142. # 初始化状态文件
  143. python3 ~/.claude/skills/x-create/scripts/x_state.py init
  144. # 记录采纳的选题
  145. python3 ~/.claude/skills/x-create/scripts/x_state.py like --topic-json '{...}'
  146. # 记录淘汰的选题
  147. python3 ~/.claude/skills/x-create/scripts/x_state.py reject --topic-json '{...}'
  148. # 查询相似度(用于过滤重复选题)
  149. python3 ~/.claude/skills/x-create/scripts/x_state.py similarity --against rejected --text "某选题" --topk 3
  150. # 写入事件日志
  151. python3 ~/.claude/skills/x-create/scripts/x_state.py event --event collect.completed --payload-json '{...}'
  152. ```
  153. ### 环境依赖
  154. **x-publish 需要**:
  155. - Playwright MCP 已配置
  156. - 浏览器已登录 X
  157. - Python 3.9+
  158. - macOS: `pip install pyobjc-framework-Cocoa`
  159. - Windows: `pip install pyperclip`
  160. **x-collect 需要**:
  161. - WebSearch 工具可用
  162. ---
  163. ## 🔄 新增功能(v2.0)
  164. ### 1. 智能推荐算法升级
  165. 借鉴 **X For You 推荐算法**(参考 `X-For-You-Feed-Algorithm.md`),引入:
  166. - **多源候选**:In-Network(关注源)+ Out-of-Network(探索 20%)
  167. - **加权多维评分**:`FinalScore = Σ(w_i × s_i) - NegPenalty`
  168. - **多样性控制**:来源衰减(`0.6^(N-1)`)+ 话题聚类去重
  169. - **反馈闭环**:正/负样本库 + 事件日志(JSONL)
  170. ### 2. A/B 变体 + Critic 自检
  171. - 默认生成 **Variant A** 和 **Variant B**(hook/结构差异)
  172. - Critic 对每个变体打分 0-10,评估:Hook强度、信息密度、可读性、可信度、账号匹配、行动导向
  173. - 若两版都 < 7 分,自动重写一次
  174. - 输出包含 `CREATE_JSON` 和 `HOOKS_JSON` 供状态管理脚本使用
  175. ### 3. 意图驱动路由
  176. 根据**目标动作**自动选择创作模式:
  177. - 收藏/转发 → 高价值干货
  178. - 讨论/对立 → 犀利观点
  179. - 时效/热点 → 热点评论
  180. - 共鸣/关注 → 故事洞察
  181. - 专业/技术 → 技术解析
  182. ### 4. 相似度过滤(无需 Embedding)
  183. 基于字符 2/3-gram + 词 Jaccard + 序列相似度:
  184. - 对比候选选题与 `rejected_topics.json`
  185. - 相似度 ≥ 0.85:强扣分或直接淘汰
  186. - 相似度 0.75~0.85:软扣分(-2分)
  187. ### 5. 结构化输出(JSON Hooks)
  188. 每个 skill 输出末尾追加机器可读的 JSON 块:
  189. - `MATERIALS_JSON`(x-collect)
  190. - `FILTER_JSON`(x-filter)
  191. - `CREATE_JSON` + `HOOKS_JSON`(x-create)
  192. - `PUBLISH_JSON`(x-publish)
  193. 便于 hooks 自动收集反馈并调用 `x_state.py` 落盘。
  194. ---
  195. ## ❓ 常见问题
  196. <details>
  197. <summary><b>Q: 首次使用需要配置什么?</b></summary>
  198. 只需运行 `/x-create`,按提示回答3个问题即可完成初始化。配置会自动保存,后续无需再次设置。
  199. </details>
  200. <details>
  201. <summary><b>Q: 如何修改打分权重?</b></summary>
  202. 编辑 `x-create/references/user-profile.md` 中的 `scoring` 部分,调整各维度权重和入选阈值。
  203. </details>
  204. <details>
  205. <summary><b>Q: x-publish 会自动发布推文吗?</b></summary>
  206. **不会**。x-publish 只会将内容保存到 X 的草稿箱,需要你手动审核后发布。这是出于安全考虑的设计。
  207. </details>
  208. <details>
  209. <summary><b>Q: 如何添加自己喜欢的爆款推文作为参考?</b></summary>
  210. 将推文内容保存为 `.md` 文件,放入 `x-create/assets/templates/` 对应的分类目录中。创作时会优先学习这些风格。
  211. </details>
  212. <details>
  213. <summary><b>Q: 支持英文推文吗?</b></summary>
  214. 支持。在用户配置中将 `language` 改为 `en` 或 `target_audience` 改为"英文用户"即可。
  215. </details>
  216. ---
  217. ## 🤝 贡献指南
  218. 欢迎提交 Issue 和 Pull Request!
  219. - **Bug 反馈**:请描述复现步骤和预期行为
  220. - **功能建议**:请说明使用场景和需求
  221. - **PR 提交**:请确保代码通过 skill-creator 验证
  222. ---
  223. ## 📄 许可证
  224. 本项目基于 [Apache License 2.0](LICENSE) 开源。
  225. ---
  226. ## 🔗 相关链接
  227. - [Claude Code](https://github.com/anthropics/claude-code) - Anthropic 官方 CLI
  228. - [Playwright MCP](https://github.com/microsoft/playwright-mcp) - 浏览器自动化
  229. - [X For You Feed Algorithm](./X-For-You-Feed-Algorithm.md) - X 推荐算法参考文档
  230. - [优化方案文档](./x-skills-optimization.md) - 详细的算法升级方案
  231. ---
  232. **Made with ❤️ for X creators**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.