project-switch

name	project-switch
description	项目切换 — 加载指定项目的 project.md 上下文到当前会话。后续所有 skill 操作 都在该项目上下文中执行（产出物写到 projects/{code}/，引用项目阈值）。 适用情形：开始/恢复一个财务项目（年度审计、Q2 预算审查、税务申报周期、M&A 尽调）时执行。 触发词：切换项目、进入项目、恢复项目、加载项目上下文、switch to project。 核心：单例项目上下文（同时只能激活一个项目），所有 skill 引用 ~/.config/finance-skills/projects/{code}/project.md。
argument-hint	[<project-code>] [--show]
risk_level	low
last_reviewed	"2026-06-14T00:00:00.000Z"
version	1.0.0

加载上下文

首次执行： 读取 ../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 切换到其他项目
════════════════════════════════════════

---

Examples

→ 示例：用户说"切换到 2026 年度内部控制审计项目"，系统应切换到 2026-audit-ic，加载该项目的 project.md，输出项目摘要。

→ 示例：用户说"我要开始做 Q2 预算审查"，系统应先检查 Q2-2026-budget 是否存在，存在则切换，不存在则提示用 /finance:project-new 创建。

→ 示例：用户说"现在做的是哪个项目"，系统应使用 --show 模式，只输出当前激活项目信息。

---

与其他 skill 的协作

切换项目后，以下 skill 会自动使用项目上下文：

Skill	项目上下文的用途
/internal-audit:control-testing	把控制测试底稿写入 projects/{code}/control-testing/
/month-end-close:*	把月度关账报告写入 projects/{code}/close-{YYYY-MM}/
/m-and-a:*	把尽调材料写入 projects/{code}/due-diligence/
/board-reporting:*	把董事会材料写入 projects/{code}/board-{YYYY-Q}/

未切换项目时调用：上述 skill 仍可执行（不强制依赖项目），但会提示"未指定项目上下文，产出物将写入默认目录 ~/.config/finance-skills/scratch/"。

---

关闭项目

要关闭当前项目，使用 /finance:project-archive {project-code} 或修改 project.md 的 状态 字段。

切换到 closed 状态后：

• 项目目录变为只读
• 不再出现在 /finance:project-list 的"活跃"列表
• 可通过 /finance:project-switch {code} 重新打开（会自动恢复 closed 状态）

---

注意事项

• 无项目 ≠ 不能用 skill。基础 skill（如 /tax-filing:vat-monthly-declare）可不依赖项目上下文运行
• 切换不影响数据：所有项目文件独立保存，切换只是"激活焦点"
• 多任务并发：项目是单例的。如果同时跟踪多个项目（如年度审计 + Q2 预算），在两个会话窗口分别切换，不要在同一会话混用
• 凭证不在项目目录：API 凭证统一在 ~/.config/finance-skills/credentials/，不在项目目录内（避免泄露）