project-new

name	project-new
description	新建项目 — 创建项目目录 + project.md 模板，引导填写项目信息。 适用情形：开始一个新的财务周期项目（年度审计启动、Q2 预算审查立项、税务申报周期开启）。 触发词：新建项目、创建项目、立项、新财年审计、Q2 预算立项、税务申报周期。 核心：项目类型选择 → 代码生成 → project.md 模板填充 → 关联场景激活。
argument-hint	[--type <类型>] [--code <代码>] [--name <名称>] [--owner <负责人>]
risk_level	medium
last_reviewed	"2026-06-14T00:00:00.000Z"
version	1.0.0

加载上下文

读取 ../references/项目空间结构.md 了解目录规范和 project.md 模板。

---

/finance:project-new — 新建项目

创建 ~/.config/finance-skills/projects/{code}/ 目录和 project.md 文件。

命令格式

/finance:project-new [--type <类型>] [--code <代码>]

可选参数跳过交互直接创建。

项目类型

类型	用途	默认代码格式
annual-audit	年度审计（内控/财务）	{YYYY}-audit-ic
budget-review	季度/年度预算审查	{Q}{YYYY}-budget
tax-filing	税务申报周期	tax-filing-{YYYY}
m-and-a	M&A 尽调/估值/整合	m-and-a-{deal-code}
financing	融资项目（银团/债券/股权）	financing-{YYYY-MM}
internal-control	内控设计/整改	ic-{scope}-{YYYY}
other	其他（自定义）	{name}-{YYYY-Q}

交互流程

步骤 1：选择项目类型

选择项目类型：
1. annual-audit   - 年度审计（内控/财务）
2. budget-review  - 季度/年度预算审查
3. tax-filing     - 税务申报周期
4. m-and-a        - M&A 尽调/估值/整合
5. financing      - 融资项目
6. internal-control - 内控设计/整改
7. other          - 其他（自定义）

步骤 2：输入项目代码

请输入项目代码（或回车使用默认）：
默认: {自动按类型生成}

代码必须：
- 全小写字母/数字/-
- 不含空格和特殊字符
- 1-32 字符
- 同一类型内唯一

示例：2026-audit-ic / Q3-2026-budget / m-and-a-deal-alpha

冲突检查：如果代码已存在，报错并要求重新输入。

步骤 3：填写项目基础信息

按 references/项目空间结构.md 的 project.md 模板，依次询问：

Q1: 项目名称（用于显示）？
    > 2026 年度内部控制审计

Q2: 项目负责人？
    > CFO 张三

Q3: 项目周期？
    起始日期 (YYYY-MM-DD): 2026-01-01
    结束日期 (YYYY-MM-DD): 2026-12-31

Q4: 初始阶段？
    1. planning   - 规划
    2. active     - 启动
    3. fieldwork  - 现场执行
    默认: planning

Q5: 项目范围描述（可空）？
    > 总部 + 华东区域（工厂/仓库）

Q6: 排除范围（可空）？
    > 海外子公司（独立审计）

步骤 4：选择激活场景

选择该项目涉及的财务场景（可多选）：

☑ annual-audit      - 年度审计
☐ budget-review     - 预算审查
☐ tax-filing        - 税务申报
☐ internal-audit    - 内部审计
☐ internal-control  - 内部控制
☐ m-and-a           - 并购
☐ fx-risk           - 外汇
☐ treasury-management - 资金
☐ board-reporting   - 董事会汇报
☐ ... 其他场景

默认根据项目类型自动勾选（如 annual-audit 自动勾选 internal-audit + internal-control）

场景选择会写入 project.md 的 关联场景 字段，影响后续 skill 自动激活哪些。

步骤 5：设置关键阈值

按项目类型显示必填阈值：

annual-audit 类型必填：

重大缺陷门槛：[默认 500 万元]
重要缺陷门槛：[默认 100 万元]
SOX 控制总数：[可空]

budget-review 类型必填：

预算偏差预警阈值：[默认 ±5%]
超支审批层级：[默认 财务总监]

m-and-a 类型必填：

交易规模：[必填，万元]
目标公司：[必填]

其他类型：可跳过此步。

步骤 6：创建目录 + 文件

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

创建以下结构：
{code}/
├── project.md                  ← 写入用户填写的信息
├── scope.md                    ← 空模板（用户后续填）
├── timeline.md                 ← 空模板
├── findings/                   ← 空目录
├── control-testing/            ← 空目录（仅 annual-audit/internal-audit）
├── documents/                  ← 空目录
└── audit-trail.log             ← 空文件，记录所有 skill 操作

步骤 7：输出创建结果

════════════════════════════════════════
✅ 项目创建成功！

代码: {code}
类型: {type}
名称: {name}
负责人: {owner}
周期: {start} ~ {end}
当前阶段: {status}
关联场景: {N} 个

项目目录: ~/.config/finance-skills/projects/{code}/
════════════════════════════════════════

下一步：
  输入 /finance:project-switch {code} 切换到该项目
  输入 /finance:project-status {code} 查看详情
  输入 /finance:project-list 看所有项目
════════════════════════════════════════

---

实现机制

project.md 模板（写入项目根目录）

参考 references/项目空间结构.md 的完整模板。

最小必填结构：

---
code: {code}
type: {type}
created: {YYYY-MM-DD}
status: {status}
owner: {owner}
---

# Project: {name}

## 基本信息
- **项目类型**: {type}
- **项目代码**: {code}
- **负责人**: {owner}
- **项目周期**: {start} ~ {end}
- **当前阶段**: {status}

## 关联场景
{勾选场景列表}

## 关键阈值
{按类型填充}

## 关联产出物
（暂无）

## 历史上下文
（首次创建，无）

## Agent 备注
（Agent 在项目执行过程中记录的临时状态）

---

Examples

→ 示例：用户说"启动 2026 年度内控审计"，系统应选择 annual-audit 类型，代码默认 2026-audit-ic，询问负责人/周期/范围，生成 project.md。

→ 示例：用户说"我们有个 M&A 项目代号 alpha，开始尽调"，系统应选择 m-and-a 类型，代码 m-and-a-deal-alpha，询问交易规模和目标公司。

→ 示例：用户说"用命令行直接创建：/finance:project-new --type budget-review --code Q3-2026-budget --name 'Q3 2026 预算审查' --owner '财务经理王五'"，跳过交互直接创建。

---

注意事项

• 覆盖保护：如果代码已存在，拒绝覆盖，要求用户用 --force 或换代码
• 凭证隔离：项目目录不存放 API 凭证（统一在 ~/.config/finance-skills/credentials/）
• 跨平台路径：使用 ~/.config/ 跨平台路径，不要 hardcode /Users/xxx
• 删除项目：不提供删除入口（防止误删历史项目）。如需"删除"，建议用 project-archive 归档