@adamchanadam/agent-handoff-kit 0.3.10 → 0.3.11
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/README.md +2 -2
- package/bin/agent-handoff-kit.mjs +14 -11
- package/docs/whatsnew/v0.3.1.md +5 -5
- package/docs/whatsnew/v0.3.11.md +19 -0
- package/docs/whatsnew/v0.3.2.md +5 -5
- package/docs/whatsnew/v0.3.3.md +5 -5
- package/docs/whatsnew/v0.3.4.md +2 -2
- package/package.json +1 -1
- package/packs/writing.md +2 -0
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Agent Handoff Kit
|
|
2
2
|
|
|
3
|
-
狀態:目前版本為 `v0.3.
|
|
3
|
+
狀態:目前版本為 `v0.3.11`。這是早期可用版本,仍在持續完善中。
|
|
4
4
|
|
|
5
5
|

|
|
6
6
|
|
|
@@ -257,7 +257,7 @@ Agent Handoff Kit 可與 [Adam-AI-Instructions](https://github.com/prompt-templa
|
|
|
257
257
|
|
|
258
258
|
## 目前限制
|
|
259
259
|
|
|
260
|
-
- 目前版本為 `v0.3.
|
|
260
|
+
- 目前版本為 `v0.3.11`。
|
|
261
261
|
- 這是早期可用版本,仍在持續完善中。
|
|
262
262
|
- 升級合併屬窄範圍策略,不是完整的複雜合併工具。
|
|
263
263
|
- `doctor` 能檢查結構,不能代替 AI 對專案內容的理解。
|
|
@@ -1971,18 +1971,21 @@ function printInstallNextSteps(root, conflictCount, mode = "first-install", skip
|
|
|
1971
1971
|
// R-031 v0.3.1+: Upgrade substantive next-step block. Distinct from install
|
|
1972
1972
|
// (`printInstallNextSteps`) because the user is not first-time; pushing them through
|
|
1973
1973
|
// the onboarding canonical phrase resets context they already have.
|
|
1974
|
-
async function printUpgradeNextSteps(root, conflictCount, version, preUpgradeRootVersion) {
|
|
1975
|
-
console.log("");
|
|
1976
|
-
console.log("============================================================");
|
|
1974
|
+
async function printUpgradeNextSteps(root, conflictCount, version, preUpgradeRootVersion) {
|
|
1975
|
+
console.log("");
|
|
1976
|
+
console.log("============================================================");
|
|
1977
|
+
if (conflictCount > 0) {
|
|
1978
|
+
console.log("⚠️ 升級未完成:有檔案需要人工確認");
|
|
1979
|
+
console.log("============================================================");
|
|
1980
|
+
console.log("⚠️ 狀態:有既有檔案需要人工確認,詳情見 migration report。");
|
|
1981
|
+
console.log("⚠️ 這不是檔案壞掉;工具已停手,沒有覆寫 conflict 檔案。");
|
|
1982
|
+
console.log("📋 下一步:把 migration report 或這段輸出貼給 AI,請它幫你判斷怎樣合併。");
|
|
1983
|
+
console.log("============================================================");
|
|
1984
|
+
return;
|
|
1985
|
+
}
|
|
1977
1986
|
console.log("✅ 升級完成:Kit 檔案已更新到最新版本");
|
|
1978
|
-
console.log("============================================================");
|
|
1979
|
-
|
|
1980
|
-
console.log("⚠️ 狀態:有既有檔案需要人工確認,詳情見 migration report。");
|
|
1981
|
-
console.log("⚠️ 這不是檔案壞掉;工具已停手,沒有覆寫 conflict 檔案。");
|
|
1982
|
-
console.log("📋 下一步:把 migration report 或這段輸出貼給 AI,請它幫你判斷怎樣合併。");
|
|
1983
|
-
console.log("");
|
|
1984
|
-
}
|
|
1985
|
-
// R-031.2 v0.3.2+: Inline whatsnew summary — directly surface what changed in this
|
|
1987
|
+
console.log("============================================================");
|
|
1988
|
+
// R-031.2 v0.3.2+: Inline whatsnew summary — directly surface what changed in this
|
|
1986
1989
|
// version (and any intermediate versions the user skipped).
|
|
1987
1990
|
// R-031.3 v0.3.3+: fromVersion now uses pre-upgrade snapshot (captured before
|
|
1988
1991
|
// inject mutated PROJECT_INDEX), so the range narrative reflects actual user
|
package/docs/whatsnew/v0.3.1.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# v0.3.1
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## 本版新加了甚麼
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
改善升級流程的提示文字。完成升級、再次執行 `upgrade`、或沒有任何檔案需要更新時,工具會顯示不同提示,避免把「已經是最新版本」誤說成「安裝完成」。
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## 對你已有檔案的影響
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
本版只調整工具輸出文字,不會改動既有項目內容,也不會改變已安裝的 Kit 文件結構。
|
|
10
10
|
|
|
11
11
|
## 建議下一步
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
執行 `doctor` 檢查項目健康即可。
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# v0.3.11
|
|
2
|
+
|
|
3
|
+
## 本版新加了甚麼
|
|
4
|
+
|
|
5
|
+
本版把 v0.3.10 發佈後留下的用戶旅程檢查補成長期守門。重點不是增加新功能,而是把已驗證的首次安裝、升級、衝突停手與公開文件一致性,轉成每次發佈前都會跑的檢查。
|
|
6
|
+
|
|
7
|
+
## 對你已有檔案的影響
|
|
8
|
+
|
|
9
|
+
既有項目不用重裝。升級時若沒有需要合併的內容,工具不會假裝完成一件大事;若遇到不能安全判斷的衝突,會清楚停手並提示先處理衝突。舊版本升上來時,工具也會保留既有資料與本地規則。
|
|
10
|
+
|
|
11
|
+
## 建議下一步
|
|
12
|
+
|
|
13
|
+
升級前可先預演:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npx --yes @adamchanadam/agent-handoff-kit@latest upgrade --dry-run
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
如果預演沒有 conflict,再執行正式升級。升級後可用 `doctor` 檢查項目是否完整;第一次使用的新項目,仍按安裝後顯示的起步句進入 AI 對話。
|
package/docs/whatsnew/v0.3.2.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# v0.3.2
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## 本版新加了甚麼
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
`doctor` 和 `init` 會顯示「項目狀態速覽」,包括工具版本、項目記錄版本、npm 最新版本、上次收工時間,以及項目首次安裝距今多久。`upgrade` 完成後也會直接顯示本版重點,讓使用者不必再另外查找更新說明。
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## 對你已有檔案的影響
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
本版只改善工具提示與狀態顯示,不會改動既有項目內容,也不會改變已安裝的 Kit 文件結構。
|
|
10
10
|
|
|
11
11
|
## 建議下一步
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
執行 `doctor` 檢查項目健康,並留意輸出中的「項目狀態速覽」。
|
package/docs/whatsnew/v0.3.3.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# v0.3.3
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## 本版新加了甚麼
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
修正升級後的版本提示矛盾。完成 `upgrade` 後,`doctor` 不應再說項目版本落後於目前工具版本。若使用者從較舊版本直接升級到本版,工具也會提示這次跨度較大,並引導使用者查看 GitHub Release 的完整歷史說明。
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## 對你已有檔案的影響
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
本版不會改動使用者填寫的項目內容。`upgrade` 後,`dev/PROJECT_INDEX.md` 內的「Agent Handoff Kit template version」資料列會更新為目前版本;其他由使用者填寫的資料列會保留。
|
|
10
10
|
|
|
11
11
|
## 建議下一步
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
執行 `doctor` 檢查項目健康即可。
|
package/docs/whatsnew/v0.3.4.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# v0.3.4
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## 本版新加了甚麼
|
|
4
4
|
|
|
5
5
|
本版修補升級後版本敘事不一致的問題。既有專案執行 `upgrade` 後,`dev/PROJECT_INDEX.md` 內的「Agent Handoff Kit template version」資料列會在合併完成後再更新為目前 CLI 版本,避免先更新、後又被舊合併結果覆蓋。
|
|
6
6
|
|
|
7
7
|
升級工具也會辨認「只有版本資料列過期」的情況。即使沒有新增檔案、沒有合併檔案、沒有衝突,只要這一列仍是舊版本,就不會誤報「已經是最新版本,沒有檔案需要建立或合併」。
|
|
8
8
|
|
|
9
|
-
##
|
|
9
|
+
## 對你已有檔案的影響
|
|
10
10
|
|
|
11
11
|
本版只會更新 `dev/PROJECT_INDEX.md` 的 template version metadata。這一列屬工具維護的模板資料,不是你填寫的項目內容。你在 External Sources、Fact Base、Workspace Identity 等表格中填過的內容仍會保留。
|
|
12
12
|
|
package/package.json
CHANGED
package/packs/writing.md
CHANGED
|
@@ -16,12 +16,14 @@ Use for drafting, editing, style, structure, publication copy, documentation pro
|
|
|
16
16
|
3. Keep terminology consistent with project docs.
|
|
17
17
|
4. Mark uncertain claims instead of inventing support.
|
|
18
18
|
5. Do not bury durable requirements only in prose; use project index, spec, runbook, or handoff when needed.
|
|
19
|
+
6. For public Traditional Chinese docs or HTML aimed at non-technical readers, use steady written Chinese. Keep English only for commands, paths, URLs, file names, product names, and unavoidable tool names. Avoid mixed half-English fragments, internal governance codes, and developer-only wording in reader-facing prose.
|
|
19
20
|
|
|
20
21
|
## Checks
|
|
21
22
|
|
|
22
23
|
- Verify requested format, language, and tone.
|
|
23
24
|
- Check links, commands, names, and version-sensitive claims when relevant.
|
|
24
25
|
- Check `dev/DOC_SYNC_REGISTRY.md` if public docs or user-facing instructions changed.
|
|
26
|
+
- For public Chinese docs, read the final text as a new user journey: the next action should be clear without technical background.
|
|
25
27
|
|
|
26
28
|
## Closeout
|
|
27
29
|
|