qiushi-skill  by HughYau

Agentic framework for structured problem-solving

Created 2 weeks ago

New!

2,459 stars

Top 18.3% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a structured set of AI agent skills derived from Mao Zedong's philosophical and strategic methodologies, aiming to enhance AI's problem-solving capabilities. It addresses limitations in current AI agents, such as a lack of structured thinking, investigation, and self-correction, by equipping them with actionable frameworks. The primary benefit is a more robust and systematic approach to complex problem analysis and execution for AI systems.

How It Works

The core approach extracts a guiding principle, "Seek Truth from Facts," and nine distinct methodologies organized into three layers: foundational philosophy (Contradiction Analysis, Practice-Cognition), work methods (Investigation & Research, Mass Line, Criticism & Self-Criticism), and strategic tactics (Protracted Strategy, Concentrate Forces, Spark Prairie Fire, Overall Planning). This framework provides AI agents with a systematic, historically validated methodology for analyzing problems, making decisions, and executing tasks, moving beyond simple information processing to structured problem-solving.

Quick Start & Requirements

Installation is supported via Claude Plugin Hub (npx claudepluginhub hughyau/qiushi-skill or manual install), source cloning (git clone ..., cd qiushi-skill, claude --plugin-dir .), or direct pasting for AI assistants. Cursor integration involves cloning and adding to the plugin path. Prerequisites include PowerShell for Windows and Bash/sh for macOS/Linux, with verification scripts (tests/validate.sh, tests/validate.ps1) provided. The project supports Claude Code, Cursor, Codex, OpenCode, and any AI agent capable of system prompt injection.

Highlighted Details

  • Nine Methodologies: Offers distinct "thought weapons" like Contradiction Analysis, Practice-Cognition, and Investigation & Research, each with core tenets, original sources, and application scenarios.
  • Original Text References: Each skill includes original-texts.md with direct quotes from Mao's selected works, ensuring methodological grounding.
  • Workflow Combinations: A /workflows directory allows for chaining skills into sequential processes.
  • Subagent Prompts & Reference Guides: Includes specialized prompts for agents (e.g., investigation) and practical guides like contradiction type checklists.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels such as Discord or Slack.

Licensing & Compatibility

The project is released under the MIT License, which is permissive and generally compatible with commercial use and closed-source linking without significant restrictions.

Limitations & Caveats

This project is not exclusively for software engineering; its methodologies are applicable to business, academic, and daily decision-making. It explicitly states it is not propaganda or dogma, emphasizing the application of historical methods for general problem-solving through specific analysis. Its effectiveness is contingent on the AI agent's ability to integrate system prompts or specific plugin/command structures.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
6
Issues (30d)
33
Star History
2,468 stars in the last 17 days

Explore Similar Projects

Feedback? Help us improve.