方案落盘即约束
方案确认完就丢、AI 会话一关什么都不剩?任务文件落在仓库 .tasks/,toolkit task check 校验、task archive 归档,决策不再随会话消失。
官方推荐路径:全局装 CLI → 装技能 → 组合自己的全局规则。按你的包管理器选一条安装:
pnpm add -g @fxri/toolkitnpm add -g @fxri/toolkityarn global add @fxri/toolkitbun add -g @fxri/toolkittoolkit skill install # 装技能到各 agent 全局技能目录
toolkit rule compose # 交互式选择模块,选完粘贴到所用 Agent 的规则入口
toolkit scope # (可选)按目录 / 技能维度限定生效范围,默认全域任务区初始化交给 AI:进入项目后说「初始化任务区」即可。团队项目改用 pnpm add -D @fxri/toolkit + toolkit skill install --scope project 锁定版本,项目内执行命令用 pnpm exec toolkit。
详细步骤见快速开始。
| 痛点 | 本工具的做法 |
|---|---|
| 方案确认完就丢,AI 会话一关什么都不剩 | 方案落盘为标准任务文件,toolkit task check 校验、toolkit task archive 归档、规范沉淀进 conventions 载体,能力终点到沉淀为止 |
| 多人(含多个 AI)同时维护任务,互相覆盖 | 任务唯一键 + 「先查后写」约定 + 归档排他锁 |
| 任务散落各处,总览、过滤、统计靠人肉 | 一条命令扫 .tasks/ 全目录,按状态/负责人/范围/日期过滤,可导出 CSV / XLSX / JSON |
| 发版 CHANGELOG 分组标题是英文,且分组维度与变更类型对不上 | 封装 changesets,条目按变更类型语义分组并内置中文格式化,任意语言可配置扩展 |
| 全局规则散在各人手里,升级后每份快照都不同步 | toolkit rule 按模块组合与复制,规则正文随包分发,升级后重新组合即同步 |
| 全局技能与规则在所有项目都被触发,个人项目也被插入 | 默认全域生效;toolkit scope 按白名单 / 黑名单 / 标记 / git 远端或技能矩阵策略限定生效目录,必要时 skill mount 做项目面安装 |
| 多个仓库的文档站样式与导航各写一套,漂移无人发现 | toolkit docs theme check / nav check / dist check 按随包规则统一校验 |
| 文档 | 适合谁 |
|---|---|
| 快速开始 | 第一次接触,想 30 秒跑起来 |
| 推荐技能包 | 按场景选择技能源(含外部来源) |
| 操作手册 | 日常照着做:每个场景该说什么、做什么 |
| 完整攻略 | 日常使用:工作流、Git 纳管范围、项目级激活、多语言 CHANGELOG |
| CLI 参考 | 查命令、参数、默认值、退出码 |
| API 参考 | 作为库引入 Node 项目,写脚本或二次开发 |
| 配置参考 | 查 .toolkitrc.json 字段 |
| 使用统计 | 启用后查技能调用次数、触发词与采集边界 |
| 更新日志 | 查各版本变更内容 |
| 常见问题 | 遇到问题先来这里找 |
| 全局规则索引 | 规则组合器:7 个模块自由勾选、排序与一键复制 |
| 推荐 AI 全局规则 | 想让 AI 助手按本工具的最佳实践协作 |
| 个人偏好规则 | 想把收尾提交等个人偏好单独配置 |
| 推荐提交信息规则 | 想让 AI 按统一格式写 git 提交信息 |
| 技能使用情况规则 | 启用本机使用统计后,约束 AI 不重复补记、不外传数据 |
toolkit skill install 分发到各 agent 全局技能目录