simp-skill

by BeamusWayneVerified

不教 PUA,只教真心。Win your crush before it's too late. Inspired by colleague-skill(同事skill)

279
Stars
18
Forks
Python
Language
8/23/2026
Added
View on GitHubDownload ZIP

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillTip is an informational directory and does not control or maintain the underlying repository. Any security checks displayed are automated and limited in scope. Review the source code before installing.

Read the Terms of Service

Installation

Add to your Claude Code skills directory:

# Add to your Claude Code skills
git clone https://github.com/BeamusWayne/simp-skill

Getting Started

Guides for using skills like simp-skill.

Security Report

Verified

Last scanned: —

{
  "status": "PASSED",
  "issues": []
}

README.md

💝 simp-skill

"茫茫人海,一旦错过就不再。"

simp,是那个敢于真心喜欢一个人的人。这里教的,是把真心说出口的能力。

License: MIT Python 3.9+ Claude Code 追爱军师


不教套路,不玩 PUA,只相信一件事——真心,是最强的攻略。
提供聊天记录、社交媒体截图、照片,生成信号分析报告。
量化感情温度,定制追求策略,把心上人追到手。


快速开始 · 指令列表 · 危机处理 · 更新日志 · English


它能帮你做什么

功能描述
🔍 信号解读帮你分析聊天记录,判断对方发出了什么信号
📝 情话生成根据对象性格和当前情境,生成专属情话
🗺️ 策略规划制定从破冰到表白的完整追求路线图
💌 表白定制帮你准备让对方难忘的表白词
🆘 危机处理被拒/冷落/翻车/友谊区,每种危机都有应对方案
📊 聊天分析自动分析微信/QQ聊天记录,量化感情温度
🧬 MBTI 分析推断心上人 MBTI,输出 16 型专属追求策略与双方兼容性
📈 进度追踪阶段进度条 + 热度趋势对比,每次都能看到关系变化曲线
🍃 放弃判断帮你看清是真心还是执念,该继续还是该放下
⏱️ 互动时间分析互动频率追踪、追求阶段时长、回复时间分析、黄金时段建议

两种风格,随时切换

💖 纯情模式

不算计,不套路,用真实的情感打动对方。适合感性的心上人,或者你就是想真诚地表达自己。

"你笑的时候,我突然就不想说话了,只想多看一会儿。"

🎯 策略模式

懂得何时推进、何时留白,让对方主动靠近。适合理性的心上人,或者暧昧陷入僵局。

"你刚才说的那件事,让我想了很久。"(留悬念,等对方追问)


快速开始

安装

# 全局安装(所有项目可用)
git clone https://github.com/BeamusWayne/simp-skill ~/.claude/skills/simp-skill

# 或项目级安装
git clone https://github.com/BeamusWayne/simp-skill .claude/skills/simp-skill

基本使用

/simp                          — 显示主菜单
/simp create 小美               — 建立心上人档案,开始追求旅程
/simp analyze                  — 解读最近的信号
/simp message 她今天生病了        — 生成情境专属消息
/simp confess                  — 准备表白
/simp crisis 突然不回我消息了      — 危机处理
/simp progress                 — 评估当前进度
/simp mode sweet               — 切换到纯情模式

使用数据分析工具(可选)

聊天记录分析(解读信号、量化感情温度):

# 把微信/QQ聊天记录导出后放到 crushes/{名字}/memories/chats/
python3 tools/chat_parser.py 导出的聊天记录.txt 小美
python3 tools/chat_parser.py 导出的聊天记录.txt 小美 --output crushes/xiaomei/memories/chats/analysis.md

支持格式:微信 TXT / HTML / CSV(WeChatMsgPyWxDump)、QQ TXT / MHT、通用 JSON

社交媒体内容分析(朋友圈截图、微博、小红书等):

# 把截图/导出文件放到 crushes/{名字}/memories/social/
python3 tools/social_parser.py --dir crushes/xiaomei/memories/social --target 小美
python3 tools/social_parser.py --dir crushes/xiaomei/memories/social --target 小美 --output report.md

