docs(skills): 补全 update --target-version 用法 - #71
Closed
Espressohan wants to merge 1 commit into
Closed
Espressohan wants to merge 1 commit into
Espressohan wants to merge 1 commit into
Conversation
`update --repair` 只修复当前安装,不会改变已安装的版本号;原文档未说明 跨版本升级必须显式传入 `--target-version <version>`,容易让 Agent 在收到 「有新版可用」提示后误以为执行 `update --repair` 即已完成升级。 - `scripts/generate-contracts.mjs`:更新 shared 决策表与 `lifecycle.md` 模板, 补充 `--target-version` 示例、回滚说明,以及未传该参数时版本号不变的排查要点。 - 同步重新生成 `skills/hithink-finance-shared/` 与 `skills/manifest.json`。 验证:`npm run generate:contracts` 重跑后无额外差异;`npm run verify` 全绿。
Owner
|
审查意见(P1):本 PR 修正了 Skill 文档,但实际更新提示仍在 请同时更新该提示(使用检测到的 |
Owner
|
感谢反馈。我们已确认: 修复方案会统一 CLI 行为说明与用户提示:保留 考虑到本次需要由维护方连同 CLI 提示和测试统一修复,我们先关闭此 PR,不合并当前提交。再次感谢你提供完整的复现、修复方向和验证结果。 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
问题
hithink-finance-shared的lifecycle.md(以及 sharedSKILL.md的快速决策表)把更新流程写成:实测
update --repair只修复当前安装,不会改变已安装的版本号。在提示有新版可用时按文档执行,命令会返回{"ok":true,"command":"update","data":{"version":"<当前版本>","repaired":true}}——成功但版本不变;跨版本升级必须显式传--target-version <version>:--target-version在update --help中存在,但两个 skill 文档都没有提到它,Agent 容易把「已确认升级」误报为完成。改动
只改生成源,并按仓库约定重新生成派生产物:
hithink-finance-cli/scripts/generate-contracts.mjsshared决策表条目与sharedReferenceFiles['lifecycle.md']模板hithink-finance-cli/skills/hithink-finance-shared/references/lifecycle.mdhithink-finance-cli/skills/hithink-finance-shared/SKILL.mdhithink-finance-cli/skills/manifest.json具体补充内容:
--target-version命令示例、回滚说明、以及「只写升级而未传--target-version时版本号不变,应比对update --check的current_version/latest_version」的排查要点。验证
npm run generate:contracts重跑后改动集不变,确认生成源与产物同步;skills/manifest.json109 个条目的 sha256 与磁盘文件逐一复核一致;npm run verify通过:54 个测试文件、178 个测试。