Known Limitations.zh

已知限制

VCP Security Gate

正则检查不是污点追踪

security-gate.ts 检查当前 Write/Edit/Bash payload。它不能追踪某个值从一个文件或变量流入后续 sink。

缓解：运行 /vcp-audit 或 /vcp-pre-commit-review 做 AI 驱动的数据流分析。

Bash 混淆覆盖是定向的

CWE-116 检查会捕获 base64/xxd 解码后进入 shell 执行的模式。更少见的多阶段 shell 混淆仍可能漏掉。

PostToolUse 是建议型

test-quality-warning.ts 在 Write/Edit 后报告 mock 滥用发现。它不阻塞。把它视为警告，并用 /vcp-review-tests 做更深分析。

标准

默认 standards URL 跟随 main

默认 standards_url 指向仓库的 main 分支。这让 v1.0 前的标准保持最新，但也意味着内容可变。需要 pinning 的组织应把 standards_url 指向 tag release 或内部镜像。

宿主差异

Codex 可能不会自动注入 MCP resources

当资源没有出现在上下文中时，使用配对工具：get_prompt、get_run_state、get_stage_definition、list_presets、resolve_config。

Claude 专用 UI metadata 会被 Codex 忽略

Codex 可能忽略 allowed-tools、argument-hint 等 SKILL frontmatter。运行时执行应放在脚本、hook 和 MCP 工具中。

Dev Buddy

v0.6.0 中 MCP Ralph 是骨架

ralph_start、ralph_next、ralph_list、ralph_health 是真实 MCP 工具。它们在 .vcp/ralph/<run-id>/ 下持久化状态，并验证状态转换、锁、lease、prompt、resource 和配对工具。六个 step handler 还不会执行 LLM 工作。

生产 Ralph 功能开发应继续使用 Claude stage-skill 工作流，直到 MCP step 完成移植。

API 工具限制不覆盖所有 executor 类型

API executor 可通过 agentool 工具注册表做结构性限制。Subscription 和 CLI executor 依赖提示词层面的限制。

机械摘录可能包含敏感输出

构建失败会把 stdout/stderr 的头尾摘录持久化到逐单元 JSON 状态，以便重启后继续重试。如果测试工具打印 secret，这些摘录可能被后续 executor 看到。

缓解：配置工具不要打印 secret，避免把 secret 写入测试输出。

头尾摘录可能漏掉中间错误

只有有限的头尾片段会进入重试上下文。输出极多的工具可能把真正有用的错误行淹没在中间。

缓解：降低测试 runner verbosity，或在反压命令前过滤日志。

MCP Doc

mcp-doc-init 和 mcp-doc-scan 是最确定性的路径。v0.6.0 中 generate/sync 工作流仍通过 MCP prompt 和宿主工具引导，而不是完全确定性的 runner。