@fxri/toolkit 1.11.4 → 1.11.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +33 -3
- package/LICENSE +21 -21
- package/NOTICE +9 -9
- package/SPEC.md +3 -2
- package/TRADEMARK.md +41 -41
- package/dist/cli.cjs +52 -49
- package/dist/cli.js +53 -50
- package/dist/index.cjs +35 -32
- package/dist/index.js +35 -32
- package/package.json +1 -1
- package/skills/README.md +2 -2
- package/skills/fxri-plan-to-task/SKILL.md +4 -4
- package/skills/fxri-plan-to-task/assets/active-task-template.md +13 -13
- package/skills/fxri-plan-to-task/references/task-spec.md +3 -0
- package/skills/fxri-release-changelog/SKILL.md +3 -2
- package/skills/fxri-release-changelog/references/changelog-format.md +1 -0
|
@@ -3,14 +3,14 @@ name: fxri-release-changelog
|
|
|
3
3
|
description: 基于 changesets 的发版与多语言 CHANGELOG 维护流程：创建变更集、消费发版、把分组标题与条目转为项目语言风格、清理变更集、打标签发布；无 changesets 的项目提供同格式手工模式。当用户表达发版或记录变更意图——含创建变更集、changeset、发版、version、CHANGELOG 格式化等说法及其口语近义表达（如发一版、出个版本、记一下这次改动、生成更新日志）时使用。⚠️ 注意区分：用户说「提交个版本 / 先提交一版 / commit」通常指 git 提交当前改动（走任务收尾后提交），**不是发版**。不用于日常 commit message 撰写、git 提交操作或与发版无关的文档修改。
|
|
4
4
|
license: MIT
|
|
5
5
|
metadata:
|
|
6
|
-
version: "1.1.
|
|
6
|
+
version: "1.1.7"
|
|
7
7
|
author: fxri
|
|
8
8
|
source: https://github.com/fxri-net/toolkit
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
# 发版与 CHANGELOG
|
|
12
12
|
|
|
13
|
-
> 本技能版本 1.1.
|
|
13
|
+
> 本技能版本 1.1.7（随 @fxri/toolkit 同批分发）。被问版本时即报此值——不读磁盘、不跑 CLI：报出的值就是本会话上下文里已加载内容的版本，可与 `toolkit skills status` 打印的磁盘基准值对照，不一致即说明会话上下文已过期，开新会话即可。
|
|
14
14
|
|
|
15
15
|
## 何时使用
|
|
16
16
|
|
|
@@ -57,6 +57,7 @@ metadata:
|
|
|
57
57
|
| 改动已发布却无归档记录（有提交、无任务档） | 先补归档（fxri-session-recap 模式一）再继续发布后续步骤；发版本身不补建档 |
|
|
58
58
|
| 发版后历史块内出现多余空行（`自举一致性` 类零改动用例失败） | 跑 `toolkit changelog --history format` 归一（**必须带 `--history`**，默认模式不动历史块），再补跑一次镜像页同步脚本 |
|
|
59
59
|
| 格式化时 stderr 报「归类后条目数由 N 降为 M，疑似丢失内容」 | 归类只应搬移条目，减少即疑似丢内容：核对该版本块是否含非纯条目分组（标题下先出现正文）或被保留分组；确认属正常去重可忽略，否则按 references 的归类规则修回 |
|
|
60
|
+
| 一批改动含新增能力 / 参数，却整批按 `修复：` 前缀登记（整块落 `问题修复` 组）——常见于 bump 判定为 patch 时，误以为级别与条目前缀绑定 | 前缀按**变更本身性质**逐条定：新增命令 / 参数 / 产物用 `新增：`、缺陷纠正用 `修复：`。分组只看前缀、与 bump 正交，**patch 也可挂 `新增：`**——仅当改动属「配套修补型」方可在 patch 下用 `新增：` / `修改：`（须在任务档申报、对外不写判定依据），口径见 references 的级别例外 |
|
|
60
61
|
|
|
61
62
|
## 可选加速（不构成依赖）
|
|
62
63
|
|
|
@@ -24,6 +24,7 @@
|
|
|
24
24
|
- 同一分组内顶层条目**逐行相邻输出**（条目之间不留空行，缩进子项紧随父条目），分组之间与日期行前后各留一个空行——这是格式化的**不动点**：合规文件重复执行 `toolkit changelog format` 应零改动，`--history` 归一之后同理
|
|
25
25
|
- ⚠️ 变更集条目以 `- ` 开头时，changesets 会写入 `- - 条目` 首行并把后续行缩进 2 空格（伪影）；`toolkit changelog version/format` 会自动还原为顶层条目，手工模式需手动清理
|
|
26
26
|
- 分组标题集合随版本演进而变化；**历史版本块保留当时口径，`toolkit changelog format` 不追溯改写**（只归类 changesets 本次新写入的英文源标题块）
|
|
27
|
+
- ⚠️ **人工事实更正**：已发布版本块原则上不追溯改写；确需更正**事实性错误**（归组误判、错别字等）时允许人工修改——仓库 `CHANGELOG.md` 为真源，已发布的包产物与版本标签是**不可变快照**、不回补，正确版随下次发版由整份 CHANGELOG 带入
|
|
27
28
|
|
|
28
29
|
## 2. 语义分组归类
|
|
29
30
|
|