mcpField
Q
query

query

github.com/neolabhq生产力1.8k1.2k 次安装9 周前更新
代码仓库

关于 query

query 是用于检索 FPF 知识库和决策记录的技能，面向需要查找假设及其保障信息的用户。它可按关键词、ID、层级或决策查询，并展示有效性评分、依赖关系和证据摘要。

主要功能

  1. 01搜索知识库与决策记录
  2. 02按关键词、ID 或层级筛选
  3. 03展示假设层级与有效性评分
  4. 04显示依赖树和证据摘要

适用场景

  1. 01查找与缓存相关的假设
  2. 02查看特定假设的依赖与评分
  3. 03检索设计理由记录及选择结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/neolabhq/context-engineering-kit --skill query

安装后在 Claude Code 中输入/query确认已加载。

详细介绍

查询知识

搜索 FPF 知识库，并显示假设的详细信息及保证信息。

操作（运行时）

  1. 根据用户查询搜索 .fpf/knowledge/ 和 .fpf/decisions/。
  2. 对于每个找到的假设，显示：
    • 基本信息：标题、层级（L0/L1/L2）、类型、范围
    • 如果层级 >= L1：读取审计部分中的 R_eff
    • 如果存在依赖项：显示依赖关系图
    • 如果存在证据摘要：显示证据摘要
  3. 以表格形式呈现结果。

搜索位置

位置内容
.fpf/knowledge/L0/提议的假设
.fpf/knowledge/L1/已验证的假设
.fpf/knowledge/L2/已确认的假设
.fpf/knowledge/invalid/已拒绝的假设
.fpf/decisions/设计决策记录
.fpf/evidence/证据和审计文件

输出格式

## Search Results for "<query>"

### Hypotheses Found

| Hypothesis | Layer | Kind | R_eff |
|------------|-------|------|-------|
| redis-caching | L2 | system | 0.85 |
| cdn-edge | L2 | system | 0.72 |

### redis-caching (L2)

**Title**: Use Redis for Caching
**Kind**: system
**Scope**: High-load systems, Linux only

**R_eff**: 0.85
**Weakest Link**: internal test (0.85)

**Dependencies**:

[redis-caching R:0.85] └── (no dependencies)


**Evidence**:
- ev-benchmark-redis-caching-2025-01-15 (internal, PASS)

### cdn-edge (L2)

**Title**: Use CDN Edge Cache
**Kind**: system
**Scope**: Static content delivery

**R_eff**: 0.72
**Weakest Link**: external docs (CL1 penalty)

**Evidence**:
- ev-research-cdn-2025-01-10 (external, PASS)

搜索方法

按关键词搜索

搜索文件内容以查找匹配文本：

/fpf:query caching
-> Finds all hypotheses with "caching" in title or content
按特定 ID 搜索

查找特定假设：

/fpf:query redis-caching
-> Shows full details for redis-caching
-> Displays dependency tree
-> Shows R_eff breakdown
按层级搜索

按知识层级筛选：

/fpf:query L2
-> Lists all L2 hypotheses with R_eff scores
按决策搜索

搜索决策记录：

/fpf:query DRR
-> Lists all Design Rationale Records
-> Shows what each DRR selected/rejected

R_eff 显示

对于 L1+ 假设，读取审计部分并显示：

**R_eff Breakdown**:
- Self Score: 1.00
- Weakest Link: ev-research-redis (0.90)
- Dependency Penalty: none
- **Final R_eff**: 0.85

依赖树显示

如果假设有 depends_on，则显示依赖树：

[api-gateway R:0.80]
  └──(CL:3)── [auth-module R:0.85]
  └──(CL:2)── [rate-limiter R:0.90]

图例：

  • R:X.XX = R_eff 分数
  • CL:N = 一致性级别（1-3）

示例

按关键词搜索：

User: /fpf:query caching

Results:
| Hypothesis | Layer | R_eff |
|------------|-------|-------|
| redis-caching | L2 | 0.85 |
| cdn-edge-cache | L2 | 0.72 |
| lru-cache | invalid | N/A |

查询特定假设：

User: /fpf:query redis-caching

# redis-caching (L2)

Title: Use Redis for Caching
Kind: system
Scope: High-load systems
R_eff: 0.85
Evidence: 2 files

查询决策：

User: /fpf:query DRR

# Design Rationale Records

| DRR | Date | Winner | Rejected |
|-----|------|--------|----------|
| DRR-2025-01-15-caching | 2025-01-15 | redis-caching | cdn-edge |

评论

支持 Markdown