project-archive

name	project-archive
description	项目归档 — 把项目状态改为 archived，目录变为只读，标记完成日期。 适用情形：项目完结（年度审计出具报告、税务申报周期结束、M&A 交易完成）后保留历史记录。 触发词：归档项目、关闭项目、项目完结、项目封存。 核心：状态流转 closed → archived，目录权限改为只读，保留所有产出物供历史查询。
argument-hint	<project-code> [--force]
risk_level	medium
last_reviewed	"2026-06-14T00:00:00.000Z"
version	1.0.0

/finance:project-archive — 项目归档

把已关闭的项目标记为归档状态，目录只读。

命令格式

/finance:project-archive <project-code> [--force]

参数：

• <project-code>：项目代码
• --force：跳过状态检查（强制归档 active 项目）

状态流转

planning → active → fieldwork → reporting → closed → archived
                                                  ↑
                                              此处开始只读

只能在 closed 状态下归档（除非 --force）。

操作步骤

步骤 1：校验状态

读取 project.md 的 状态 字段：

当前状态	是否可归档	处理
closed	✅	直接归档
reporting	⚠️	提示"项目仍在报告阶段，确认归档吗？"
active / fieldwork / planning	❌	拒绝，要求先 close（修改状态为 closed）
archived	✅	幂等操作，输出"项目已是归档状态"

步骤 2：校验完整性

检查项目目录是否完整：

• project.md 存在
• 关键产出物存在（按类型）：
  • annual-audit：findings/ 至少 1 个
  • m-and-a：due-diligence/ 至少 1 个
  • budget-review：variance-analysis/ 至少 1 个
  • 其他：跳过

不完整时输出警告但不阻止归档。

步骤 3：写入归档信息

修改 project.md：

• 状态: closed → archived
• 添加 归档时间: {YYYY-MM-DD HH:MM}
• 添加 归档人: {current-user}

可选：把目录移至 ~/.config/finance-skills/projects/_archive/{code}-{YYYY}/（推荐）

步骤 4：标记只读

chmod -R 555 ~/.config/finance-skills/projects/{code}/

仅 ~/.config/finance-skills/projects/{code}/project.md 保持可写（允许 reopen）。

步骤 5：输出归档结果

════════════════════════════════════════
📦 项目已归档

代码: {code}
名称: {name}
原始周期: {start} ~ {end}
关闭时间: {closed_date}
归档时间: {archive_date}
归档人: {user}

项目目录: ~/.config/finance-skills/projects/_archive/{code}-{YYYY}/
权限: 只读

历史保留 5 年（{archive_date} + 5 年后自动清理）
════════════════════════════════════════

恢复项目：/finance:project-switch {code}（会自动 reopen 到 closed 状态）
════════════════════════════════════════

---

历史保留策略

归档后保留时间：5 年
├── 0-1 年：完整保留，可随时 reopen
├── 1-3 年：压缩归档（tar.gz），reopen 需手动解压缩
└── 3-5 年：标记为"待清理"，到期自动提示用户
> 5 年：自动清理（除非用户标记"永久保留"）

永久保留：在 project.md 添加 永久保留: true 字段。

---

Examples

→ 示例：用户说"归档 2025 年度审计项目"，系统校验状态 closed（如果未 closed 则要求先 close），执行归档。

→ 示例：用户说"强制归档 M&A alpha 项目"，系统用 --force 跳过状态检查。

---

注意事项

• 归档不可逆（除非 reopen）：归档后目录只读，修改产出物会被权限拒绝
• 凭证已清除：归档前自动检查 ~/.config/finance-skills/credentials/ 是否引用该项目 ID，如有则提示清理
• 跨年度审计关联：归档 2025-audit 时，询问"是否将本期发现自动同步到 2026-audit 的'历史上下文'段？"（年度审计连续性需求）