AgentSkillsCN

eld-record-structuring

PCE（Process-Context Engine）的上下文结构化技能。将收集到的知识按适当的位置和粒度进行结构化，以便再次使用。 触发条件： - “更新 CLAUDE.md” - “整理 ADR” - “结构化知识” - “登记到 pce-memory” - 整理 pce-collection 中积累的见解时

SKILL.md
--- frontmatter
name: eld-record-structuring
context: fork
description: |
  PCE (Process-Context Engine) のコンテキスト構造化スキル。収集した知識を適切な場所・粒度で構造化し、再利用可能にする。

  トリガー条件:
  - 「CLAUDE.mdを更新して」
  - 「ADRを整理して」
  - 「知識を構造化して」
  - 「pce-memoryに登録して」
  - pce-collectionで蓄積された知見の整理時

PCE Structuring Skill

収集した知識を適切な構造で永続化し、後続プロセスで参照可能にする。

構造化の原則

  1. •適切な粒度: 1つの記録 = 1つの関心事
  2. •検索可能性: 後で見つけられるタグ/キーワード
  3. •文脈保持: なぜそうなったかの経緯
  4. •鮮度管理: 最終更新日と有効期限

出力先と形式

1. pce-memory (即時参照用)

code
pce_memory_upsert:
  category: pattern | decision | error | rule
  content: 構造化された知識
  tags: [検索用タグ]

2. CLAUDE.md (プロジェクト指針)

ルートCLAUDE.md - 一般化された原則

markdown
## 設計原則
- 原則1: 理由と適用範囲

## コーディング規約
- ...

フォルダCLAUDE.md - ドメイン固有

markdown
## このモジュールの責務
- ...

3. ADR (アーキテクチャ決定記録)

markdown
# ADR-XXX: タイトル

## Status
Accepted | Deprecated | Superseded by ADR-YYY

## Context
決定が必要になった背景

## Decision
決定内容

## Consequences
結果と影響

構造化ワークフロー

  1. •収集された知見を分類
  2. •出力先を決定（pce-memory / CLAUDE.md / ADR）
  3. •適切なフォーマットで記録
  4. •関連する既存知識との整合性確認

整理のタイミング

  • •セッション終了時
  • •マイルストーン完了時
  • •知見が5件以上蓄積した時
  • •明示的な整理依頼時

品質優先原則（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回以上）
  • •観測不能な変更の増加（物差しで検証できない変更）
  • •ロールバック線の崩壊（戻せない変更の発生）