方弦工具集

国内网络建议优先 Gitee 镜像（与 GitHub 同源同步，仓库/文档/issues/skills 全渠道可用）；问题反馈走 GitHub Issues 或 Gitee Issues。

专为多人 + AI 跨项目协作打造：任务管理 + 多语言 CHANGELOG。

AI 参与开发后，方案与决策散落在对话记录里，会话一关什么都不剩；任务记录零散，谁在做、做到哪，无从查起；发版 CHANGELOG 还要人肉维护多语言。本工具把这条链路沉淀为仓库内可检索、可校验、可归档的文件——人离开会话，记忆留在仓库里。

• 零依赖 AI 技能包（skills）：方案落盘、发版 CHANGELOG 两套工作流沉淀为 Agent Skills，不绑定任何 AI 工具；skills 可以独立工作，CLI 是可选加速——推荐都装，体验最完整（什么关系？）
• 不懂 AI 也能用：任务管理与 CHANGELOG 是纯 CLI 能力；术语都说了人话（先看术语表）

🚀 30 秒上手

# 1. 项目内安装（推荐，团队共享版本）
pnpm add -D @fxri/toolkit

# 2. 初始化任务区（生成 .tasks/ 骨架、conventions/ 规范载体与技能入口壳；含本地依赖时写入 prepare 刷新钩子）
pnpm exec toolkit init

# 3. 查看任务总览
pnpm exec toolkit tasks

之后：方案确认后登记为 .tasks/ 任务文件 → pnpm exec toolkit tasks check 校验 → 完成后 pnpm exec toolkit tasks archive 归档并做规范沉淀。完整步骤见 新手指南。

✨ 能力矩阵

| 能力 | 适用场景 | 文档 | | --- | --- | --- | | 任务管理（tasks） | 方案落盘、总览过滤、校验归档、导入导出 CSV / XLSX / JSON | CLI 参考 · 任务文件规范 | | 多语言 CHANGELOG（changelog） | 封装 changesets 发版、分组标题本地化 | CLI 参考 | | 协作规范载体（conventions） | 把任务里提炼的规范收进 .tasks/conventions/，成为可检索、可校验的项目规范源；支持结构升级与只读体检 | CLI 参考 · 完整攻略 | | Node API | 把上述能力嵌进脚本或平台 | API 参考 | | 隐私脱敏 | 落盘前自动掩码邮箱、手机号、密钥等 | 配置参考 | | AI 技能包（skills） | 不装本工具也能让 AI 按同一套规范干活；装了可一键分发技能（--scope project 随仓库入库、队友 clone 即用） | 完整攻略 · FAQ | | 配置文件 | 三层（全局 / 项目 / 本地）定制脱敏、告警、导入列映射、语言表；toolkit config status 只读查看生效情况与来源 | CLI 参考 · 配置参考 |

📚 文档

| 文档 | 适合谁 | | --- | --- | | 新手指南 | 第一次接触，想 30 秒跑起来（含零基础术语表） | | 操作手册 | 日常照着做：每个场景该说什么、做什么 | | 完整攻略 | 日常使用：工作流、Git 纳管、项目级激活、多语言 CHANGELOG | | CLI 参考 | 查命令、参数、默认值、退出码 | | API 参考 | 作为库引入 Node 项目 | | 配置参考 | 查配置文件字段（全局 / 项目 / 本地三层） | | 更新日志 | 查各版本变更内容 | | FAQ | 遇到问题先来这里找 | | 推荐 AI 全局规则 | 想让 AI 助手按本工具的最佳实践协作 | | 推荐提交信息规则 | 想让 AI 按统一格式写 git 提交信息 | | 完整文档站 | 在线阅读体验 |

🧩 AI 技能包（skills）

pnpm add -g @fxri/toolkit && toolkit skills install   # 装了 CLI 一键分发（npm 用户：npm i -g @fxri/toolkit）
toolkit skills install --scope project                # 项目面分发：真源与入口薄壳随仓库入库、队友 clone 即用
pnpm dlx skills add fxri-net/toolkit                  # 也可用上游安装器（npm 用户：npx skills add fxri-net/toolkit）

技能随包分发（真源为包内 skills/），与 CLI 同一发布批次（技能内容版本独立编号）；toolkit skills install 默认软链，链接创建失败自动降级副本，toolkit skills status 查现场，toolkit skills remove 卸载。--scope project 换项目面——真源落 <仓库根>/.agents/skills/、其余候选目录落入口薄壳，随 git 入库后队友 clone 靠 toolkit init 写入的 prepare 钩子自动补齐。

• fxri-plan-to-task：方案确认后落盘为任务文件（动手前建档评估、check、归档 + 任务级规范沉淀为强制终点）
• fxri-release-changelog：发版时创建变更集、格式化多语言 CHANGELOG
• fxri-session-recap：会话收尾全量沉淀、新会话三层恢复、历史任务时间批量修正（1.7.0 新增技能）

skills 与工具的关系、只在公司项目激活等说明见 FAQ 与 完整攻略。

📦 安装

pnpm add -D @fxri/toolkit        # 项目 devDependency（团队项目推荐，版本随仓库锁定）
pnpm i -g @fxri/toolkit          # 全局（个人多项目推荐；pnpm 不受 nvm 切版本影响）
pnpm dlx @fxri/toolkit tasks     # 不安装临时执行

npm / yarn / bun 用户与各方式对比见 新手指南 · 安装。

🔒 隐私脱敏

落盘记录默认脱敏敏感信息：内置邮箱、手机号、身份证、IPv4、内网 URL、JWT、AWS / GitHub / OpenAI / Slack 密钥等 13 类规则，支持自定义规则与禁用。开关三档（CLI 参数 > 环境变量 > 配置文件），详见 配置参考。

⚙️ 环境要求

• Node.js >= 20.19.0（更低版本可安装，changesets 相关子命令不可用，见 FAQ）

📄 版权信息

作者：唐启云 [email protected]

出品：方弦研究所

版权：Copyright © 2026 唐启云. All rights reserved.

网站：方弦研究信息网

协议：MIT License

商标："方弦®"为第42类注册商标（注册号89648411），本开源许可不授予商标使用权，详见 TRADEMARK.md

方弦研究所为唐启云个人项目品牌与出品方，非独立法人实体；本软件著作权归唐启云所有。