用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/q512426816/sillyspec --skill sillyspec-archive命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| name | sillyspec:archive |
| description | 用于归档已验证完成的变更。适合用户说"归档、archive、收尾这个变更"。执行模块影响分析 + 同步模块文档 + 移动到 archive 目录 + 更新 ROADMAP。 |
🔧 模块影响分析步:先跑
sillyspec module-impact --change <变更名>生成 module-impact.md 骨架——文件×模块归属按_module-map.yamlpaths 前缀匹配预填 + 未匹配文件清单,你只需逐行填「影响类型」与 review 标记(以 git diff 为准,真实 > 声明);已存在不覆盖。
项目有多个活跃变更(.sillyspec/changes/ 下有多个目录)时,所有 sillyspec run 命令需加 --change <变更名> 指定操作目标;只有一个变更时可省略(CLI 自动检测)。
sillyspec archive是sillyspec run archive的顶层别名,两者等价。
sillyspec run archive # 输出当前步骤 prompt
sillyspec run archive --done --output "摘要" # 完成当前步骤
sillyspec run archive --status # 查看阶段进度
sillyspec run archive --skip # 跳过可选步骤
sillyspec run archive --reset # 重置阶段(从头开始)
sillyspec run archive --reopen --from-step N # 重新打开已完成阶段修订(N=序号或名称)
| 参数 | 说明 |
|---|---|
--change <名> | 指定变更名(多活跃变更必填,单变更可省略自动检测) |
--spec-dir <path> | 指定规范目录(默认 <项目>/.sillyspec) |
--non-interactive | CI/脚本下禁用交互式 prompt |
--skip-approval | 跳过阶段转换/审批检查(不能跳产物校验 gate——review.json/文档产物硬校验仍在) |
--confirm(确认归档步骤必填)第 4 步「确认归档」由 CLI 执行目录移动,必须带 --confirm:
sillyspec run archive --done --confirm --output "确认归档"
不带 --confirm 时 CLI 回退步骤为 pending 并提示,不会误归档。
CLI 移动目录前会校验 plan.md 存在——缺失则 exit(1) 阻断(目录尚未移动,可补全后重试)。移动后校验 design.md / module-impact.md(缺失只告警,因目录已移动)。
第 3 步「sync-module-docs」会更新 _module-map.yaml + 模块卡片,必须暂停等用户确认:
sillyspec run archive --wait --reason "等待用户确认模块文档同步" --options "确认写入,跳过同步" --output "diff 摘要"
sillyspec run archive --continue --answer "确认写入"
只有用户 --continue --answer "确认写入" 后才写入文件。
归档后变更目录从 changes/<名>/ 移到 changes/archive/<名>/,并从活跃列表注销。后续用 /sillyspec:commit 提交。
verify → archive → git commit
archive 完成后,运行 /sillyspec:commit 提交归档结果(git add .sillyspec/changes/)。
mv/rename 重命名变更目录,必须由 CLI 的「确认归档」步骤移动--done,不跳过$ARGUMENTS