A Claude Code skill implementing Qian Xuesen's Meta-Synthesis methodology (综合集成法) for AI-assisted development quality assurance.
In AI-assisted "vibe coding", developers often ship code after only one validation: "Claude wrote it and it looks good." This creates a cognitive-reality gap — confidence without convergence.
Based on the Hall for Workshop of Meta-Synthetic Engineering (HWMSE), every change must pass three independent subsystems before shipping:
| Subsystem | Claude Code Mapping |
|---|---|
| Expert System 专家体系 | Claude analysis + developer judgment |
| Knowledge System 知识体系 | CLAUDE.md / memory / ADR / specs |
| Machine System 机器体系 | lint / type-check / test / build / audit |
Iron Law: All three agree → SHIP. Any dissent → STOP AND INVESTIGATE.
Not every change needs the full process. The skill auto-classifies into three tiers:
| Tier | Scope | Phases |
|---|---|---|
| 3 Routine | Single file, no API change | Lint+test → Quick CLEAR |
| 2 Standard | Multi-file, internal API | Scope → TDD → Full CLEAR |
| 1 Critical | External API, payment, auth | All 5 phases, no shortcuts |
git clone https://github.com/juxiaoju/meta-synthesis-qa.git ~/Code/meta-synthesis-qaln -s ~/Code/meta-synthesis-qa/skill ~/.claude/skills/meta-synthesis-qals ~/.claude/skills/meta-synthesis-qa/SKILL.mdThe skill will now be available in Claude Code.
The skill activates when:
- You invoke
/meta-synthesis-qain Claude Code - You ask for quality review before shipping
- A task touches external APIs, payment, auth, or data schema
These skills integrate with specific phases:
| Skill | Phase | Role |
|---|---|---|
test-driven-development |
Phase 2 | Machine system systematic build-up |
verification-before-completion |
Phase 3 | Convergence enforcement |
systematic-debugging |
Phase 2 | Machine system failure investigation |
brainstorming |
Phase 1 | Expert system design exploration |
skill/ # ← symlinked to ~/.claude/skills/
├── SKILL.md # Main skill (auto-adaptive tiered flow)
├── risk-tiers.md # Tier 1/2/3 classification + decision tree
├── clear-review-checklist.md # CLEAR review framework
├── adr-template.md # Architecture Decision Record template
└── failure-mode-library-template.md # Failure mode library template
examples/
├── tier1-example.md # Tier 1 full 5-phase walkthrough
└── tier3-example.md # Tier 3 lightweight flow
docs/
├── methodology.md # Qian Xuesen methodology background
└── hwmse-mapping.md # HWMSE subsystem detailed mapping
See docs/methodology.md for background on Qian Xuesen's Meta-Synthesis and its adaptation to software engineering.
MIT