名称： solobuddy
描述： 独立开发者的“公开构建”伙伴——内容工作流、Twitter互动、项目灵魂塑造。一个鲜活的助手，而非工具。
主页： https://github.com/gHashTag/bip-buddy
元数据： {"clawdbot":{"emoji":"🎯","requires":{"bins":["gh"],"optional":["bird"]},"config":["solobuddy.dataPath","solobuddy.voice"]}}

SoloBuddy

“公开构建”内容助手。一个鲜活的伙伴，而非工具。

快速开始

1. 在 ~/.clawdbot/clawdbot.json 中设置你的数据路径：

{
  "solobuddy": {
    "dataPath": "~/projects/my-bip-folder",
    "voice": "jester-sage"
  }
}

2. 创建文件夹结构（请替换为你自己的路径）：

mkdir -p ~/projects/my-bip-folder/ideas ~/projects/my-bip-folder/drafts ~/projects/my-bip-folder/data
touch ~/projects/my-bip-folder/ideas/backlog.md

3. 开始使用：输入“显示待办事项”、“新想法”、“生成帖子”等命令。

占位符

ClawdBot 会自动在命令中替换这些占位符：
- {dataPath} → 你配置的 solobuddy.dataPath
- {baseDir} → 技能安装文件夹

数据结构

所有数据位于 {dataPath} 下：
- ideas/backlog.md — 想法队列
- ideas/session-log.md — 会话记录
- drafts/ — 进行中的草稿
- data/my-posts.json — 已发布的帖子
- data/activity-snapshot.json — 项目活动快照（每小时更新）

语音风格

在 solobuddy.voice 中配置。可选风格：

查看 {baseDir}/prompts/profile.md 获取语音风格详情。

功能模块

内容生成

核心工作流：待办事项 → 草稿 → 发布。
查看 {baseDir}/prompts/content.md 了解生成规则。

Twitter 专家

针对 X/Twitter 的内容策略，包含 2025 年算法洞察。
查看 {baseDir}/modules/twitter-expert.md

Twitter 监控（可选）

主动互动——监控关注列表，建议评论。
要求：bird CLI。查看 {baseDir}/modules/twitter-monitor.md

灵魂向导

从项目文档中创建项目人格。
查看 {baseDir}/references/soul-wizard.md

命令

待办事项

显示想法：

cat {dataPath}/ideas/backlog.md

添加想法：

echo "- [ ] 新想法文本" >> {dataPath}/ideas/backlog.md

会话日志

查看最近记录：

tail -30 {dataPath}/ideas/session-log.md

添加记录：

echo -e "## $(date '+%Y-%m-%d %H:%M')\n文本" >> {dataPath}/ideas/session-log.md

草稿

列出：ls {dataPath}/drafts/
读取：cat {dataPath}/drafts/<名称>.md

保存草稿：

cat > {dataPath}/drafts/<名称>.md << 'EOF'
内容
EOF

发布

cd {dataPath} && git add . && git commit -m "content: add draft" && git push

项目活动

读取活动快照以获取战略背景：

cat {dataPath}/data/activity-snapshot.json

字段说明：
- daysSilent — 距离上次提交的天数
- commitsToday/Yesterday/Week — 活动强度
- phase — 当前状态：活跃/有动力/冷却/静默/休眠
- insight — 人类可读的总结

状态阶段：
- active — 今日有提交，项目活跃
- momentum — 昨日活跃，今日安静（推动机会）
- cooling — 静默 2-3 天，动力减弱
- silent — 静默 3-7 天，需要关注
- dormant — 静默 7 天以上，暂停或已放弃

用于战略建议：
- “sphere-777 今日有 10 次提交——正专注于此”
- “ReelStudio 已静默 5 天——我们是否应该处理？”

Telegram 集成

在 Telegram 中回复时，包含用于操作的内联按钮。

发送带按钮的消息

clawdbot message send --channel telegram --to "$CHAT_ID" --message "文本" \
  --buttons '[
    [{"text":"📋 待办事项","callback_data":"sb:backlog"}],
    [{"text":"✍️ 草稿","callback_data":"sb:drafts"}],
    [{"text":"💡 新想法","callback_data":"sb:new_idea"}]
  ]'

回调数据格式

所有回调使用前缀 sb:：
- sb:backlog — 显示想法
- sb:drafts — 列出草稿
- sb:new_idea — 提示输入新想法
- sb:generate:<N> — 从第 N 个想法生成内容
- sb:save_draft — 将当前内容保存为草稿
- sb:publish — 提交并推送
- sb:activity — 显示项目活动
- sb:twitter — 检查 Twitter 机会

主菜单

触发方式：输入“菜单”、“开始”，或完成操作后：

[
  [{"text":"📋 想法","callback_data":"sb:backlog"}, {"text":"✍️ 草稿","callback_data":"sb:drafts"}],
  [{"text":"📊 活动","callback_data":"sb:activity"}],
  [{"text":"💡 添加想法","callback_data":"sb:new_idea"}],
  [{"text":"🎯 生成帖子","callback_data":"sb:generate_menu"}]
]

生成流程

显示待办事项后：

[
  [{"text":"1️⃣","callback_data":"sb:generate:1"}, {"text":"2️⃣","callback_data":"sb:generate:2"}, {"text":"3️⃣","callback_data":"sb:generate:3"}],
  [{"text":"◀️ 返回","callback_data":"sb:menu"}]
]

生成内容后：

[
  [{"text":"💾 保存草稿","callback_data":"sb:save_draft"}],
  [{"text":"🔄 重新生成","callback_data":"sb:regenerate"}],
  [{"text":"◀️ 菜单","callback_data":"sb:menu"}]
]

内容生成流程

1. 读取待办事项，找到想法
2. 读取 {baseDir}/prompts/content.md 获取规则
3. 读取 {baseDir}/prompts/profile.md 获取语音风格
4. 使用配置的语音风格生成内容
5. 显示按钮：保存 / 重新生成 / 菜单

灵魂创建

从项目文档中创建项目人格。

触发方式：“为 <路径> 创建灵魂”

查看 {baseDir}/references/soul-wizard.md 获取完整的 5 步向导：
1. 扫描项目 .md 文件
2. 询问：本质（生物/工具/向导/艺术家）
3. 询问：声音（俏皮/技术/诗意/平静/激烈）
4. 询问：哲学（自动提取或自定义）
5. 询问：梦想与痛点
6. 保存到 {dataPath}/data/project-souls/<名称>.json

语言

匹配用户语言：
- 俄语输入 → 俄语回复 + 按钮
- 英语输入 → 英语回复 + 按钮