@fxri/toolkit 1.11.3 → 1.11.5

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # 方弦工具集
 
+## 1.11.5
+
+> 2026-09-30 发布
+
+### 📝 文档更新
+
+- 修正 1.11.4 块的条目前缀与归组——本版首度发布的新能力（`init` 发布型包误打包提示、项目面技能分发）原整批登记为 `修复：`、落「问题修复」组；现按变更本身性质逐条定为 `新增：`，归入「新增功能」组（条目前缀与 bump 级别正交，`patch` 亦可挂 `新增：`）
+- `fxri-release-changelog` 技能补失败模式口径——条目前缀按变更本身性质逐条定、与 bump 级别正交，避免因 bump 判为 patch 即整批按 `修复：` 登记新增能力；技能版本 1.1.5 → 1.1.6
+- `fxri-release-changelog` references 补「已发布版本块人工更正边界」口径——已发布版本块原则上不追溯改写，确需更正事实性错误时允许人工修改；仓库为真源，已发布的包产物与版本标签为不可变快照、不回补；技能版本 1.1.6 → 1.1.7
+
+### 🧹 清理移除
+
+- 移除 CHANGELOG 归类对 `技能：`/`skills：` 两个前缀的识别——该前缀不在类型字典规范内，移除后代码前缀表与技能参考文档的前缀表一致；此类条目不剥离前缀、留原组
+
+## 1.11.4
+
+> 2026-09-30 发布
+
+### ✨ 新增功能
+
+- `toolkit init` 新增发布型包误打包提示——`package.json` 未标 `private` 且无 `files` 白名单时提醒发布面风险，判据独立于 `prepare` 刷新钩子（`--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 发布

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