# write工作json

## 规则（Rules）

# 编写 work.json 规范

## 模板

```json
{
  "name": "工作项标识名（英文下划线）",
  "title": "工作项中文标题",
  "description": "一句话描述，50字以内",
  "version": "1.0.0"
}
```

## 字段说明

| 字段 | 必填 | 说明 |
|------|:----:|------|
| name | 是 | 工作项标识名，限英文和下划线，不允许中文、数字 |
| title | 是 | 工作项中文标题 |
| description | 是 | 一句话描述，50字以内 |
| version | 是 | 版本号，格式 x.x.x |
| group | 是 | 工作项所属分组名，限英文和下划线，不允许中文、数字 |

## 格式要求

- 所有字段名和字符串值必须用双引号包裹
- 数组各项之间用逗号分隔
- 最后一项后面不能有多余逗号

## 方法（Methods）

# 编写 work.json 方法

## 步骤

### 1. 确认信息
确认当前工作项的分组和标识名。

### 2. 逐项填写
按模板逐项填入：
- name：填入工作项标识名
- title：填入中文标题
- description：用一句话描述用途，控制在50字内
- version：填入初始版本号 1.0.0
- group：填入当前提示词的分组名

### 3. 检查格式
- 字段名是否用双引号
- 字符串值是否用双引号
- 数组各项之间是否有逗号
- 最后一项后面是否有多余逗号

## 技巧（Tips）

# 编写 work.json 技巧

## 1. 快速检查法

填完后从后往前逐项检查：先看最后一项有没有多余逗号，再看数组逗号，再看字段逗号。从后往前检查最容易发现多余逗号。

## 2. 描述卡字数

description 写完后默数一遍，超过50字就删修饰词。先写核心用途，再补限定词，不够位置就不补。

## 3. 容易踩的坑

- name 忘记改成当前标识名，直接复制了模板里的示例文本
- 引用顺序写成技巧在前、规则在后
- version 漏了中间的次版本号，写成 1.0 而不是 1.0.0