project-switch

加载上下文

首次执行： 读取 ../references/项目空间结构.md 了解 project.md 字段规范。

本 skill 本身不读项目内容，只设置 current_project_code 上下文变量。后续 skill 通过此变量定位项目目录。

---

/finance:project-switch — 切换项目上下文

把当前会话的"项目上下文"切到指定项目。所有后续 skill 操作都基于该项目的 project.md 中的阈值/范围/历史上下文。

命令格式

/finance:project-switch <project-code> [--show]

参数：

• <project-code>：项目代码（如 2026-audit-ic / Q2-2026-budget / tax-filing-2026 / m-and-a-deal-alpha）
• --show：只显示当前激活项目，不切换

操作步骤

步骤 1：定位项目目录

项目根目录 = ~/.config/finance-skills/projects/{project-code}/

如果目录不存在：

❌ 项目不存在: {project-code}

请使用 /finance:project-list 查看现有项目
或 /finance:project-new 创建新项目

步骤 2：校验 project.md

读取 {project-root}/project.md，校验：

• 必填字段齐全（项目类型/代码/负责人/周期/状态）
• YAML frontmatter 解析正确
• 状态 字段是合法值（planning / active / fieldwork / reporting / closed）

如果 project.md 损坏或缺字段：

⚠️ project.md 损坏或缺必填字段

请运行 /finance:project-repair {project-code} 自动修复
或手动编辑 ~/.config/finance-skills/projects/{project-code}/project.md

步骤 3：检查项目状态

读取 状态 字段：

状态	是否允许切换	警告
planning	✅	"项目仍在规划阶段，未开始执行"
active	✅	无
fieldwork	✅	无
reporting	✅	"项目在报告阶段，新发现可能不影响最终结论"
closed	⚠️	"项目已关闭，切换为只读模式"
archived	❌	"项目已归档，不可切换"

closed 状态允许切换但提示只读。

步骤 4：写入会话上下文

将以下信息注入会话上下文：

current_project = {
    code: "{project-code}",
    type: "{project-type}",
    root: "~/.config/finance-skills/projects/{project-code}/",
    status: "{状态}",
    started: "{开始日期}",
    next_milestone: "{下次关键日期}",
}

关键约束：同时只能激活一个项目。如果已激活另一个项目：

⚠️ 当前已激活项目: {old-code}

切换到 {new-code} 将丢弃 {old-code} 的会话状态（包括未保存的临时笔记）
确认切换吗？[y/N]

步骤 5：输出切换结果

成功切换时输出：

════════════════════════════════════════
✅ 已切换到项目: {project-code}

项目类型: {type}
负责人: {name}
周期: {period}
当前阶段: {stage}
上次活动: {last-activity}
下次关键日期: {next-milestone}
════════════════════════════════════════

项目根目录: ~/.config/finance-skills/projects/{project-code}/
所有 skill 操作的产出物将记录到此项目。

输入 /finance:project-status 查看项目详情
输入 /finance:project-list 切换到其他项目
════════════════════════════════════════