📌 Skill 基础信息
Skill 名称:Ghostwriter
简称:ghostwriter
来源:社区第三方(joshferrara)
运行宿主:通用 Agent 工具(Claude Code、Codex、OpenCode/OpenClaw 风格 Agent、Hermes 等本地 Agent)
核心定位:通过分析用户已发送的写作内容,生成个性化写作风格指南,让 AI 能够以用户的真实口吻进行写作和编辑。
🧩 内部核心组成
能力模式
- Generate 模式:从用户实际发送的邮件、短信、Slack 消息等内容中分析并生成个人写作风格指南
- Use 模式:加载已有风格指南,以用户口吻进行起草或编辑
参考文件系统
references/
├── source-detection.md # 环境访问检测指南
├── gmail-gogcli.md # Gmail via gog CLI
├── gmail-googleworkspace-cli.md # Gmail via gws CLI
├── local-email-exports.md # 本地邮件导出处理
├── imessage-macos.md # macOS iMessage 处理
├── slack.md # Slack 集成指南
├── generic-corpora.md # 通用文本语料处理
├── analysis-framework.md # 写作维度分析框架
└── humanizer-cleanup.md # AI 痕迹清理指南
模板文件
templates/ghostwriter-guide.template.md:风格指南模板
核心工作流程
| 阶段 | 功能描述 |
|---|---|
| 源检测 | 检测当前环境的现有访问能力 |
| 源选择 | 提供多种数据源选项供用户选择 |
| 隐私确认 | 在数据收集前明确隐私边界 |
| 数据收集 | 仅收集已发送消息,过滤噪音内容 |
| 模式分析 | 从多个维度分析写作特征 |
| 指南生成 | 生成可直接使用的 Markdown 风格指南 |
🛠 安装与启用方式
安装命令:
skills install --user joshferrara/ghostwriter
前置要求:
- 支持的文件访问能力(取决于选择的源)
- 对于特定源可能需要相应的 CLI 工具:
- Gmail:gog CLI 或 gws CLI
- iMessage:macOS 系统访问权限
- Slack:MCP 服务器或 API 访问
启动方式:通过自然语言指令触发相应模式
📋 标准工作流
Generate 模式(生成风格指南)
- 模式识别:根据用户请求识别需要生成指南
- 环境检测:检查当前 Agent 环境的现有访问能力
- 源选择:提供数据源选项,用户选择最适合的方式
- 隐私确认:明确数据使用边界,获得用户确认
- 数据收集:收集用户已发送消息,过滤噪音内容
- 模式分析:从语调、节奏、句式等维度分析写作特征
- 指南生成:生成
ghostwriter-guide.md风格指南文件
Use 模式(使用风格指南)
- 指南查找:在工作目录中查找现有的风格指南
- 指南读取:完整读取并理解用户的写作风格指南
- 需求确认:仅询问指南中未包含的必要信息
- 初稿起草:以用户风格为首要参考进行写作
- AI 痕迹清理:使用 Humanizer 进行二次清理,不冲突用户风格
- 交付成品:返回符合用户风格的最终稿件
⚠️ 关键限制、缺陷、注意事项
平台限制:
- iMessage 源仅支持 macOS 系统
- 某些数据源需要特定的 CLI 工具或 API 访问权限
Token 消耗:
- Generate 模式需要处理大量历史消息,token 消耗较高
- 建议从几百条消息开始,50-100 条即可生成可用指南
适用项目:
- ✓ 个人写作风格标准化
- ✓ 商务邮件、客户沟通一致性
- ✓ 多平台写作风格统一
不适用场景:
- ✗ 需要引用原始私人消息的场景(除非用户明确要求)
- ✗ 高度格式化或技术性文档编写
- ✗ 需要完全匿名或通用化写作的场景
生产环境适用性:适合个人和专业使用,但需注意隐私保护
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景
- 个人用户:希望 AI 辅助写作但保持个人风格的创作者
- 商务人士:需要保持专业沟通一致性的邮件和消息撰写
- 团队领导:希望统一团队对外沟通风格的管理者
- 内容创作者:需要在不同平台保持统一声音的作者
❌ 不适合场景
- 完全匿名写作:需要隐藏个人写作特征的场景
- 高度技术文档:需要严格遵循技术写作规范的内容
- 法律合规文件:需要完全中立客观的法律文书撰写
- 多作者协作:需要融合多人风格的集体创作场景
如何安装
skills install --user joshferrara/ghostwriter通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)
桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。
Claude Code(终端 CLI)
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。
VS Code(含 GitHub Copilot)
打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。
Windsurf
底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。
其他工具(ChatGPT、本地脚本等)
不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。
Aitishiku.com