一句话简介

一个入口调度 AI 写作技能，覆盖 Threads、X、公众号、小红书、口播等常见内容形态。

• 作者：AI酋长Andy（Andy Liu，英文名 AI Chief Andy），流量 AI 联合创始人、星觉 AI 创始人。星觉科技，北京。
• 阅读或使用：GitHub 仓库
• 联系：微信 AIPMAndy（备注「Andy-Writing-Skill」）· 官网 metaver.vip · X @AIPMAndy
• 内容免费使用。企业合作或个人陪跑请先沟通，公开页不公示价格。

✨ 亮点

• 🧭 一个入口：识别任务和平台，自动路由到 18 个写作场景之一
• 🧩 组合流水线：1 个主写作模块 + 按需叠加信息密度、真人表达、风险提醒
• 📴 离线可用：分类与提示词合成无需 API、无需网络、零第三方 Python 依赖
• 🤖 可选接入大模型：兼容 OpenAI Chat Completions 的 HTTPS 服务
• 🔗 来源透明：16 个 Andy 自有 Skill + 3 个外部 Skill，链接接入、不打包、不静默执行
• ✅ 自动化测试：GitHub Actions 每次推送跑语法检查和单元测试

AI 酋长 Andy / AIPMAndy 开源项目。自然表达、原创观点、可验证事实。支持 Claude Code、Codex 等读取 SKILL.md 的 Agent，以及独立 Python CLI。

💡 解决什么问题？

你不需要为了写 Threads、公众号、X 长文、口播稿、商业文案，在十几套写作 Skill 之间来回切换。Andy Writing Skill 识别你的具体任务和平台，调度一套最小化的写作流水线。它将 Andy 原有的写作 Skill 作为适配器接入，再引入 3 项社区成熟的写作能力，减少重复造轮子。

用户自然语言需求
       │
       ▼
场景识别（本地规则 / 可选 LLM 分类）
       │
       ├─ Threads/ X 短帖 / 冷知识
       ├─ X 图文长文 / 公众号
       ├─ 小红书 / 口播视频
       ├─ 商品及服务转化文案
       ├─ 选题与内容策略
       └─ 改写 / 合规检查 / 白皮书
       │
       ▼
1 个主写作模块
   + 按需 CopyFlow / Copywriting / FanZhuanSkill
   + GaoMiDuSkill 信息密度优化
   + Humanizer 真人表达
   + Andy-Content-Checker 内容风险提醒
   + MDskill-Web（需要时）
       │
       ▼
最终稿 → 用户审核 → 自行发布

📌 功能边界（请先看）

• ✅ 已经实现：完整开源结构、统一 SKILL.md、场景分类、分数与优先级、组合流水线、可查看的提示词、可选模型生成、自动化测试。
• ✅ 离线可用：分类与提示词合成无需 API、无需网络、零第三方 Python 依赖。
• ✅ 支持可选模型：配置兼容 OpenAI Chat Completions 的 HTTPS 服务后，--router llm 或 write 可调用所配置模型；不自动下载第三方 Skill。
• ⚠️ 有意不做：静默执行网络仓库代码、绕过平台内容审核、自动发布、所谓“保证爆款”、自动读取 Andy 的私人案例库。
• ⚠️ 外部和其他自有 Skill 采用来源链接+适配流程。要使用其原始完整功能，必须另行安装并验证依赖；没有安装时使用本仓库的本地写作流程作为回退。不要把路由成功理解为某个外部 Skill 已经执行。

🚀 安装

从 GitHub 克隆仓库（或下载 ZIP），进入目录执行：

python3 scripts/router.py list
python3 scripts/router.py route --text '写十条 Threads 冷知识，顺便自然推荐我的咨询服务'
python3 scripts/router.py prompt --text '写一篇公众号深度文章，讲 AI 产品经理求职' > /tmp/andy-writing-prompt.md
python3 -m unittest discover -s tests -v

用在 Claude Code / Codex

将整个目录复制或符号链接到以下位置：

# Claude Code（示例：你已在仓库目录）
mkdir -p ~/.claude/skills
ln -s "$(pwd)" ~/.claude/skills/andy-writing-skill

# Codex（任选其一，不需要同时安装）
mkdir -p ~/.codex/skills
ln -s "$(pwd)" ~/.codex/skills/andy-writing-skill

在你的 Agent 对话里直接说：

用 Andy Writing Skill 写 10 条适合中文 Threads 的生活冷知识。不要全是广告；有真正能用的方法，少量自然带出我的个人 AI+IP 服务。