照片元数据分析(提取拍摄时间线,检测可能的约会记录):

# 需要先安装:pip install Pillow
python3 tools/photo_analyzer.py --dir crushes/xiaomei/memories/photos --target 小美
python3 tools/photo_analyzer.py --dir ./photos --target 小美 --output report.md

时间追踪工具(互动频率、回复速度、黄金时段分析):

# 自动:通过聊天解析(同时记录互动时间)
python3 tools/chat_parser.py 聊天记录.txt 小美 --track-time --slug xiaomei

# 手动:记录见面
python3 tools/time_tracker.py record xiaomei meeting --duration 180 --activity "咖啡+散步"

# 手动:记录消息
python3 tools/time_tracker.py record xiaomei chat_sent --summary "问她周末有没有空"

分析时间数据:

# 完整时间分析报告
/simp timeline xiaomei

# 单维度分析
/simp timeline xiaomei --frequency   # 互动频率
/simp timeline xiaomei --milestones  # 追求进度
/simp timeline xiaomei --reply       # 回复速度
/simp timeline xiaomei --golden      # 黄金时段

指令完整列表

指令说明
/simp显示主菜单和当前状态
/simp create <名字>建立心上人档案
/simp list查看所有心上人档案
/simp analyze [描述]解读信号,判断当前阶段
/simp message <情境>生成情境专属消息/情话
/simp confess表白策略 + 表白词定制
/simp daily今日撩人小建议
/simp crisis <情况>危机处理
/simp progress进度评估与下一步建议
/simp quit放弃判断器
/simp mode sweet切换到纯情模式 💖
/simp mode strategic切换到策略模式 🎯
/simp mode hybrid切换到混合模式 ✨(默认)
/simp update <名字>更新心上人档案
/simp mbti [描述/类型]MBTI 推断 + 16 型追求策略 + 兼容性分析

危机处理覆盖范围

  • C-1 明确被拒 → 如何优雅接受 + 何时可以重启
  • C-2 突然冷落/已读不回 → 观察期 + 重新出现话术
  • C-3 渐渐疏远 → 制造缺席感 + 改变互动方式
  • C-4 进入友谊区 → 三步破围法
  • C-5 说错话翻车 → 6-24小时内修复方案
  • C-6 竞争对手出现 → 差异化价值策略
  • C-7 表白被挂起 → 等待期策略
  • C-8 暧昧期停滞 → 破局三法
  • C-9 误会/争吵 → 修复话术框架
  • C-10 单方面付出 → 停止主动观察法
  • C-11 对方开始了新感情 → 72小时情绪处理 + 两条路线选择

档案结构

crushes/
└── {slug}/
    ├── profile.md          — 心上人基本信息与画像(YAML frontmatter + 叙述)
    ├── state.md            — 当前状态快照(阶段、评分、最近信号、下一步)
    ├── events.jsonl        — 事件流,只追加,永不删除(追求轨迹)
    ├── interactions.jsonl  — 互动时间记录(见面/消息/回复时间线)
    ├── strategy.md         — 个性化追求策略
    ├── meta.json           — 档案元数据(阶段/评分/模式/事件数)
    ├── snapshots/          — 按日快照(用于跨会话快速恢复)
    ├── versions/           — 历史版本备份
    └── memories/
        ├── chats/          — 聊天记录分析结果
        ├── social/         — 社交媒体内容(截图/导出)
        └── photos/         — 照片(EXIF分析/约会检测)

记忆系统设计与读写协议详见 docs/MEM-SYS.md


档案管理工具

# 列出所有档案
python3 tools/skill_writer.py --action list

# 初始化新档案
python3 tools/skill_writer.py --action init --slug xiaomei

# 备份当前版本
python3 tools/skill_writer.py --action backup --slug xiaomei

# 查看版本历史
python3 tools/skill_writer.py --action versions --slug xiaomei

