跳转到内容

固定版本与项目配置

.ftckb/project.yaml 使用 JSON 语法(合法 YAML 1.2),由脚本生成;普通缩进 YAML 不受本包装器支持。

{
"schemaVersion": 2,
"kernelSchemaVersion": 2,
"integrationVersion": 2,
"team": "16093",
"season": "2025-2026",
"profiles": [],
"source": {
"repository": "https://github.com/lucasnotfound59/FTC-Knowledge-Bank.git",
"ref": "RELEASE_TAG_OR_FULL_SHA",
"commit": "FULL_40_CHARACTER_COMMIT_SHA",
"path": "tools/FTC-Knowledge-Bank"
},
"managedFiles": {
".agents/skills/ftc-knowledge-bank/SKILL.md": "GENERATED_SHA256",
"AGENTS.md#ftckb": "GENERATED_SHA256"
}
}

以上仅字段示意,占位字符串不能直接使用。managedFiles 摘要用于防止无意覆盖,不是对恶意篡改的签名。不要手改摘要来强行通过预检。

新安装必须选择 --generic-profile 或可重复的 --profile NAME(例如 --profile command-based)。profiles:[] 是显式 generic;缺失/null 不合法。rookiebot 隐含 simple-opmode,ftclib-command 隐含 command-based;simple-opmode 与 command-based 不兼容,generic 与命名 profile 互斥。不从代码或依赖猜测 profile。

重跑时可省略 team/season/ref,缺省重用配置中的 SHA,不重新解析 tag。相同输入不会产生新 diff。AGENTS 托管段之外的原文及队伍补充保留;项目补充写在段外,不改生成的 Skill。若生成文件/段落有人工修改、路径冲突、symlink 或 submodule 脏改动,脚本停止而非覆盖。