安装与代码验收

完整验收

从目标根目录运行：

python3 tools/FTC-Knowledge-Bank/.agents/skills/ftckb-integrate/scripts/project.py resolve --project .
# Agent 根据 activeRules 修改代码
python3 tools/FTC-Knowledge-Bank/.agents/skills/ftckb-integrate/scripts/project.py check --project .

包装器验证固定版本、知识路径、托管内容、schema 和退出码。CLI 尚未构建或版本改变时才重新构建；构建日志走 stderr，kernel JSON 保持 stdout 可解析。

完整验收：

python3 tools/FTC-Knowledge-Bank/.agents/skills/ftckb-integrate/scripts/verify.py --project .

输出/退出码	意义
installationOk=true、projectCheck.ok=true，0	接入有效且本次 diff 硬检查通过；仍有 soft 待评估
installationOk=true、projectCheck.ok=false，1	接入有效，但目标已有或新增硬违规，不能交付为通过
installationOk=false，2	配置/版本/构建/schema/知识加载或规则冲突等错误

project.py 的成功调用透传 kernel JSON 和退出码（check 0/1/2/64）；包装器自身失败是独立 integrationOk=false 输出，不冒充 kernel 成功。验收不推断违规是谁引入的；Agent 应记录开始时的工作区基线并如实区分。

错误恢复

其他队员克隆已经提交了接入配置的项目后：

git submodule update --init -- tools/FTC-Knowledge-Bank
python3 tools/FTC-Knowledge-Bank/.agents/skills/ftckb-integrate/scripts/verify.py --project .

升级时显式选择新版本，先 dry-run，再运行安装器的 --ref NEW_TAG_OR_SHA。它更新 gitlink、配置和未被人工修改的模板，重新构建并验收。没有 --ref 不升级；不要 git pull submodule 或 git submodule update --remote。

构建失败：托管文件和固定 submodule 保留，修正 JDK、缓存权限或网络后重跑安装或 verify。版本/路径冲突：先查看 git status、.gitmodules、配置与 submodule HEAD，不直接 reset/删除目录。安装中途被强制终止可能留下 Git 注册或部分托管文件；脚本宁可拒绝未知残留，也不猜测并删除。审阅具体残留后人工恢复；不要执行全仓库 git clean -fdx 或 git reset --hard。