# 回滚到某个版本
python3 tools/skill_writer.py --action rollback --slug xiaomei --version v2

记忆系统工具

# 追加一条事件
python3 tools/memory.py append xiaomei signal_recorded '{"direction":"green","content":"深夜主动消息","score_delta":3}'

# 查看最近 5 条事件
python3 tools/memory.py events xiaomei --last 5

# 拼装当前上下文(profile + state,给 Claude 注入)
python3 tools/memory.py context xiaomei

# 生成今日快照
python3 tools/memory.py snapshot xiaomei

# 查看完整时间线
python3 tools/memory.py timeline xiaomei

设计原则

  1. 真心优于套路 — 所有策略的底层是真实的感情
  2. 专属感优于模板 — 生成的情话嵌入你们之间真实的细节
  3. 尊重对方意愿 — 如果对方明确拒绝,帮助优雅放手,不强行继续
  4. 数据本地化 — 所有分析在本地进行,聊天记录不上传任何服务器
  5. 不教 PUA — 任何操控类、让对方不安全感的话术,一律不用

完整的产品设计逻辑、双模式设计决策、伦理边界定义,见 docs/PRD.md


写给自己,也献给你

茫茫人海,一旦错过就不再。

有些话,不是不想说,是不知道怎么说。等到知道了,有些人已经不在了。

写这个的时候,我想的不是怎么追到一个人。

我想的是,有多少人心里明明装着一个人,却不知道怎么开口。不是不在乎,是不会表达。不是不爱,是爱的方式对方感受不到。

这个工具能帮你说出你想说的话,能帮你看懂一些信号,能在你翻车的时候递给你一个台阶。但有一件事它做不到:替你喜欢那个人。那件事,从来都只能是你。

爱人是一种能力,但不只是一种技能。技能可以靠方法复刻,能力不一样——它需要你真的进场,真的犯错,真的在某个夜里想起一个人,不知道该怎么办,然后慢慢学会。

每个人希望被爱的方式不一样。有人需要你说出来,有人需要你做到。有人需要你在,有人需要你懂得走开。这件事没有人天生就会。

如果这个项目能帮你多了解一个人一点,帮你多表达一点——那就够了。

追没追到,是另一回事。学着去爱,才是这件事真正的结果。


许可证

MIT License — 自由使用,记得去追你的心上人。


Made with 💝 by Beamus Wayne
愿每一份真心都有回应。

Frequently Asked Questions

What is simp-skill?

simp-skill is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by BeamusWayne. 不教 PUA,只教真心。Win your crush before it's too late. Inspired by colleague-skill(同事skill). It has 279 GitHub stars.

Is simp-skill safe to use?

Yes. simp-skill passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install simp-skill?

Clone the repository with "git clone https://github.com/BeamusWayne/simp-skill" and add it to your Claude Code skills directory (see the Installation section above). simp-skill ships a SKILL.md manifest, so compatible agents can discover and load it automatically.

What programming language is simp-skill written in?

simp-skill is primarily written in Python. It is open-source under BeamusWayne on GitHub, so you can review or fork the full source.

Are there alternatives to simp-skill?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh simp-skill against similar tools.

Comments (0)

No comments yet. Be the first to share your thoughts!

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI Agentsai-agentsanthropicclaude-code
View details
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI Agentsai-agentsbrainstorming
View details

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI Agentsai-agentsanthropicclaude-code
View details

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI Agentsclaude-codeai-tools
View details

claude-code

by anthropics

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

120,03119,897Shell
AI Agents
View details

Developers Also Liked

Based on votes and bookmarks from developers who liked this skill

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI Agentsai-agentsanthropicclaude-code
View details
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI Agentsai-agentsbrainstorming
View details

n8n

by n8n-io

12

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

201,88160,308TypeScript
MCP Serversapisai-tools
View details

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI Agentsai-agentsanthropicclaude-code
View details

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI Agentsclaude-codeai-tools
View details