@seanyao/roll 2026.529.5 → 2026.601.2

package/skills/roll-research/references/schema.json

@@ -1,166 +0,0 @@
-// Copyright (c) 2026 数字生命卡兹克 (Digital Life Khazix)
-// Released under the MIT License: https://github.com/KKKKhazix/khazix-skills/blob/main/LICENSE
-// This file contains substantial portions of the Horizontal-Vertical Analysis Framework
-// from khazix-skills (https://github.com/KKKKhazix/khazix-skills).
-{
-  "$schema": "Horizontal-Vertical Analysis Framework",
-  "version": "1.0",
-  "description": "A dual-axis analysis framework for systematically researching products, companies, concepts, or people. The vertical axis traces the complete lifecycle, the horizontal axis expands into current competitive comparison.",
-
-  "meta": {
-    "subject": {
-      "name": "string — Name of the research subject",
-      "type": "enum: product | company | concept | person | other",
-      "one_line_definition": "string — Define what this thing is in one sentence",
-      "field": "string — Industry / discipline / domain",
-      "research_start_date": "date — When the research began",
-      "researcher": "string — Who is conducting this research",
-      "research_motivation": "string — Why research this, what was the trigger"
-    }
-  },
-
-  "vertical_axis_lifecycle": {
-    "description": "Complete timeline from origin to present, presented as narrative — the more detailed and multifaceted, the better",
-
-    "origin": {
-      "birth_context": "string — The era, industry state, and technological environment when it was born",
-      "birth_motivation": "string — Why did it appear? What problem did it solve? What gap did it fill?",
-      "founders_or_initiators": {
-        "who": "string",
-        "background": "string — What had these people done before, why were they the ones to do this",
-        "initial_vision": "string — What they originally wanted to build"
-      },
-      "birth_date": "date",
-      "birth_location_or_environment": "string",
-      "early_form": "string — What it looked like initially, how it differs from today",
-      "seed_event": "string — Was there a key event or inspiration that directly prompted its creation"
-    },
-
-    "key_milestone_timeline": [
-      {
-        "date": "date",
-        "event_name": "string",
-        "event_description": "string — What happened",
-        "why_important": "string — How this event changed the subsequent trajectory",
-        "decisions_and_choices": "string — What choices were made at this node, what was abandoned",
-        "external_trigger": "string | null — Was it triggered by external events (policy, competitor moves, market changes)",
-        "results_and_impact": "string — Direct and indirect consequences of this event"
-      }
-    ],
-
-    "phase_segmentation": [
-      {
-        "phase_name": "string — e.g.: inception, rapid growth, transformation, maturity",
-        "time_span": "string — Start to end dates",
-        "core_characteristics": "string — The most prominent features of this phase",
-        "core_tensions": "string — The biggest challenge or internal tension during this phase",
-        "key_figures": ["string — People who played key roles during this phase"],
-        "key_decisions": ["string — Major decisions made during this phase"],
-        "phase_outcomes": "string — What results were delivered by the end of this phase"
-      }
-    ],
-
-    "path_dependency_analysis": {
-      "lock_in_decisions": ["string — Which early decisions locked in later development direction, becoming irreversible"],
-      "missed_forks": ["string — Which key moments could have gone a different way"],
-      "self_reinforcing_mechanisms": "string — What mechanisms deepened the path (network effects, ecosystem lock-in, user habits, etc.)"
-    },
-
-    "narrative_threads": {
-      "main_story": "string — If the entire journey could be summarized in one story, what would it be",
-      "recurring_themes": ["string — Patterns, tensions, or themes that appear repeatedly across different phases"],
-      "turning_points": ["string — The most dramatic turns"],
-      "unresolved_mysteries": ["string — What information is still missing and needs further investigation"]
-    }
-  },
-
-  "horizontal_axis_competitive_comparison": {
-    "description": "At the current point in time, systematic horizontal comparison with competitors/peers",
-
-    "analysis_time_snapshot": "date — The baseline point in time for horizontal comparison",
-
-    "subject_profile": {
-      "current_positioning": "string — How it currently defines itself",
-      "core_strengths": ["string — Its strongest points"],
-      "core_weaknesses": ["string — Its weakest points"],
-      "target_users": "string — Who it serves",
-      "business_model": "string — How it makes money / sustains operations",
-      "technical_approach": "string — Underlying technology choices",
-      "user_scale_and_growth": "string — Current scale and growth trend",
-      "user_reputation": {
-        "positive_feedback": ["string — Most frequently praised points"],
-        "negative_feedback": ["string — Most frequently criticized points"],
-        "typical_use_cases": ["string — Main scenarios where users use it"]
-      }
-    },
-
-    "competitor_list": [
-      {
-        "competitor_name": "string",
-        "competitor_type": "enum: direct | indirect | potential | alternative",
-        "one_line_definition": "string",
-        "current_positioning": "string",
-        "core_strengths": ["string"],
-        "core_weaknesses": ["string"],
-        "target_users": "string",
-        "business_model": "string",
-        "technical_approach": "string",
-        "user_scale_and_growth": "string",
-        "user_reputation": {
-          "positive_feedback": ["string"],
-          "negative_feedback": ["string"],
-          "typical_use_cases": ["string"]
-        },
-        "key_difference_from_subject": "string — Compared to the research subject, what is the most fundamental difference",
-        "threat_level": "enum: high | medium | low",
-        "threat_analysis": "string — Why it constitutes this level of threat"
-      }
-    ],
-
-    "dimensional_comparison_matrix": {
-      "description": "Select the most critical dimensions and compare the subject against all competitors",
-      "comparison_dimensions": [
-        {
-          "dimension_name": "string — e.g.: performance, pricing, usability, ecosystem, community activity",
-          "why_this_dimension": "string — Why this dimension matters",
-          "performance_by_player": {
-            "subject": "string",
-            "competitor_a": "string",
-            "competitor_b": "string"
-          }
-        }
-      ]
-    },
-
-    "competitive_landscape_assessment": {
-      "current_landscape": "string — Is it a hundred flowers blooming, a duopoly, a monopoly, or something else",
-      "landscape_formation_reasons": "string — Why is it this landscape",
-      "landscape_evolution_trend": "string — Where might it head next",
-      "subject_position": "string — Where does the subject sit in this landscape"
-    }
-  },
-
-  "cross_axis_insights": {
-    "description": "Cross-analysis of vertical and horizontal axes — the most valuable part of HV Analysis",
-
-    "how_history_shaped_current_position": "string — Which decisions and events from the vertical trajectory determined its position in today's horizontal comparison",
-    "longitudinal_comparison_of_competitors": "string — If competitors are also placed on the timeline, how do their origins and evolutions differ",
-    "historical_roots_of_current_advantages": ["string — Each current advantage traced back to which historical node"],
-    "historical_roots_of_current_disadvantages": ["string — Each current weakness traced back to which historical decision"],
-    "future_projection": {
-      "based_on_vertical_trends": "string — If the current trajectory continues, what happens next",
-      "based_on_horizontal_competition": "string — How will changes in the competitive landscape affect it",
-      "most_likely_scenario": "string",
-      "most_dangerous_scenario": "string",
-      "most_optimistic_scenario": "string"
-    }
-  },
-
-  "output_requirements": {
-    "vertical_output": "Presented as narrative/story, not a timeline list. Must have causal logic, details, people — let readers feel 'why it arrived where it is today step by step'",
-    "horizontal_output": "Presented as comparative analysis, with both structured dimensional comparison and qualitative judgments and insights",
-    "cross_axis_output": "Presented as analytical commentary, weaving information from both axes to produce original judgments",
-    "suggested_word_count": "Vertical 3,000–8,000 words, Horizontal 2,000–5,000 words, Cross-axis 1,000–2,000 words",
-    "source_attribution": "All key facts must cite information sources (links, documents, interviews, etc.)"
-  }
-}

