القائمة
阶段六（档）。用户输入 /ssf-archive 或由 ssf-ship 续接时触发。归档 OpenSpec change、同步文档、更新 decision ledger，并用 Diataxis 检查文档缺口。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | ssf-archive |
| description | 阶段六（档）。用户输入 /ssf-archive 或由 ssf-ship 续接时触发。归档 OpenSpec change、同步文档、更新 decision ledger，并用 Diataxis 检查文档缺口。 |
把一次变更从“对话和代码”沉淀为长期组织记忆。
本阶段体现 OpenSpec 的 archive 价值：已完成的变更要变成可追踪历史，而不是散落在聊天记录里。
/ssf-archive [change-id]ssf-ship 确认后续接宿主项目 archive 运行时产物默认写入 .superspecflow/archive/<change-id>/。Decision records 默认写入 .superspecflow/decisions/。读取历史归档产物时先读 .superspecflow/archive/<change-id>/，缺失时 fallback 到兼容期旧路径；新写入不得推荐根目录 archive/<change-id>/。
# Archive Summary: [change-id]
- Date:
- Summary:
- Specs:
- Implementation:
- Tests:
- QA Result:
- Ship Decision:
- Residual Risk:
- Status: Archived / Pending Archive
逐一更新：
## Update: [doc path]
### Proposed Change
### Why
### Text to Add / Modify
默认扫描：
# Decision Record: [title]
## Context
## Decision
## Why
## Consequences
## Linked Change
openspec/changes/[change-id]
# Documentation Coverage
- Tutorial: ✅/❌
- How-to: ✅/❌
- Reference: ✅/❌
- Explanation: ✅/❌
## Recommended Additions
1. ...
输出：
✅ [change-id] archive artifacts complete.
继续 Step 6 记录 Git / PR archive，再进入自动续接。
归档时补充 Git 记录：
# Git / PR Archive
## Branch
## Commits
| Commit | 中文标题 | Spec IDs | Tests |
|---|---|---|---|
## PR
## Merge / Release Reference
## Rollback Reference
如果 commit 或 PR 没有中文内容，标记为流程缺口，并在 ssf-retro 中提出修复建议。
归档、ledger、文档覆盖和 Git / PR archive 都完成后，进入：
/ssf-retro [change-id]
如果用户明确结束本轮，不继续 /ssf-retro，记录该决定和原因；否则不得在 Step 6 前宣布 cycle complete。
阶段三（建）。用户输入 /ssf-build 或由 ssf-spec 续接时触发。按 OpenSpec tasks 执行，使用 Superpowers 风格：理解、计划、TDD、小步实现、验证、更新 spec-to-code-map。
复盘。用户输入 /ssf-retro 时触发。复盘本轮 SuperSpecFlow，检查产品、规格、开发、测试、发布各阶段的流程质量，输出可执行改进。
阶段二（规）。用户输入 /ssf-spec 或由 ssf-think 续接时触发。生成 OpenSpec 风格 change contract：proposal.md、design.md、specs/*.md、tasks.md、Spec Readiness Review。
阶段一（想）。用户输入 /ssf-think 或描述新想法/新功能时触发。用 Superpowers brainstorming 纪律做价值、体验、范围反问，产出 Product Change Brief、Decision Record 和 design.md，然后进入 ssf-spec。
Git 工作流与中文 commit 正文门禁。用户输入 /ssf-git、/ssf-branch、/ssf-commit、/ssf-pr，或要求建分支、提交、生成 PR、合并、rebase 时触发。强制分支、暂存、提交、PR 与 OpenSpec change-id/Spec ID 对齐；commit 标题的类型与范围使用英文标识符（conventional commits），摘要、正文、字段名必须使用中文。
Karpathy 风格的 AI 编码行为约束。用于写代码、review、重构、修 bug、提交前审查，防止错误假设、过度设计、无关改动和不可验证目标。