@fxri/toolkit 1.11.2 → 1.11.4

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # 方弦工具集
 
+## 1.11.4
+
+> 2026-09-30 发布
+
+### 🐛 问题修复
+
+- `toolkit init` 的发布型包误打包提示不再绑定 `prepare` 刷新钩子——判据独立为「`package.json` 未标 `private` 且无 `files` 白名单」，覆盖原先漏报的 `--no-hooks`、未声明本地依赖、非等价 `prepare` 等情形
+- 上述提示的产物清单补全——按现场动态列出技能真源 `.agents/skills/`、各已存在的候选技能目录下的入口薄壳（`.trae/skills/`、`.trae-cn/skills/`、`.cursor/skills/`、`.claude/skills/`）与归属账 `.toolkit/`，并加入内置任务区 `.tasks/`（任务区外置时不计入），说明 `npm` 无 `.npmignore` 时退回 `.gitignore` 的打包面原理
+- `toolkit skills install` / `status` / `remove` 此前只把技能分发到用户全局目录，项目内装的 toolkit 落点也不在项目、队友 clone 后拿不到；现新增 `--scope <project|global|all>`，缺省按 CLI 安装位置自动判定（项目内装的落项目面、全局装的落全局面），项目面随 git 入库、clone 即用
+- 项目面技能采用「唯一真源 + 多份入口薄壳」形态——完整副本恒定落 `<仓库根>/.agents/skills/`，其余已存在的候选技能目录各放一个指向真源的薄壳 `SKILL.md`，agent 循薄壳读真源，避免重复真源
+- 项目面归属账落 `<仓库根>/.toolkit/state.json`（随仓库入库，记真源与各薄壳落点的仓库相对路径）
+- `toolkit init` 幂等写入 `prepare` 钩子（`toolkit skills install --scope project`），`pnpm install`（含 `pnpm up @fxri/toolkit`）时自动刷新项目面真源与薄壳，消除手动重跑；仅当本包为项目本地依赖时写入，未声明本地依赖（如全局安装）时不写、需要时手工补，绕过 `init` 直接 `skills install --scope project` 启用项目面者需自行补钩子；不需者用 `--no-hooks` 关闭
+
+### 📝 文档更新
+
+- `docs/faq.md` / `docs/guide.md` / `docs/cli.md` 同步发布型包注意事项
+- 同步 `skills` 域 `--scope`、`init --no-hooks` 与项目面分发说明（README / guide / handbook / faq / getting-started / cli）
+
+## 1.11.3
+
+> 2026-09-29 发布
+
+### ⚡ 优化改进
+
+- 本仓库门禁类型检查此前读基础 `tsconfig.json`（其 `exclude` 排除 `**/__tests__` 等测试路径），测试文件长期落在类型检查盲区；现类型检查改走放行该排除项的 `tsconfig.typecheck.json`，并清零由此暴露的存量测试类型错误
+
+### 🐛 问题修复
+
+- `toolkit tasks check` 的本地配置忽略告警在 Windows 8.3 短名环境下丢失——`git rev-parse` 返回长名工作树根（如 `C:\Users\runneradmin\…`）而调用方路径为短名（如 `C:\Users\RUNNER~1\…`），工作树归属比对因路径形态不同失配被误归 `outside-repo`，「未忽略 / 已跟踪」告警静默吞掉；现两侧先取磁盘真实形态再比对
+- 本地层配置查找的 home 边界在其形态与目录链不一致时失效（home 为短名或软链形态），存在把 `~/.toolkitrc.local.json` 误当项目本地层命中的风险；现 home 与目录链两侧统一取真实形态比对
+
 ## 1.11.2
 
 > 2026-09-29 发布

package/README.md

@@ -24,7 +24,7 @@ AI 参与开发后，方案与决策散落在对话记录里，会话一关什
 # 1. 项目内安装（推荐，团队共享版本）
 pnpm add -D @fxri/toolkit
 
-# 2. 初始化任务区（生成 .tasks/ 骨架、conventions/ 规范载体与技能入口壳）
+# 2. 初始化任务区（生成 .tasks/ 骨架、conventions/ 规范载体与技能入口壳；含本地依赖时写入 prepare 刷新钩子）
 pnpm exec toolkit init
 
 # 3. 查看任务总览
@@ -42,7 +42,7 @@ pnpm exec toolkit tasks
 | 协作规范载体（conventions） | 把任务里提炼的规范收进 `.tasks/conventions/`，成为可检索、可校验的项目规范源；支持结构升级与只读体检 | [CLI 参考](./docs/cli.md) · [完整攻略](./docs/guide.md#conventions-规范沉淀地) |
 | Node API | 把上述能力嵌进脚本或平台 | [API 参考](./docs/api.md) |
 | 隐私脱敏 | 落盘前自动掩码邮箱、手机号、密钥等 | [配置参考](./docs/config.md) |
-| AI 技能包（skills） | 不装本工具也能让 AI 按同一套规范干活；装了可一键分发技能 | [完整攻略](./docs/guide.md#ai-技能包-skills) · [FAQ](./docs/faq.md#工具和-skills-都得装吗) |
+| AI 技能包（skills） | 不装本工具也能让 AI 按同一套规范干活；装了可一键分发技能（`--scope project` 随仓库入库、队友 clone 即用） | [完整攻略](./docs/guide.md#ai-技能包-skills) · [FAQ](./docs/faq.md#工具和-skills-都得装吗) |
 | 配置文件 | 三层（全局 / 项目 / 本地）定制脱敏、告警、导入列映射、语言表；`toolkit config status` 只读查看生效情况与来源 | [CLI 参考](./docs/cli.md#config-1-11-2-新增) · [配置参考](./docs/config.md) |
 
 ## 📚 文档
@@ -65,10 +65,11 @@ pnpm exec toolkit tasks
 
 ```bash
 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` 卸载。
+技能随包分发（真源为包内 `skills/`），与 CLI 同一发布批次（技能内容版本独立编号）；`toolkit skills install` 默认软链，链接创建失败自动降级副本，`toolkit skills status` 查现场，`toolkit skills remove` 卸载。`--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