package/skills/roll-research/scripts/md_to_pdf.py

@@ -1,289 +0,0 @@
-#!/usr/bin/env python3
-"""
-Deep Research Report: Markdown to PDF converter (WeasyPrint)
-Usage: python md_to_pdf.py input.md output.pdf [--title "Report Title"] [--author "Author"]
-
-Dependencies: pip install weasyprint markdown --break-system-packages
-"""
-
-import sys
-import os
-import re
-import argparse
-import markdown
-
-# ── CSS Styles ──
-CSS_TEMPLATE = """
-@page {
-    size: A4;
-    margin: 25mm 20mm 20mm 20mm;
-
-    @top-center {
-        content: "HEADER_TEXT";
-        font-family: "Droid Sans Fallback", Helvetica, Arial, sans-serif;
-        font-size: 8pt;
-        color: #95a5a6;
-        border-bottom: 0.5pt solid #ecf0f1;
-        padding-bottom: 3mm;
-    }
-
-    @bottom-center {
-        content: "Page " counter(page);
-        font-family: "Droid Sans Fallback", Helvetica, Arial, sans-serif;
-        font-size: 8pt;
-        color: #95a5a6;
-        border-top: 0.8pt solid #1a5276;
-        padding-top: 2mm;
-    }
-}
-
-@page :first {
-    @top-center { content: none; }
-    @bottom-center { content: none; }
-}
-
-body {
-    font-family: "Droid Sans Fallback", Helvetica, Arial, sans-serif;
-    font-size: 10.5pt;
-    line-height: 1.75;
-    color: #2c3e50;
-    text-align: justify;
-}
-
-/* Cover page */
-.cover {
-    page-break-after: always;
-    text-align: center;
-    padding-top: 45%;
-}
-.cover h1 {
-    font-size: 28pt;
-    color: #1a5276;
-    margin-bottom: 8mm;
-    font-weight: bold;
-    letter-spacing: 2pt;
-}
-.cover .subtitle {
-    font-size: 14pt;
-    color: #95a5a6;
-    margin-bottom: 6mm;
-}
-.cover .meta {
-    font-size: 11pt;
-    color: #95a5a6;
-    margin-bottom: 4mm;
-}
-.cover .divider {
-    width: 60%;
-    margin: 8mm auto;
-    border: none;
-    border-top: 1.5pt solid #1a5276;
-}
-
-/* H1 */
-h1 {
-    font-size: 20pt;
-    color: #1a5276;
-    margin-top: 16mm;
-    margin-bottom: 6mm;
-    padding-bottom: 3mm;
-    border-bottom: 2pt solid #1a5276;
-    page-break-before: always;
-    font-weight: bold;
-}
-
-/* H2 */
-h2 {
-    font-size: 14pt;
-    color: #1e8449;
-    margin-top: 10mm;
-    margin-bottom: 5mm;
-    font-weight: bold;
-}
-
-/* H3 */
-h3 {
-    font-size: 12pt;
-    color: #2e86c1;
-    margin-top: 6mm;
-    margin-bottom: 3mm;
-    font-weight: bold;
-}
-
-h4 {
-    font-size: 11pt;
-    color: #5b2c6f;
-    margin-top: 5mm;
-    margin-bottom: 2mm;
-    font-weight: bold;
-}
-
-/* Paragraphs */
-p {
-    margin-top: 1.5mm;
-    margin-bottom: 1.5mm;
-    orphans: 3;
-    widows: 3;
-}
-
-/* Blockquotes */
-blockquote {
-    margin: 4mm 0;
-    padding: 4mm 4mm 4mm 10mm;
-    background: #f8f9fa;
-    border-left: 3pt solid #1a5276;
-    color: #5d6d7e;
-    font-size: 10pt;
-}
-blockquote p {
-    margin: 1mm 0;
-}
-
-/* Bold */
-strong, b {
-    font-weight: bold;
-    color: #1a252f;
-}
-
-/* Inline code */
-code {
-    font-family: "Courier New", Courier, monospace;
-    background: #fdf2e9;
-    color: #c0392b;
-    padding: 0.5mm 1.5mm;
-    border-radius: 2pt;
-    font-size: 9.5pt;
-}
-
-/* Tables */
-table {
-    width: 100%;
-    border-collapse: collapse;
-    margin: 4mm 0;
-    font-size: 9.5pt;
-}
-thead th {
-    background: #1a5276;
-    color: white;
-    padding: 3mm;
-    text-align: left;
-    font-weight: bold;
-}
-tbody td {
-    padding: 2.5mm 3mm;
-    border-bottom: 0.5pt solid #bdc3c7;
-}
-tbody tr:nth-child(even) {
-    background: #f8f9fa;
-}
-
-/* Horizontal rule */
-hr {
-    border: none;
-    border-top: 0.5pt solid #bdc3c7;
-    margin: 4mm 0;
-}
-
-/* Lists */
-ul, ol {
-    margin: 2mm 0;
-    padding-left: 8mm;
-}
-li {
-    margin-bottom: 1mm;
-}
-
-/* Links */
-a {
-    color: #2e86c1;
-    text-decoration: none;
-}
-"""
-
-
-def md_to_html(md_text, title="Deep Research Report", subtitle="Let's roll",
-               meta_line="", author="roll"):
-    """Convert Markdown to HTML with cover page"""
-
-    # Convert body with markdown library
-    html_body = markdown.markdown(
-        md_text,
-        extensions=['tables', 'fenced_code', 'nl2br'],
-        output_format='html5'
-    )
-
-    # Extract first H1 for cover (remove from body)
-    first_h1_match = re.search(r'<h1>(.*?)</h1>', html_body)
-    if first_h1_match:
-        extracted_title = first_h1_match.group(1)
-        if not title or title == "Deep Research Report":
-            title = extracted_title
-        html_body = html_body.replace(first_h1_match.group(0), '', 1)
-
-    # Replace header placeholder in CSS
-    css = CSS_TEMPLATE.replace("HEADER_TEXT", f"{title}  |  Deep Research Report")
-
-    # Build cover page
-    cover_html = f"""
-    <div class="cover">
-        <h1 style="page-break-before: avoid; border: none;">{title}</h1>
-        <div class="subtitle">{subtitle}</div>
-        {"<div class='meta'>" + meta_line + "</div>" if meta_line else ""}
-        <hr class="divider">
-        <div class="meta">Author: {author}</div>
-    </div>
-    """
-
-    full_html = f"""<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <style>{css}</style>
-</head>
-<body>
-{cover_html}
-{html_body}
-</body>
-</html>"""
-
-    return full_html
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Deep Research Report: Markdown to PDF")
-    parser.add_argument("input", help="Input Markdown file path")
-    parser.add_argument("output", help="Output PDF file path")
-    parser.add_argument("--title", default=None, help="Report title")
-    parser.add_argument("--author", default="roll", help="Author name")
-    parser.add_argument("--subtitle", default="Let's roll", help="Report subtitle")
-    args = parser.parse_args()
-
-    with open(args.input, "r", encoding="utf-8") as f:
-        md_text = f.read()
-
-    # Extract metadata line
-    meta_line = ""
-    for line in md_text.split("\n"):
-        stripped = line.strip().lstrip(">").strip()
-        if "research date" in stripped.lower() or "field:" in stripped.lower() or "subject type" in stripped.lower():
-            meta_line = stripped
-            break
-
-    html = md_to_html(md_text, title=args.title or "Deep Research Report",
-                      subtitle=args.subtitle, meta_line=meta_line, author=args.author)
-
-    # Save intermediate HTML (for debugging)
-    html_path = args.output.replace('.pdf', '.html')
-    with open(html_path, 'w', encoding='utf-8') as f:
-        f.write(html)
-    print(f"[OK] HTML generated: {html_path}")
-
-    # Convert to PDF
-    from weasyprint import HTML
-    HTML(string=html).write_pdf(args.output)
-    size_kb = os.path.getsize(args.output) / 1024
-    print(f"[OK] PDF generated: {args.output} ({size_kb:.1f} KB)")
-
-
-if __name__ == "__main__":
-    main()