@fxri/toolkit 1.13.0 → 1.14.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # 方弦工具集
 
+## 1.14.0
+
+> 2026-11-02 发布
+
+### ✨ 新增功能
+
+- `skills install --from <path>` 纳入外部本地技能源（根 SKILL.md / skills/\*/SKILL.md / skills.json 清单三种格式），临时来源只写副本，`--save [name]` 登记为永久来源并默认软链
+- `skills sources` 查看来源、`skills sources remove <name> --prune` / `skills remove --source` 按来源注销与清理
+- 安装 / 卸载操作锁（pid / host / startedAt，5 分钟过期接管），避免多进程同时改写状态与产物
+- 外部来源同名、目录越界与清单 `formatVersion` 非 1 时明确报错，不静默回退
+- 技能按 `metadata.tier` 分层（`core` 必装、`optional` 可选），安装时 TTY 方向键多选，支持 `--skills` / `--all` / `--no-optional` / `--yes`，首次只装 core
+- 按 `SKILL.md` frontmatter `metadata.requires` 自动补全依赖技能，缺失依赖告警后跳过
+- 技能选择后选择目标——全局面按 canonical + 已检测 agent 多选，项目面按候选薄壳目录多选；只用 `--agent` / `--all-agents` 可显式指定，`--no-save-agents` 只影响本次，`--dir` 始终一次性
+- 全局层 `skillsInstall` 与项目层 `projectSkills` 安装偏好（技能选择 + 目标选择），误写层告警并忽略；`prepare` 非交互按已保存目录刷新
+- `skills install --prune` 清理未选择（技能或目标）且内容与本包真源一致的旧产物；`skills remove --skills` 只清指定技能
+
+### 🔧 功能调整
+
+- 技能状态文件改为 `format` + `schemaVersion` + `sources` 结构，旧结构首次读取时一次性导入并备份 `.bak`
+- `skills status` 的 `missing` 只表示已选择但缺失，新增「未选择但已安装」单列（技能与目标两级）且不计入问题
+- `skills remove` 按「配置 → 产物 → 状态」顺序清理
+- `fxri-text-encoding` 触发判据改为上下文中可观测的写入 / 生成 / 执行通道与症状，显式取消临时、一次性、不入库任务豁免
+- 技能描述与规则层同步，写脚本、配置、数据交换文本及跨进程管道前按读取方定字节形态
+- 判据改为按读取方默认解码与字节形态推导，不按语言 / 扩展名白名单，补 PHP 与按平台编码编译的源文件
+- 补命令行参数、环境变量、API 请求体、模板渲染与远端元数据的跨边界判据，故障判定以与原文比对为准
+
+## 1.13.1
+
+> 2026-11-01 发布
+
+### 🐛 问题修复
+
+- `conventions status` 与 `tasks check` 的稳定 ID 校验收紧为去补零形态，`C-001` 这类补零写法现会告警并提示改写为 `C-1`
+
 ## 1.13.0
 
 > 2026-10-24 发布

package/README.md

@@ -69,12 +69,12 @@ toolkit skills install --scope project                # 项目面分发：真源
 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` 钩子自动补齐。
+技能随包分发（真源为包内 `skills/`），与 CLI 同一发布批次（技能内容版本独立编号）；`toolkit skills install` 默认软链，链接创建失败自动降级副本，`toolkit skills status` 查现场，`toolkit skills remove` 卸载。安装分两步交互：先按 `metadata.tier` 选技能（`fxri-plan-to-task`、`fxri-session-recap` 为 `core` 必装，`fxri-release-changelog`、`fxri-text-encoding` 为 `optional`），再选目标（`canonical` 主目标 + 已检测 agent；项目面为候选薄壳目录）；`--skills` / `--all` / `--no-optional` / `--agent` / `--all-agents` / `--yes` 可跳过交互，首次只装 `core` 与全部可用目标，`--no-save-agents` 只影响本次。选择集分别写入 `~/.toolkitrc.json` 的 `skillsInstall` 与项目层 `.toolkitrc.json` 的 `projectSkills`。外部技能源用 `--from <path>` 临时纳入（副本、只写本次），加 `--save [name]` 登记为永久来源（默认软链）；`toolkit skills sources` 查看 / 注销来源。`--scope project` 换项目面——真源落 `<仓库根>/.agents/skills/`、其余候选目录落入口薄壳，随 git 入库后队友 clone 靠 `toolkit init` 写入的 `prepare` 钩子自动补齐。
 
 - [fxri-plan-to-task](./skills/fxri-plan-to-task/SKILL.md)：方案确认后落盘为任务文件（任务分解与纯展示计划表、逐仓逐任务建档、check、归档 + 任务级规范沉淀为强制终点）
 - [fxri-release-changelog](./skills/fxri-release-changelog/SKILL.md)：发版时创建变更集、格式化多语言 CHANGELOG
 - [fxri-session-recap](./skills/fxri-session-recap/SKILL.md)：会话收尾全量沉淀、新会话三层恢复、历史任务时间批量修正（1.7.0 新增技能）
-- [fxri-text-encoding](./skills/fxri-text-encoding/SKILL.md)：文本文件的 UTF-8 / BOM / 行尾基线，脚本中文乱码、终端与重定向输出乱码、首行报错的定位与修复
+- [fxri-text-encoding](./skills/fxri-text-encoding/SKILL.md)：文本字节形态基线（文件、管道、命令行、API 请求体，含临时脚本与一次性命令），非 ASCII 文本丢失 / 乱码与首行报错的定位与修复
 
 skills 与工具的关系、只在公司项目激活等说明见 [FAQ](./docs/faq.md) 与 [完整攻略](./docs/guide.md#ai-技能包-skills)。