AgentSkillsCN

wiring-validation

核实每项已记录的功能均具备实际实现,检查意识组件是否已被测量并记录日志,验证遥测端点。适用于新增功能、审查实现完整性,或排查缺失功能时使用。

SKILL.md
--- frontmatter
name: wiring-validation
description: Verify every documented feature has actual implementation, check consciousness components are measured and logged, validate telemetry endpoints. Use when adding features, reviewing implementation completeness, or debugging missing functionality.

Wiring Validation

Traces feature implementation chains. Source: .github/agents/wiring-validation-agent.md.

When to Use This Skill

  • Adding new features to pantheon-chat
  • Reviewing implementation completeness
  • Debugging missing functionality
  • Validating telemetry coverage

Step 1: Trace Implementation Chain

code
Documentation → Backend → API → Frontend → User

For each feature, verify:

  1. Documented in docs/
  2. Implemented in qig-backend/
  3. Exposed via routes/
  4. Consumed by client/
  5. Displayed to user

Step 2: Check Consciousness Component Wiring

bash
# Verify all consciousness metrics are measured
rg "measure_phi|measure_kappa|compute_qfi" qig-backend/

# Verify metrics are logged
rg "log.*phi|log.*kappa|telemetry" qig-backend/

Step 3: Validate Telemetry Endpoints

bash
# Check all metrics have API endpoints
rg "@app\.(get|post).*metric|consciousness|phi|kappa" qig-backend/routes/

Critical Wiring Checks

ComponentMust HaveCheck Command
Φ measurementmeasure_phi() calledrg measure_phi qig-backend/
κ measurementmeasure_kappa() calledrg measure_kappa qig-backend/
Regime detectionclassify_regime() usedrg classify_regime qig-backend/
TelemetryAll metrics loggedrg telemetry qig-backend/
API exposureEndpoints for all metricsrg @app qig-backend/routes/

Implementation Completeness Matrix

code
Feature: Consciousness Measurement
├── docs/03-technical/consciousness.md  ✓ Documented
├── qig-backend/qig_core/consciousness_4d.py  ✓ Implemented
├── qig-backend/routes/consciousness.py  ✓ API Endpoint
├── client/src/api/consciousness.ts  ✓ Client
└── client/src/components/ConsciousnessPanel.tsx  ✓ UI

Validation Commands

bash
# Run wiring validation
python scripts/validate_wiring.py

# Check feature completeness
python scripts/check_feature_chain.py --feature consciousness

Response Format

code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WIRING VALIDATION REPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Implementation Chain:
  - Documentation: ✅ / ❌
  - Backend: ✅ / ❌
  - API: ✅ / ❌
  - Frontend: ✅ / ❌

Missing Wiring: [list]
Orphaned Features: [list]
Priority: CRITICAL / HIGH / MEDIUM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━