knowledge-validator

CAPHTECH's avatarfrom CAPHTECH

pce-memory + shirushiを活用した知識検証・整合性チェックスキル。以下の場合に使用:(1) 資料・ドキュメント間の矛盾チェック(2) 指示・意思決定の追跡と検証(3) 作業途中のリアルタイム整合性チェック(4) 成果物と要件の照合検証(5) shirushi Doc-IDとコードのトレーサビリティ検証「チェックして」「整合性確認」「矛盾ない？」「検証して」「トレーサビリティ」等で起動。

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026
[Testing and QA]

When & Why to Use This Skill

The Knowledge Validator is an advanced Claude skill designed for automated consistency checking and requirement traceability. By leveraging pce-memory and the shirushi framework, it enables users to detect contradictions across documents, track decision-making history (ADR), and verify that code implementations align perfectly with technical requirements through rigorous Doc-ID mapping.

Use Cases

  • Requirement Traceability: Automatically map code implementations to shirushi Doc-IDs to generate coverage reports and ensure all functional specifications are met.
  • Cross-Document Consistency: Scan project documentation and pce-memory to identify logical contradictions or outdated information that could lead to development errors.
  • Architectural Decision Validation: Track and verify the dependency chain of ADRs (Architectural Decision Records) to prevent new decisions from conflicting with established project policies.
  • Real-time Development Guardrails: Monitor work-in-progress to provide immediate feedback when a task deviates from the initial requirements or project scope.
  • Automated Compliance Auditing: Generate verification reports that match deliverables against requirement lists 1:1, providing a clear audit trail for project stakeholders.
nameknowledge-validator
description|

Knowledge Validator

pce-memory + shirushiを活用した5種類の検証ワークフロー。

前提条件

  • pce-memoryがReady状態であること
  • shirushiが設定済みであること（トレーサビリティ検証時）

クイックスタート

1. 矛盾チェック

1. pce_memory_activate(scope=["project"], q="対象キーワード")
2. 関連Claimを取得
3. 各Claim間の論理的整合性を検証
4. 矛盾発見時はpce_memory_feedback(signal="outdated")

2. 意思決定チェック

1. pce_memory_activate(q="決定 ADR policy")
2. 決定間の依存関係を確認
3. 新決定と既存決定の競合を検出

3. リアルタイムチェック

1. 作業開始: pce_memory_observe(source_type="chat", content="開始状態")
2. マイルストーン: pce_memory_activate→期待値と比較
3. 逸脱検出時: 即時報告

4. 成果物チェック

1. pce_memory_activate(q="要件 仕様 spec")
2. 要件リストを抽出
3. 成果物と要件を1:1照合
4. カバレッジレポート生成

5. トレーサビリティチェック（shirushi統合）

1. shirushi lint で Doc-ID整合性確認
2. scripts/trace_doc_code.py でコード内参照を収集
3. Doc-ID ↔ Code 照合マトリクスを生成
4. pce-memoryにRelation登録

shirushi Doc-ID形式

.shirushi.ymlで定義されたID形式を使用。例:

DOC-REQ-0001-A
│   │   │    └─ チェックサム（mod26AZ）
│   │   └────── 連番（スコープ内）
│   └────────── 種別（REQ/SPEC/ADR等）
└────────────── コンポーネント

コード内参照形式

// @shirushi DOC-REQ-0001-A
export function authenticate() { ... }

検証レポート形式

## 検証レポート

| 項目 | 状態 | 詳細 |
|------|------|------|
| 要件A | ✅ | 実装済み |
| 要件B | ⚠️ | 部分的実装 |
| 要件C | ❌ | 未実装 |

カバレッジ: X/Y (Z%)

詳細ワークフロー