关于 actualize
actualize 用于让 FPF 知识库与项目代码的变化保持一致。它检查 Git 变更，找出上下文偏差、过时证据和可能失效的决策。
主要功能
- 01将 Git 变更与保存的基线比较
- 02检查项目上下文是否偏移
- 03标记关联文件已变更的证据
- 04识别可能过时的决策
- 05更新实际化基线
适用场景
- 01配置变更后刷新项目上下文
- 02代码变更后复查证据
- 03决策前检查决策记录
- 04定期维护知识库
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/actualize确认已加载。
详细介绍
更新知识库
此命令是维护持续演进的保障案例的核心部分。它会使你的 FPF 知识库（.fpf/）与项目代码库不断变化的实际情况保持同步。
此命令会针对近期的 git 变更执行三部分审计，以发现潜在的上下文偏移、过时的证据和陈旧的决策。这与 FPF 规范演进循环（B.4）的观察阶段相对应，并有助于管理认知债务（B.3.4）。
操作（运行时）
步骤 1：检查 Git 变更
运行 git 命令，识别自上次更新以来的变更：
# Get current commit hash
git rev-parse HEAD
# Check for changes since last known baseline
# (Read .fpf/.baseline file if it exists, otherwise use initial commit)
git diff --name-only <baseline_commit> HEAD
# List all changed files
git diff --stat <baseline_commit> HEAD
步骤 2：分析报告中的上下文偏移
-
检查变更文件中是否包含核心项目配置：
package.json、go.mod、Cargo.toml、requirements.txtDockerfile、docker-compose.yml.env.example、配置文件
-
如果配置文件发生变更：
- 重新阅读项目结构（README、配置文件）
- 将检测到的上下文与
.fpf/context.md进行比较 - 向用户展示差异
-
询问用户是否要更新
context.md
步骤 3：分析报告中的证据过时情况（认知债务）
- 阅读
.fpf/evidence/中的所有证据文件 - 检查每个证据文件中的
carrier_ref字段 - 与 git diff 中的变更文件交叉核对
- 如果被引用的文件发生变更：
- 将该证据标记为过时
- 注明受影响的假设
步骤 4：分析报告中的决策相关性
- 阅读
.fpf/decisions/中的所有 DRR 文件 - 追溯至源证据和假设文件
- 如果基础文件发生变更：
- 将 DRR 标记为可能已过时
步骤 5：更新基线
创建/更新 .fpf/.baseline 文件：
# FPF Actualization Baseline
# Last actualized: 2025-01-15T16:00:00Z
commit: abc123def456
步骤 6：展示检查结果
输出结构化报告：
## Actualization Report
**Baseline**: abc123 (2025-01-10)
**Current**: def456 (2025-01-15)
**Files Changed**: 42
### Context Drift
The following configuration files have changed:
- package.json (+5 dependencies)
- Dockerfile (base image updated)
**Action Required**: Review and update `.fpf/context.md` if constraints have changed.
### Stale Evidence (3 items)
| Evidence | Hypothesis | Changed File |
|----------|------------|--------------|
| ev-benchmark-api | api-optimization | src/api/handler.ts |
| ev-test-auth | auth-module | src/auth/login.ts |
| ev-perf-db | db-indexing | migrations/002.sql |
**Action Required**: Re-validate to refresh evidence for affected hypotheses.
### Decisions to Review (1 item)
| DRR | Affected By |
|-----|-------------|
| DRR-2025-01-10-api-design | src/api/handler.ts changed |
**Action Required**: Consider re-evaluating decision via `/fpf:propose-hypotheses`.
### Summary
- Context drift detected: YES
- Stale evidence: 3 items
- Decisions to review: 1 item
Run `/fpf:decay` for detailed freshness management.
文件：.fpf/.baseline
跟踪上次更新的时间点：
# FPF Actualization Baseline
last_actualized: 2025-01-15T16:00:00Z
commit: abc123def456789
branch: main
运行时机
- 开始新工作前：确保知识库为最新状态
- 重大变更后：使证据与代码变更保持同步
- 每周维护时：作为定期维护的一部分
- 做出决策前：确保证据仍然有效
评论
支持 Markdown