name: liudao-heritage description: Search, enrich, and manage family heritage and historical relationship data from the LiùDào (六道) SQLite database. Use this skill when answering questions about historical figures, calculating relationship paths (A的B), or adding new personal records with privacy controls.

六道 (LiùDào) Heritage Manager

This skill provides access to the LiùDào family heritage and relationship database. It allows you to query historical figures, analyze relationship networks, and manage personal data with strict privacy controls.

Core Capabilities

1. Search Database: Look up people by name, including their basic info, relationships, and milestones.
2. Relationship Engine: Resolve complex queries like "A的B" (e.g., "康熙的父亲").
3. Data Enrichment: Safely upsert new records or append milestones (history today) to existing ones.

Environment Details

• Database Path: /home/admin/.openclaw/workspace/liudao-bot/data/liudao.db
• Core Scripts: Located in /home/admin/.openclaw/workspace/liudao-bot/
• User Privacy: For private entries (e.g., family members), ensure you pass the correct viewer_id (e.g., 1234567890 for the specific authorized user).

Workflows

1. Searching for a Person

When a user asks about a specific historical figure or family member:

• Run the python search script passing the name and the user's ID for privacy.
• Example: python3 scripts/search_person.py "康熙" --viewer_id "5104087055"

2. Resolving Relationships ("A的B")

When a user asks relationship questions (e.g., "朱元璋的长子是谁？"):

• Use the relation engine script.
• Example: python3 scripts/resolve_relation.py "朱元璋" "长子"

3. Adding/Editing Data

For inserting a new person or adding milestones:

• Write a quick python script using db_manager.py's upsert_person method.
• Ensure is_private=1 and creator_id are set when adding personal family data.

Important Notes

• Always parse the relations_json and milestones_json carefully; they contain structured relationship links and life events.
• See references/db_schema.md for exact table structures.