48 lines
2.1 KiB
Markdown
48 lines
2.1 KiB
Markdown
# 仓库精简与交接证据保留实施计划
|
|
|
|
> **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`
|
|
|
|
- [x] 写入标准文档路径、证据上限、忽略规则和索引链接检查。
|
|
- [x] 运行测试，确认因缺少 `.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/`
|
|
|
|
- [x] 将全部设计 Markdown、两张风格锚点和批准的代表截图复制到项目内临时保留区。
|
|
- [x] 校验源和目标绝对路径后，将完整 `docs/design/` 移到固定外部归档。
|
|
- [x] 将 `tmp/` 和根目录临时审计图移入归档。
|
|
- [x] 把临时保留区恢复为标准 `docs/design/`。
|
|
- [x] 更新视觉证据索引和 `.gitignore`。
|
|
- [x] 运行精简契约并确认 GREEN。
|
|
|
|
### Task 3: 收口验证
|
|
|
|
- [x] 确认外部归档大于 90MB。
|
|
- [x] 确认精简截图不超过 20MB、35 个文件。
|
|
- [x] 确认 `git diff --name-status -- static` 无输出。
|
|
- [x] 运行 `tests/handoff-documentation-contract.ps1`。
|
|
- [x] 运行 `git diff --check`。
|