Conversation
borankux
marked this pull request as ready for review
June 10, 2026 08:43
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.
摘要
doctor、snapshot、docs sync、profile validate、changelog bump。node:test的测试,覆盖参数解析、版本计算、Markdown 链接解析和 profile 校验。docs/cli.md,并在 README 与 SKILL.md 中补充 CLI 用法。为什么需要这个改动
Project Butler 的 Skill 文档已经覆盖了完整的项目记忆流程,但其中有一部分工作属于确定性的状态检查和文件记账,例如:
DOCS.md索引。UPDATE_LOG.md的下一个版本。这些事情如果完全依赖 LLM 按 Markdown 协议手动执行,容易出现漏字段、漏链接、版本计算不一致、profile JSON 漂移等问题。
这个 PR 的设计是:Skill 仍然负责交互、判断和用户确认;CLI 只负责可验证的检查和记账。这样可以降低维护成本,也能让 Project Butler 的长期记忆文件更稳定。
设计原则
--write才会落盘。node:test,避免额外测试框架依赖。npm audit --audit-level=moderate当前为 0 vulnerabilities。命令示例
验证
npm run checknpm audit --audit-level=moderatenode dist/src/cli.js doctor --jsonnode dist/src/cli.js snapshotnode dist/src/cli.js changelog bump --level minor --title "Add CLI utilities" --bullet "Added deterministic project memory checks"