SuperAPI AI 工具集

change-publish

通用与其它

查看项目

更新于 10-16 01:08

技能介绍

用途:在 /change-clarify 接受 ChDR 之后,把已接受的 ChDR 从本地草稿提升为持久化项目记忆,写入 {REPO_ROOT}/docs/adlc/memory/chdr/,并重新生成供 team-boot 在会话启动时注入的索引 {REPO_ROOT}/docs/adlc/memory/chdr.md。它写的是项目本地记忆,而非团队级 team-ai-directives,因此不创建 PR,由用户按常规流程提交。

主要能力:校验已接受 ChDR 的状态与 Decision 声明来源;为每个提升的 ChDR 写入带 OKF 风格 frontmatter 的 ChDR-{NNN}.md;重建 chdr.md 索引(行以 | ChDR- 开头,与 pdr.md/adr.md 同级);将源草稿状态标记为 ### Status: Published 并补充提升日期与记忆路径;跳过来源校验失败或与已有记忆相同 issue key 的重复项。

使用方式:先通过 /change-clarify 接受 ChDR;调用时可传入参数如 "ChDR-001 ChDR-003" 只提升指定项,留空则提升全部已接受 ChDR。流程含环境准备、前置检查、来源校验、重复检查、记忆记录生成、索引重建、草稿状态更新与汇总;环境脚本为 scripts/bash/setup-change-publish.sh,失败时可手动解析路径:REPO_ROOT、CHDR_DRAFTS_DIR=REPO_ROOT/.adlc/drafts/chdr、MEMORY_DIR=REPO_ROOT/docs/adlc/memory/chdr、MEMORY_INDEX=REPO_ROOT/docs/adlc/memory/chdr.md。

适用场景:已接受 ChDR 待推广;重跑 /change-init 后把新的已接受 ChDR 加入记忆索引。不适用:尚无已接受 ChDR(先跑 /change-clarify)、发现 ChDR(用 /change-init)、评审 ChDR(用 /change-clarify)。

限制:不会在 ChDR 未经 /change-clarify 接受前运行;来源校验不通过的 ChDR 不予提升(防止未证来源决策经 team-boot 污染后续会话);索引行必须以 | ChDR- 开头且文件位于 docs/adlc/memory/chdr.md,否则 team-boot 无法识别;一次提升后需用户自行提交记忆目录。具体命令输出格式与更多参数细节暂未提供。