meta-cognition-parallel

メタ認知並列分析（実験的）

ステータス： 実験的 | バージョン： 0.2.0 | 最終更新日： 2025-01-27

このスキルでは、3 層の認知分析を並列でテストします。

概念

逐次分析の代わりに、このスキルでは認知レイヤーごとに 1 つ、計 3 つの分析器を並列で起動し、その結果を統合します。

User Question
     │
     ▼
┌─────────────────────────────────────────────────────┐
│            meta-cognition-parallel                   │
│                  (Coordinator)                       │
└─────────────────────────────────────────────────────┘
     │
     ├─── Layer 1 ──► Language Mechanics ──► L1 Result
     │
     ├─── Layer 2 ──► Design Choices     ──► L2 Result
     │                                            ├── Parallel (Agent Mode)
     │                                            │   or Sequential (Inline)
     └─── Layer 3 ──► Domain Constraints ──► L3 Result
     │
     ▼
┌─────────────────────────────────────────────────────┐
│              Cross-Layer Synthesis                   │
│         (In main context with all results)          │
└─────────────────────────────────────────────────────┘
     │
     ▼
Domain-Correct Architectural Solution

使用方法

/meta-parallel <your Rust question>

例：

/meta-parallel 我的交易系统报 E0382 错误，应该用 clone 吗？

実行モードの判定

重要：実行モードを判定するため、最初にエージェントファイルが利用可能か確認してください。

レイヤー分析器のファイルを読み込んでみてください：

• ../../agents/layer1-analyzer.md
• ../../agents/layer2-analyzer.md
• ../../agents/layer3-analyzer.md

---

エージェントモード（プラグインインストール）- 並列実行

すべてのレイヤー分析器ファイルが ../../agents/ に存在する場合：

ステップ 1：ユーザーのクエリを解析する

$ARGUMENTS から以下を抽出します：

• 元の質問
• コードスニペット
• ドメインのヒント（トレーディング、Web、組み込みなど）

ステップ 2：3 つのエージェントを並列で起動する

重要：並列実行を有効にするため、3 つすべてのタスクを 1 つのメッセージで起動してください。

Read agent files, then launch in parallel:

Task(
  subagent_type: "general-purpose",
  run_in_background: true,
  prompt: <content of ../../agents/layer1-analyzer.md>
          + "\n\n## User Query\n" + $ARGUMENTS
)

Task(
  subagent_type: "general-purpose",
  run_in_background: true,
  prompt: <content of ../../agents/layer2-analyzer.md>
          + "\n\n## User Query\n" + $ARGUMENTS
)

Task(
  subagent_type: "general-purpose",
  run_in_background: true,
  prompt: <content of ../../agents/layer3-analyzer.md>
          + "\n\n## User Query\n" + $ARGUMENTS
)

ステップ 3：結果を収集する

3 つすべてのエージェントが完了するまで待ちます。それぞれが構造化された分析を返します。

ステップ 4：レイヤー横断の統合

3 つすべての結果を使い、以下のテンプレートに従って統合します。

---

インラインモード（スキルのみのインストール）- 逐次実行

レイヤー分析器のファイルが利用できない場合は、分析を直接実行してください：

ステップ 1：ユーザーのクエリを解析する

エージェントモードと同様に、$ARGUMENTS から質問、コード、ドメインのヒントを抽出します。

ステップ 2：レイヤー 1 を実行する - 言語の仕組み

関連する Rust 言語の仕組みを分析します：

## Layer 1: Language Mechanics

**Error/Pattern Identified:**
- Error code: E0XXX (if applicable)
- Pattern: ownership/borrowing/lifetime/etc.

