Chinese Name Craft

SKILL.md

---
name: chinese-name-craft
description: >
  基于中国传统命理学（八字、五行、姓名学）为新生儿或成人起名/改名的专业工作流。
  当用户提到起名、取名、改名、八字起名、五行起名、姓名学、命理、
  新生儿取名、宝宝起名、周易起名时使用此 skill。
  支持完整流程：信息收集、八字排盘、五行分析、大运排列、忌用字收集、
  候选名字生成（字义、音律、三才配置、五格数理、生肖喜忌）、综合点评。
---

# 传统起名工作流

基于山东瑞福圆起名策划有限公司的起名方法论，完整覆盖八字命理分析与姓名学数理分析。

## 工作流总览

1. 收集信息
2. 八字排盘
3. 五行分析
4. 大运排列
5. 命局点评
6. 收集忌用字
7. 生成候选名字
8. 逐名分析（字义/音律/数理/三才/生肖）
9. 姓名总评
10. 生成 Word 文档

## 第一步：收集信息

向用户收集以下信息（可分多次提问，不要一次问太多）：

- **姓氏**：宝宝姓什么（单姓/复姓）
- **性别**：男/女
- **出生日期**：公历年月日
- **出生时间**：精确到时辰（若不知可省略，但会影响八字准确性）
- **忌用字**：用户不希望出现在名字中的字（如家族长辈用字等）
- **其他偏好**：对名字风格的期望（文雅/大气/古风等），可选

## 第二步：八字排盘

根据出生日期时间排出四柱八字（年柱、月柱、日柱、时柱），并标注：

- 天干地支及其五行属性
- 生肖
- 纳音
- 八字十神（偏印、偏官、正印、正官等）

> **排盘参考**：参见 [references/bazi-wuxing.md](references/bazi-wuxing.md) 中的天干地支对照表与十神推算规则。

## 第三步：五行分析

统计八字中各五行的数量，判断旺衰，确定需补五行。

分析原则：
- 日元（日柱天干）代表命主自身
- 判断日元在局中的旺衰状态
- 确定是顺势而为还是需要补抑
- 给出需补的五行属性

## 第四步：大运排列

排列命主的大运（每10年一运），包含：

- 起运年龄与交运时间
- 十神序列
- 大运天干地支
- 实岁对应
- 起始年份

## 第五步：命局专家点评

基于八字格局，对命主各方面进行综合分析：

1. **性格特点** - 五行偏旺带来的性格倾向、需要注意的人际交往问题
2. **事业方向** - 适合的行业属性（如火/土属性行业）、有利发展方向
3. **财运分析** - 财星在局中的表现、投资注意事项
4. **婚姻感情** - 财星/官星状况、适宜婚配属相、不利属相
5. **健康提示** - 五行偏旺对应的脏腑易损部位、需要关注的年龄段
6. **有利要素** - 有利方向、颜色、数字、月份、交友特征
7. **人生提示** - 综合性的人生建议

## 第六步：收集忌用字

在生成候选名字前，确认用户的忌用字列表。

## 第七步：生成候选名字

生成 3 组候选名字。每组名字需要满足：

1. **五行补益**：名字用字的五行属性能补命局所需
2. **生肖喜忌**：优先使用生肖喜用的偏旁部首
3. **音律协调**：声调搭配有起伏，避免同声调连用
4. **字形美观**：笔画繁简搭配合理
5. **寓意积极**：字义吉祥、文化内涵丰富
6. **不含忌用字**

## 第八步：逐名详细分析

对每组候选名字进行以下分析（详见 [references/name-study.md](references/name-study.md)）：

### 字义原理
逐字解释字义出处（经典文献引用）。

### 经意原理
每个字在姓名学中的吉凶含义。

### 音律分析
标注每个字的拼音与声调（阴平/阳平/上声/去声）。

### 五格数理分析
计算并分析：
- **天格**（姓氏笔画+1 或 复姓两字相加）
- **人格**（姓末字+名首字笔画之和）
- **地格**（名字各字笔画之和，单名+1）
- **外格**（天格+地格-人格，单姓单名固定为2）
- **总格**（姓名所有字笔画总和）

每个格的数理需查对吉凶含义。

### 三才配置
由天格、人格、地格的五行组合得出，判断吉凶。

### 创意定位
说明名字与生肖喜用部首的关联，以及整体寓意的创意解读。

## 第九步：姓名总评

对所有候选名字进行横向比较与综合评价：

- 字音方面：声调韵律、朗朗上口程度
- 字形方面：结构搭配、书写美观度
- 字意方面：寓意深度、文化内涵
- 三才配置：是否为大吉
- 数理方面：各格是否均为吉数
- 五行补益：是否充分补足命局所需五行

## 第十步：生成 Word 文档

分析完成后，将全部结果组装为 JSON 并调用脚本生成格式化的 Word 文档。

### JSON 数据组装

按照 [references/output-template.md](references/output-template.md) 中的 JSON schema 组装数据，包含：
title、greeting、basic_info、bazi、wuxing_stats、need_wuxing、expert_comment、names 数组、summary、disclaimer。

### 调用脚本

```bash
python scripts/generate_doc.py <input.json> [output.docx]
```

- 第一个参数：JSON 文件路径
- 第二个参数（可选）：输出 .docx 路径，省则自动生成（基于 father_name/mother_name/child_label）

脚本依赖 `python-docx`，首次运行会自动安装。

## 注意事项

1. 八字排盘与五行分析是整个起名流程的基石，务必准确
2. 五格数理的笔画计算以繁体字为准（康熙字典笔画）
3. 三才配置的五行由天格、人格、地格的个位数决定（1-2属木，3-4属火，5-6属土，7-8属金，9-0属水）
4. 生肖喜忌仅为民俗文化参考，不应过度依赖
5. 最终名字应以用户满意度为导向，命理分析仅供参考
6. 以上解释出自《易经》中《姓名学》理论，仅作探讨与参考