jiapuapp/docs/superpowers/plans/2026-07-15-repository-slim-handoff.md

仓库精简与交接证据保留实施计划

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:executing-plans. The user forbids subagents, worktrees and Git write operations.

Goal: 将当前可交接项目整理为约 30MB 的 Git 快照，同时在项目外完整保留设计审计资料。

Architecture: 使用 tests/repository-handoff-size-contract.ps1 约束标准路径、证据体积和忽略规则；先暂存精简证据，再把完整 docs/design/ 和 tmp/ 移到固定外部归档，最后恢复精简 docs/design/ 并更新索引。

Tech Stack: Markdown、PowerShell、Git 只读检查。

Global Constraints

• 不修改 static/、页面、路由、接口或运行行为。
• 不删除完整证据，只移动到 C:\Users\Rain\Desktop\job\jiapuapp-design-evidence-archive-2026-07-15。
• 不使用多代理、worktree、git add、commit、push、reset、checkout 或历史重写。

Task 1: 建立精简契约

Files:

• Create: tests/repository-handoff-size-contract.ps1

• 写入标准文档路径、证据上限、忽略规则和索引链接检查。

• 运行测试，确认因缺少 .gitignore 或证据超限而 RED。

Task 2: 建立外部完整归档并恢复精简证据

Files:

• Create: .gitignore

• Modify: docs/design/视觉证据索引.md

• Move outside repository: full original docs/design/

• Move outside repository: tmp/ and tmp-g01-icon-audit.png

• Restore: compact docs/design/

• 将全部设计 Markdown、两张风格锚点和批准的代表截图复制到项目内临时保留区。

• 校验源和目标绝对路径后，将完整 docs/design/ 移到固定外部归档。

• 将 tmp/ 和根目录临时审计图移入归档。

• 把临时保留区恢复为标准 docs/design/。

• 更新视觉证据索引和 .gitignore。

• 运行精简契约并确认 GREEN。

Task 3: 收口验证

• 确认外部归档大于 90MB。
• 确认精简截图不超过 20MB、35 个文件。
• 确认 git diff --name-status -- static 无输出。
• 运行 tests/handoff-documentation-contract.ps1。
• 运行 git diff --check。