shengjidaguai-china/goutoujunshi

What it is

Goutoujunshi (狗头军师) is an open‑source AI “relationship coach” skill that can be added to a conversational AI assistant (e.g., a ChatGPT‑style bot). It helps users who are navigating romantic or interpersonal situations – from first‑date nerves to break‑ups – by:

• analysing the user’s emotions and the facts of the relationship,
• pulling relevant knowledge from a curated “relationship science” library, and
• generating concrete, actionable next‑steps (a message to send, an invitation, a plan for a first meeting, etc.).

The project bundles the prompt templates, workflow logic and a small knowledge base; the heavy lifting (language generation) is delegated to an LLM service such as OpenAI’s Codex.

---

Core features (as described in the README)

Feature	What it does
Emotion capture	The skill first asks the user to describe how they feel, then uses that as context for the advice.
Relationship‑profile building	Users (and their counterpart(s)) can provide MBTI, a 0‑100 “compatibility score”, background events, etc. The skill stores a concise profile for later reuse (with explicit consent).
Chat analysis	Optional integration with ChatLab lets the skill ingest exported chat logs or screenshots, separate speakers, and distinguish fact, speculation and unknowns.
Knowledge‑driven reasoning	A 135‑item reference library covering psychology, communication tactics, legal safety, etc., is consulted to ground the suggestions.
Actionable output	The assistant returns a ready‑to‑send line of text, a concrete plan (e.g., “invite them for coffee on Friday at 3 pm”), and follow‑up windows or stop‑conditions.
Long‑term memory (opt‑in)	After the first consent, a lightweight local memory store remembers the relationship profile across sessions; users can view, pause, revoke or delete it at any time.
Safety & ethics	The skill refuses to give advice on violent, coercive or illegal actions and explicitly warns that it is not a substitute for professional therapy or legal counsel.
Inclusive design	Supports all sexual orientations, gender identities and relationship structures; the model does not assume any fixed gender roles.

---

How to get started

1. Install the skill – send the following command to your AI assistant:

   请将公开仓库 https://github.com/shengjidaguai-china/goutoujunshi 下载并安装为本地 Skill。
   

2. Invoke it – after installation, ask:

   请使用狗头军师帮我梳理情绪、分析当前关系，并给出下一步建议。
   

3. Provide initial data – the skill will prompt for:
   • your MBTI / self‑rating, strengths & weaknesses
   • the counterpart’s code name, MBTI, rating, and relationship status
   • how you met, key events, current investment, and your goal (e.g., pursue, repair, exit)
   • the most painful emotion right now and its intensity You can leave any field blank or tell a story; the skill will extract the needed facts.
4. Optional chat‑log analysis – install the optional ChatLab tool, feed it exported chat files or screenshots, and ask the skill to analyse the last three months.

---

Project layout (high‑level)

• SKILL.md – the core workflow definition (how the skill routes user input, builds the profile, and calls the LLM).
• agents/openai.yaml – default prompt template used with OpenAI’s Codex model.
• references/ – the curated knowledge base (scientific papers, psychology textbooks, legal guidelines, etc.).
• documentation/ – architecture diagrams, safety boundaries, and data‑flow explanations.
• scripts/validate_skill.py – a CI script that checks the skill package for required files and context limits.
• scripts/memory_store.py – implements the consent‑gated local memory, with functions to add, retrieve, pause, revoke or delete stored profiles.

---

Who might use it

• Individual users who want AI‑assisted, evidence‑based advice for dating or relationship dilemmas.
• Developers of AI assistants (e.g., custom ChatGPT bots) looking for a ready‑made “relationship‑coach” skill to plug in.
• Researchers or educators interested in how LLMs can be combined with domain‑specific knowledge bases and consent‑driven memory.

---

License & contribution

The code and knowledge assets are released under the MIT License, allowing commercial use, modification and redistribution as long as the original copyright notice is kept. Contributions are welcomed via pull requests; a CONTRIBUTING.md file outlines the process.

---

Bottom line: Goutoujunshi is a specialized AI skill that leverages large‑language‑model generation together with a curated relationship‑science knowledge base and optional local memory to give users concrete, ethically‑aware advice on romantic and interpersonal situations.