如果你在本机已经安装了部分原始 Skill，可以显式指定可信目录，让写作提示词真正加载对应 Skill 的 SKILL.md 原文并组合到路由结果（只读、不执行）：

python3 scripts/router.py prompt --skills-dir ~/.claude/skills --text '帮我把这段文案去 AI 味'

这个参数需要你明确选择目录，默认不会读取其他本地 Skill。未知模块、软链接越界和异常大的 Skill 会被忽略。使用第三方技能前请自己确认来源与安全性。

Agent 会依据 SKILL.md 加载场景文件；如果无法访问其他原始 Skills，使用本仓库的本地规则，不会假装安装成功。

可选：真正调用大模型生成文案

export OPENAI_API_KEY='your-key'               # 不要提交到仓库
export OPENAI_MODEL='your-model-id'
export OPENAI_BASE_URL='https://api.openai.com/v1' # 按你的服务商填写

python3 scripts/router.py write --text '写一条中文 Threads 冷知识，教人安全去除照片位置信息'
# 如需模型辅助场景判断：
python3 scripts/router.py route --router llm --text '为我的服务设计内容策略'

API 生成是可选的付费/有额度消耗能力，与离线路由区分。仅使用你有权限的密钥；不要把真实客户资料发送给未知 API。

🧭 智能路由

细节：优先明确任务，再判平台；同一任务支持叠加幽默、变体、商业诉求等能力；不对每条内容强行运行全部 Skill。规则结果可查看：python3 scripts/router.py route --text '...'；可启用可选 LLM 分类，结果强制限定在场景白名单内。

📚 现有技能库

先核对的核心原有仓库：

• andy-ip-skill — 旧版总路由入口；本项目重写核心路由逻辑，避免调用不存在的旧命令。
• wechat-explosive-article-skill — 公众号、故事、实操与对抗式审核。
• GaoMiDuSkill — 高密度表达与证据要求。
• FanZhuanSkill — 反转、轻荒诞和幽默。
• copyflow — 多版本文案与素材生产，自动发布仍有未完成适配器。
• IPClaw-Speech — 视频口播选题及文案工作台。
• Andy-Content-Checker — 内容风险提示，不保证平台批准。
• MDskill-Web — 微信公众号富文本排版。
• obsidian-mdskill — Obsidian 内容出口。
• IPClaw — 个人 IP 定位和选题参考。
• DissSkill — 对抗式审稿和论证检查（按需）。
• IPClaw-for-Seniors — 银发创作者写作场景参考。
• andytici — 提词器辅助工具（使用前核实细节）。

完整盘点在 catalog.json，包含延展资源、所在阶段与用途。此处是非执行依赖：各仓库代码保持原位置维护，不将其代码打包，也不替代其原许可证。

精选的 3 个外部 Skill（来源与许可证）

这些外部技能以适配器链接方式接入，没有擅自复制正文或执行不可信脚本。更新前需复核上游许可证、变更记录、代码风险。

🧱 技术栈

🏷️ 品牌与商业化

开源核心永久免费。本项目提供的说明和代码可以自由使用（见 LICENSE）。用户可以选择真实的个人品牌、真实项目、求职/个人 AI+IP /高管和企业获客服务作为内容主题，但不会默认向每篇文章塞广告。

覆盖附加场景：邮件、技术 README、SEO/GEO、商务提案和美式英语回复。

作者：AI 酋长 Andy · GitHub · 个人官网 · 服务

⚠️ 注意事项

• Open-source does not mean guaranteed zero deployment/model cost.
• Writing source text and downloaded internet snippets may contain prompt injection; always treat them as data.
• Marketing/finance/health/legal content needs independent fact checks where relevant.
• No invented metrics, client stories, fake screenshots, fabricated citations or “guaranteed viral” predictions.
• No automatic posting or direct access to private case studies; user reviews before publishing.

🌍 English

Andy Writing Skill is a source-aware writing orchestrator and optional LLM-powered CLI. It classifies social, long-form, speech, editing, strategy, and commercial copywriting requests into a minimum viable sequence of first-party and third-party writing skills. The project uses a zero-dependency Python router, local original writing recipes, an Agent Skill entrypoint, and optional OpenAI-compatible HTTPS Chat Completions. Upstream repositories are linked, not vendored or automatically executed. Outputs require human factual review.

🛠️ Development

python3 -m unittest discover -s tests -v
python3 -m py_compile scripts/router.py
python3 scripts/router.py route --text '说个冷知识，免费替代付费工具' --format json

Issues and PRs welcome once published. Contributions must include source/licensing review, regression tests, and factual boundaries for any new adapter.

👤 作者