**Root Cause:**
[Explain why this error occurs in terms of Rust's ownership model]

**Language-Level Solutions:**
1. [Solution 1]: description
2. [Solution 2]: description

**Confidence:** HIGH | MEDIUM | LOW
**Reasoning:** [Why this confidence level]

重点領域：

• 所有権のルール（move、copy、borrow）
• ライフタイム注釈
• 借用のルール（共有と可変）
• エラーコードとその意味

ステップ 3：レイヤー 2 を実行する - 設計上の選択

設計パターンとトレードオフを分析します：

## Layer 2: Design Choices

**Design Pattern Context:**
- Current approach: [What pattern is being used]
- Problem: [Why it conflicts with Rust's rules]

**Design Alternatives:**
| Pattern | Pros | Cons | When to Use |
|---------|------|------|-------------|
| Pattern A | ... | ... | ... |
| Pattern B | ... | ... | ... |

**Recommended Pattern:**
[Which pattern fits best and why]

**Confidence:** HIGH | MEDIUM | LOW
**Reasoning:** [Why this confidence level]

重点領域：

• スマートポインターの選択（Box、Rc、Arc）
• 内部可変性のパターン（Cell、RefCell、Mutex）
• 所有権の移転と共有
• クローンと参照

ステップ 4：レイヤー 3 を実行する - ドメインの制約

ドメイン固有の要件を分析します：

## Layer 3: Domain Constraints

**Domain Identified:** [trading/fintech | web | CLI | embedded | etc.]

**Domain-Specific Requirements:**
- [ ] Performance: [requirements]
- [ ] Safety: [requirements]
- [ ] Concurrency: [requirements]
- [ ] Auditability: [requirements]

**Domain Best Practices:**
1. [Best practice 1]
2. [Best practice 2]

**Constraints on Solution:**
- MUST: [hard requirements]
- SHOULD: [soft requirements]
- AVOID: [anti-patterns for this domain]

**Confidence:** HIGH | MEDIUM | LOW
**Reasoning:** [Why this confidence level]

重点領域：

• 業界の要件（FinTech の規制、Web のスケーラビリティなど）
• パフォーマンスの制約
• 安全性と正確性の要件
• ドメインで一般的なパターン

ステップ 5：レイヤー横断の統合

3 つのレイヤーを統合します：

## Cross-Layer Synthesis

### Layer Results Summary

| Layer | Key Finding | Confidence |
|-------|-------------|------------|
| L1 (Mechanics) | [Summary] | [Level] |
| L2 (Design) | [Summary] | [Level] |
| L3 (Domain) | [Summary] | [Level] |

### Cross-Layer Reasoning

1. **L3 → L2:** [How domain constraints affect design choice]
2. **L2 → L1:** [How design choice determines mechanism]
3. **L1 ← L3:** [Direct domain impact on language features]

### Synthesized Recommendation

**Problem:** [Restated with full context]

**Solution:** [Domain-correct architectural solution]

**Rationale:**
- Domain requires: [L3 constraint]
- Design pattern: [L2 pattern]
- Mechanism: [L1 implementation]

### Confidence Assessment

- **Overall:** HIGH | MEDIUM | LOW
- **Limiting Factor:** [Which layer had lowest confidence]

---

出力テンプレート

どちらのモードでも、同じ形式で出力します：

# Three-Layer Meta-Cognition Analysis

> Query: [User's question]

---

## Layer 1: Language Mechanics
[L1 analysis result]

---

## Layer 2: Design Choices
[L2 analysis result]

---

## Layer 3: Domain Constraints
[L3 analysis result]

---

## Cross-Layer Synthesis

### Reasoning Chain

L3 ドメイン：[制約] ↓ を示唆 L2 設計：[パターン] ↓ を通じて実装 L1 仕組み：[機能]

### Final Recommendation

**Do:** [Recommended approach]

**Don't:** [What to avoid]

**Code Pattern:**
```rust
// Recommended implementation

---

meta-cognition-parallel v0.2.0（実験的）による分析

---

## Test Scenarios

### Test 1: Trading System E0382

/meta-parallel 交易システムで E0382 が発生し、trade record が move されました

Expected: L3 identifies FinTech constraints → L2 suggests shared immutable → L1 recommends Arc<T>

### Test 2: Web API Concurrency

/meta-parallel Web API で複数の handler がデータベース接続プールを共有する必要があります

Expected: L3 identifies Web constraints → L2 suggests connection pooling → L1 recommends Arc<Pool>

### Test 3: CLI Tool Config

/meta-parallel CLI ツールで設定ファイルとコマンドライン引数の優先順位をどのように処理するか

Expected: L3 identifies CLI constraints → L2 suggests config precedence pattern → L1 recommends builder pattern

---

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| Agent files not found | Skills-only install | Use inline mode (sequential) |
| Agent timeout | Complex analysis | Wait longer or use inline mode |
| Incomplete layer result | Agent issue | Fill in with inline analysis |

## Limitations

- **Agent Mode:** Parallel execution, faster but requires plugin install
- **Inline Mode:** Sequential execution, slower but works everywhere
- Cross-layer synthesis quality depends on result structure
- May have higher latency than simple single-layer analysis

## Feedback

This is experimental. Please report issues and suggestions to improve the three-layer analysis approach.