Skip to content

v2 升级说明(upgrade-v2) ​

2.0.0 的破坏面集中在「脚本里的命令名」与「JSON 解析」;其余动作重跑命令即可完成。

三步升级 ​

  1. 升级 CLI:pnpm add -g @fxri/toolkit(项目内依赖用 pnpm add -D @fxri/toolkit@2)
  2. 重跑初始化:toolkit init(改写 prepare 钩子与项目 / 本地配置段名,原文件备份 .bak)
  3. 重装技能:toolkit skill install --yes

随后重新生成规则快照:toolkit rule compose,把输出粘贴回 Agent 全局规则入口。

已移除(无别名,须立即改) ​

旧写法替代
toolkit usage ruletoolkit rule compose --module usage

已改名(别名保留至 2.1.0) ​

旧命令命中时由 CLI 在 stderr 提示新路径,脚本可在 2.1.0 前逐步替换。

旧路径新路径
toolkit taskstoolkit task
toolkit skillstoolkit skill
toolkit skills pathtoolkit skill status --path
toolkit skills gatetoolkit config get|set skillDelivery.default
toolkit skills sourcestoolkit skill source
toolkit rulestoolkit rule
toolkit conventionstoolkit convention
toolkit changelogtoolkit release
toolkit changelog versiontoolkit release bump
toolkit changelog formattoolkit release changelog
toolkit changelog doctoolkit release mirror
toolkit changelog addtoolkit release changeset add

技能新旧名对照 ​

旧名新名
fxri-plan-to-taskfxri-plan-task
fxri-session-recapfxri-plan-recap
fxri-skill-authoringfxri-writing-skill
fxri-docs-writingfxri-writing-docs
fxri-text-encodingfxri-code-encoding

fxri-plan-review 与 fxri-release-changelog 保留原名;新增 fxri-test-tty(test 族)。 旧名写入 metadata.previousNames,已保存选择集与安装迁移会自动跟随新名。

配置段名 ​

旧段名新段名
skillsInstallskillInstall
skillsDeliveryskillDelivery
projectSkillsprojectSkill
taskstask

项目层与本地层由 toolkit init 就地重写;全局层 ~/.toolkitrc.json 不在 init 处置范围, 按上表手动改名,2.1.0 起移除兼容。

JSON 输出 ​

报告类命令统一为 { schemaVersion, command, ok, data, issues }:

json
{
  "schemaVersion": 1,
  "command": "task stats",
  "ok": true,
  "data": { "total": 3 },
  "issues": []
}

读取变化:原顶层字段移入 data,command 标识命令来源,issues 汇总问题。 数据流保持原格式,不套信封:usage data export、task export 写出的文件、release changeset 透传。

全局工作目录 ​

新脚本用 toolkit --cwd <path> <命令>;各命令原有的 --cwd 继续可用。

更新日志链接 ​

文档站更新日志按主版本分页后,旧锚点迁到 /changelog/1.x#…,按站点内实际链接调整。

新命令 ​

task add / task update、rule check、docs(默认全量校验,docs check 同义)。

安装旧版本 ​

v1 最后一个版本保留为 1.x 标签:npm install -g @fxri/toolkit@1.x。 v1 文档只存在于 v1.17.8 标签源码,不另建在线归档站。

相关页面 ​

MIT 开源协议