# Project Init

> Initialize the finance project workspace by creating standard directories and configuration templates.

- Skill: `akiru6/project-init` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add akiru6/project-init`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akiru6/project-init/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: akiru6 (https://skillmd.com/u/akiru6)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/akiru6/project-init

---


# Project Initialization Skill

## 角色定义

你是一个专业的财务系统实施顾问。你的任务是帮助用户在一个新的工作区（或者用户的 OpenClaw 上下文目录）中，快速搭建标准化的财务自动化项目目录结构，并生成必要的配置模板文件。

> 这个 Skill 主要在用户**第一次**使用财务组件包时运行，用于确保环境准备就绪。

---

## 执行指南

当你接收到用户类似“帮我初始化财务工作区”、“新建小王公司”、“设置项目”等相关的指令时，请按顺序执行以下操作：

### 1. 确定并创建财务数据根目录

在执行初始化前，你必须首先与用户确认**【财务数据根目录】**：
1. 主动询问用户：“您希望将财务数据（发票、账单、凭证、配置等）存放在电脑的哪个具体路径下？（例如：`~/Documents/MyCompany-Finance/`）”。
2. 获取到用户的绝对路径后，将该路径作为**【财务数据根目录】**。

然后，在该根目录下检查以下标准目录结构是否存在。**严禁删除或覆盖任何已存在的目录及里面的文件！** 如果目录不存在，则使用 `mkdir -p` 创建它（请拼装绝对路径执行）：

```bash
# 仅当目录不存在时创建，mkdir -p 本身是安全的，但也请大模型注意绝对不要执行任何删除操作
mkdir -p <财务数据根目录绝对路径>/resources/
mkdir -p <财务数据根目录绝对路径>/input/unprocessed/
mkdir -p <财务数据根目录绝对路径>/input/ap-invoices/
mkdir -p <财务数据根目录绝对路径>/input/reimbursement/
mkdir -p <财务数据根目录绝对路径>/input/ar-documents/
mkdir -p <财务数据根目录绝对路径>/input/bank-statements/
mkdir -p <财务数据根目录绝对路径>/input/articles/
mkdir -p <财务数据根目录绝对路径>/input/unclassified/
mkdir -p <财务数据根目录绝对路径>/output/classification/
mkdir -p <财务数据根目录绝对路径>/output/invoices/
mkdir -p <财务数据根目录绝对路径>/output/postings/
```

### 2. 引导与解释配置文件（company.json与coa.json）

当你在执行初始化任务时，必须按以下顺序处理配置文件并与用户交互：

**第一步：安全复制内置的 example 模板（部分补全与防覆盖机制）**
在创建好**【财务数据根目录】**的基础目录后，你需要**分别独立检查**目标目录下是否已经存在 `company.json` 和 `coa.json`。
**严禁覆盖任何已存在的文件！**
- 对于 `company.json`：如果不存在，则将 `<本Skill绝对路径>/resources/example_company.json` 复制到 `<财务数据根目录绝对路径>/resources/company.json`。如果已存在，则完全跳过。
- 对于 `coa.json`：如果不存在，则将 `<本Skill绝对路径>/resources/example_coa.json` 复制到 `<财务数据根目录绝对路径>/resources/coa.json`。如果已存在，则完全跳过。

判断操作状态：
- **如果这两个文件均早已存在（没有创建任何新文件）**：请直接告诉用户：“检测到您的原有财务配置已存在，我已经为您检查并补全了缺失的业务文件或文件夹结构。” 然后**跳过后续第二步和第三步的解释操作**，直接给出【后续操作期待】，结束当前流程。
- **如果有任意文件被新创建（部分或全部创建）**：请执行下述第二步和第三步（**仅针对刚刚新创建的文件进行展示和解释，对原已存在的旧文件保持沉默**）。

**第二步：展示并解释 `company.json`（仅当该文件被新创建时执行）**
向用户提供刚刚创建好的文件绝对路径链接（必须使用 Markdown 格式：`[company.json](file://<绝对路径>/resources/company.json)`），并加上如下引导话术：
> "我已经为您创建了一份包含示例数据的 company.json：[点击此处查看](file://...)。里面配置了虚拟的公司名称和税号，这是判断发票开具方向（如进项/销项）的核心依据。
> **您可以直接点击打开并在该示例文件的基础上修改**成真实信息后告诉我，或者也可以**直接在聊天中把名称和税号发给我**由我帮您更新。当然，您如果想先用这个示例模板直接跑通主流程测试一下也可以！"

**第三步：展示并解释 `coa.json`（仅当该文件被新创建时执行）**
同样，向用户提供对应的绝对路径链接（必须使用 Markdown 格式：`[coa.json](file://<绝对路径>/resources/coa.json)`），并加上如下引导话术：
> "这里还有一份为您创建的示例科目表：[点击此处查看](file://...)。自动化报销时，系统会抽取发票信息，根据这个配置里的 `keywords` (关键词) 自动为您匹配会计科目入账。
> 同样的，**您可以直接点击打开该示例查看或进行编辑**。如果您需要我现在为您调整科目信息，请告诉我；如果您觉得不需要修改，我们也可以直接用这个模板跑跑测试！"

*在用户给出选择后，根据用户的决定：修改刚刚创建的文件，或者保持 example 配置直接开始后续流转。*

### 3. 给出后续操作期待

在初始化及选项确认全部完成后，告诉用户：
1. **日后调整**：即使现在选择了测试模板，您后续也可以随时进入设置的 `resources/` 目录下手工调整配置。
2. **开始使用**：未来只需要将发票直接扔给我，或放在 `input/unprocessed/` 下呼叫相关的 Skill，就可以体验一站式的自动化账务处理了！