Back to skills
extension
Category: AI Agent CapabilitiesNo API key required

eld-record-collection

PCE (Process-Context Engine) Context Delta collection skill. Systematically collects and records insights generated during the development process. Trigger conditions: - When a decision is made ("Record why this design was chosen") - When a bug is resolved ("Preserve the knowledge of fixing this bug") - When an architectural decision is made ("Create an ADR") - When a pattern/anti-pattern is discovered ("Record this pattern") - At the end of a session ("Summarize today's learnings")

personAuthor: jakexiaohubgithub

PCE Collection Skill

Context Deltaを収集し、潜在的コンテキストプールを拡充する。

収集対象

1. 意思決定の痕跡

decision:
  what: 何を決定したか
  why: なぜその選択をしたか
  alternatives: 検討した他の選択肢
  rejected_reasons: 却下した理由
  constraints: 効いた制約条件
  trade_offs: 受け入れたトレードオフ

2. エラー解決策

error_resolution:
  symptom: 症状・エラーメッセージ
  root_cause: 根本原因
  solution: 解決策
  prevention: 再発防止策
  related_files: 関連ファイル

3. パターン発見

pattern:
  name: パターン名
  context: 適用コンテキスト
  problem: 解決する問題
  solution: 解決方法
  consequences: 結果と影響
  examples: 実例

収集プロセス

  1. 観察: 作業中の重要な判断・発見を特定
  2. 抽出: 上記フォーマットで構造化
  3. 検証: 記録内容の正確性を確認
  4. 保存: pce-memoryまたは適切な場所に記録

出力先の選択

| 知見の種類 | 出力先 | |-----------|--------| | 即時参照が必要 | pce-memory (upsert) | | アーキテクチャ決定 | docs/adr/ | | プロジェクト共通 | ルートCLAUDE.md | | ドメイン固有 | 該当フォルダのCLAUDE.md |

使用例

User: このAPIエンドポイントの設計判断を記録して

Claude:
収集した意思決定:
- what: REST APIではなくGraphQLを採用
- why: クライアント側でのデータ取得柔軟性
- alternatives: REST, gRPC
- rejected_reasons: RESTは過剰取得問題、gRPCはWeb対応コスト
- constraints: フロントエンドチームのGraphQL経験
- trade_offs: 学習コストを許容

→ pce-memory に記録完了

品質優先原則(Superpowers統合)

核心原則

  1. Epistemic Humility: 推測を事実として扱わない。unknownと言う勇気を持つ
  2. Evidence First: 結論ではなく因果と証拠を中心にする
  3. Minimal Change: 最小単位で変更し、即時検証する
  4. Grounded Laws: Lawは検証可能・観測可能でなければならない
  5. Source of Truth: 真実は常に現在のコード。要約はインデックス

「速さより質」の実践

  • 要件の曖昧さによる手戻りを根本から排除
  • テストなし実装を許さない
  • 観測不能な変更を防ぐ

完了の定義

  • [ ] Evidence Ladder目標レベル達成
  • [ ] Issue Contractの物差し満足
  • [ ] Law/Termが接地している(Grounding Map確認)
  • [ ] Link Mapに孤立がない
  • [ ] ロールバック可能な状態

停止条件

以下が発生したら即座に停止し、追加計測またはスコープ縮小:

  • 予測と現実の継続的乖離(想定外テスト失敗3回以上)
  • 観測不能な変更の増加(物差しで検証できない変更)
  • ロールバック線の崩壊(戻せない変更の発生)