# Fortune Teller

> 算命综合推算系统，融合紫微斗数、生辰八字、盲派、南北派四大派系，进行交叉验证的综合命理推算。触发条件：算命、八字算命、紫微斗数、命理分析、算一卦、看命

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

---


# FortuneTeller 多代理版 v2.6.0

> 融合紫微斗数、生辰八字、盲派、南北派四大派系的综合命理推算系统

## 版本说明

**v2.6.0（2026-08-03）- 梁湘润流年论版**
- ✅ 新增梁湘润流年六字真言（冲=动、合=缠、刑=烦、会=成）作为流年分析第一层体感判断
- ✅ 新增财官判吉凶规则（财官被冲=破财丢官，被合=得财升职）作为流年第二层事件判断
- ✅ 新增天干地支分工规则（天干=表象，地支=实质）
- ✅ 新增冲合大运vs冲合原局的新事旧事区分
- ✅ 流年分析重构为三层递进框架（六字真言→财官判吉凶→做功通堵）
- ✅ 验证专家新增第五层"流年解读合规性验证"
- ✅ 盲派专家流年应期章节补充六字真言解读语言

**v2.5.0（2026-07-29）- 方法论驱动版**
- ✅ 新增 `prompts/methodology.md` 七步推演法操作手册（盲派实战主线）
- ✅ 新增 `prompts/enhanced/zuogong-analysis.md` 做功链路专项模板
- ✅ 重构盲派专家三维定位顺序：宾主定位→做功路径→调候判定
- ✅ 八字/盲派分析前置"七步推演法速推"，做功主线优先于用神喜忌
- ✅ 流年模板强制三层叠加（大运背景→做功通道变化→通/堵判定→应期落点）
- ✅ 验证专家新增第四层"做功链路一致性验证"

**v2.4.0（2026-03-19）- 多代理协作版**
- ✅ 重构为多代理协作架构（7个专业子代理）
- ✅ 三层验证机制（计算验证→LLM验证→交叉验证）
- ✅ 三层Review流程（准确性→一致性→可读性）
- ✅ 充分利用LLM推理能力，减少JavaScript计算负担
- ✅ 输出更专业更深入的命理分析报告

**v2.3.0（2026-03-17）- 一键生成版**
- ✅ 自动生成PNG信息图（横版1920x1080 + 竖版1080x1920）
- ✅ 支持中文数字日期解析（农历十月初六、正月初一等）
- ✅ 完全自动化流程，无需用户中途干预
- ✅ 文字报告 + 图片可视化，双输出模式

## 核心架构

### 从单脚本到多代理协作

**v2.3.0 架构**:
```
JavaScript计算引擎 → AI主对话分析 → 输出报告
```

**v2.4.0 多代理架构**:
```
Phase 1: 输入解析专家 → Review 1（数据完整性）
Phase 2: 三大派系推算（并行）→ Review 2（推算准确性）
   ├─ 八字专家 → 四柱推算
   ├─ 紫微专家 → 斗数分析
   └─ 盲派专家 → 口诀推演
Phase 3: 三层验证专家 → Review 3（验证完整性）
Phase 4: 报告撰写专家 → Review 4（报告质量）
Phase 5: 最终Review（整体一致性）
Phase 6: 生成PNG → 输出完整报告
```

**核心优化**：每个子代理完成后立即Review，确保质量关卡前置，问题早发现早解决。

**注**：南北派专家暂时屏蔽，待后续优化后再启用。

### 子代理配置

系统包含6个专业子代理，配置文件位于 `agents/` 目录：

1. **输入解析专家** (`input-parser-specialist.md`)
   - 从自然语言中提取姓名、性别、日期、时辰、地点
   - 支持多种日期格式（公历、农历、干支）
   - 支持12时辰表达方式
   - 支持40+主要城市坐标匹配

2. **八字专家** (`bazi-specialist.md`)
   - 四柱排盘（年柱、月柱、日柱、时柱）
   - 五行分析（强弱、缺失、流通）
   - 十神配置（性格、关系、事业）
   - 格局判断（正格、从格、化格）
   - 大运计算（起运年龄、大运排列）

3. **紫微专家** (`ziwei-specialist.md`)
   - 十二宫位配置
   - 十四主星分析
   - 四化飞星推演
   - 大限流年预测

4. **盲派专家** (`mengpai-specialist.md`)
   - 三维定位法（格局-流通-调候）
   - 墓库能量开关理论
   - 十神精析系统
   - 传统口诀应用
   - 神煞计算
   - 流年应期
   - 趋吉避凶建议

5. **验证专家** (`validation-specialist.md`)
   - 第一层：计算验证（排盘准确性）
   - 第二层：LLM逻辑验证（因果一致性）
   - 第三层：派系交叉验证（结论一致性）

6. **报告撰写专家** (`report-writer-specialist.md`)
   - 整合所有推演结果
   - 生成结构化Markdown报告
   - 专业术语通俗化
   - 包含置信度评估

**注**：南北派专家暂时屏蔽，待后续优化。

### Review流程（关键优化）

**核心理念**：每个子代理完成后立即Review，质量关卡前置，问题早发现早解决。

**Review 1**（Phase 1完成后）：输入数据完整性检查
- 检查姓名、性别、日期、时辰、地点是否完整提取
- 验证日期格式转换是否正确（农历→公历）
- 验证时辰解析是否准确（12时辰→24小时制）
- 验证地点坐标匹配是否正确
- **不通过**：返回重新提取，不允许进入Phase 2

**Review 2**（Phase 2完成后）：推算准确性检查
- 检查八字四柱排盘是否正确
- 检查五行统计是否准确
- 检查紫微宫位配置是否合理
- 检查各派系理论应用是否得当
- 验证计算结果与理论是否一致
- **不通过**：指出错误，要求重新推算

**Review 3**（Phase 3完成后）：验证完整性检查
- 检查三层验证是否全部完成
- 检查验证逻辑是否清晰
- 检查问题发现是否充分
- 检查置信度评估是否合理
- **不通过**：要求补充验证内容

**Review 4**（Phase 4完成后）：报告质量检查
- 检查报告结构是否完整
- 检查内容是否全面覆盖所有派系
- 检查专业术语是否准确
- 检查逻辑是否连贯
- 检查是否有遗漏或错误
- **不通过**：要求修改报告内容

**Review 5**（最终Review）：整体一致性与可读性
- 检查整个报告的一致性
- 检查派系结论是否矛盾
- 检查语言表达是否自然流畅
- 检查是否有AI痕迹
- 检查置信度标注是否准确
- **不通过**：要求优化表达

**Review专家配置**：
- 可由主代理兼任，或调用独立的Review子代理
- 每次Review输出结构化结果：`{"status": "pass/fail", "issues": [], "suggestions": []}`

## 使用说明

### 用户输入

用户用自然语言输入基本信息，例如：

```
帮我算命，张三 男 2025年3月15日 下午2点 北京
```

**必需信息（全部必填，不得省略）：**
- 姓名
- 性别（男/女）
- 出生日期（2025年3月15日 或 农历十月初六）
- 出生时辰（X点 或 上午X点、下午X点、晚上X点）
- 出生地点（北京、上海、广州等）

**⚠️ 重要：所有信息必须由用户提供，不允许使用默认值！**
如果用户没有提供任何一项，应反复询问，直到获取所有信息。

### AI工具执行流程

```dot
digraph fortune_teller_flow {
    rankdir=TB
    node [shape=box, style=filled]

    start [label="用户输入自然语言", fillcolor="#c8e6c9"]
    phase1 [label="Phase 1: 输入解析专家", fillcolor="#bbdefb"]
    review1 [label="Review 1: 数据完整性", fillcolor="#fff9c4"]
    decision1 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]

    phase2 [label="Phase 2: 四大派系并行推算", fillcolor="#bbdefb"]
    review2 [label="Review 2: 推算准确性", fillcolor="#fff9c4"]
    decision2 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]

    phase3 [label="Phase 3: 三层验证专家", fillcolor="#bbdefb"]
    review3 [label="Review 3: 验证完整性", fillcolor="#fff9c4"]
    decision3 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]

    phase4 [label="Phase 4: 报告撰写专家", fillcolor="#bbdefb"]
    review4 [label="Review 4: 报告质量", fillcolor="#fff9c4"]
    decision4 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]

    final_review [label="Review 5: 整体一致性", fillcolor="#fff9c4"]
    decision5 [label="通过？", shape=diamond, fillcolor="#f8bbd0"]

    phase6 [label="Phase 6: 生成PNG", fillcolor="#bbdefb"]
    output [label="输出完整报告", fillcolor="#f8bbd0"]

    start -> phase1
    phase1 -> review1
    review1 -> decision1
    decision1 -> phase2 [label="是"]
    decision1 -> phase1 [label="否，重新提取"]

    phase2 -> review2
    review2 -> decision2
    decision2 -> phase3 [label="是"]
    decision2 -> phase2 [label="否，重新推算"]

    phase3 -> review3
    review3 -> decision3
    decision3 -> phase4 [label="是"]
    decision3 -> phase3 [label="否，补充验证"]

    phase4 -> review4
    review4 -> decision4
    decision4 -> final_review [label="是"]
    decision4 -> phase4 [label="否，修改报告"]

    final_review -> decision5
    decision5 -> phase6 [label="是"]
    decision5 -> phase4 [label="否，优化表达"]

    phase6 -> output
}
```

**详细步骤**：

**步骤1**: AI工具识别意图
- 用户: "帮我算命，张三 男 2025年3月15日 下午2点 北京"
- AI识别: 这是算命请求，触发 fortune-teller skill

**步骤2**: Phase 1 - 输入解析 + Review 1
- 调用输入解析专家子代理
- 提取结构化数据（姓名、性别、日期、时辰、地点）
- **立即Review 1**：检查数据完整性
  - 姓名是否提取？性别是否识别？
  - 日期格式转换是否正确？
  - 时辰解析是否准确？
  - 地点坐标是否匹配？
- 如果Review不通过：返回重新提取，不允许进入Phase 2

**步骤3**: Phase 2 - 四大派系推算 + Review 2
- 并行调用4个子代理：
  - 八字专家 → 生成八字分析
  - 紫微专家 → 生成紫微分析
  - 盲派专家 → 生成盲派分析
  - 南北派专家 → 生成南北派对比
- **立即Review 2**：检查推算准确性
  - 八字四柱是否正确？
  - 五行统计是否准确？
  - 理论应用是否得当？
  - 计算结果是否一致？
- 如果Review不通过：指出错误，要求重新推算

**步骤4**: Phase 3 - 三层验证 + Review 3
- 调用验证专家子代理
- 第一层：计算验证
- 第二层：LLM逻辑验证
- 第三层：派系交叉验证
- 生成置信度评分
- **立即Review 3**：检查验证完整性
  - 三层验证是否全部完成？
  - 验证逻辑是否清晰？
  - 问题发现是否充分？
  - 置信度评估是否合理？
- 如果Review不通过：要求补充验证内容

**步骤5**: Phase 4 - 报告撰写 + Review 4
- 调用报告撰写专家子代理
- 整合所有推演结果
- 生成结构化Markdown报告
- **立即Review 4**：检查报告质量
  - 报告结构是否完整？
  - 内容是否全面覆盖？
  - 术语是否准确？
  - 逻辑是否连贯？
- 如果Review不通过：要求修改报告内容

**步骤6**: Review 5 - 整体一致性与可读性
- 检查整个报告的一致性
- 检查派系结论是否矛盾
- 检查语言表达是否自然流畅
- 检查是否有AI痕迹
- 检查置信度标注是否准确
- 如果Review不通过：要求优化表达

**步骤7**: Phase 6 - 生成PNG
- 自动调用 `/infographic-generator`
- 生成横版（1920x1080）和竖版（1080x1920）信息图

**步骤8**: 输出最终报告
- Markdown报告（8000-12000字）
- PNG信息图（横版+竖版）

### 输出内容

**完整命理分析报告**（Markdown格式）：

1. **基本信息** - 姓名、性别、出生日期、真太阳时
2. **八字排盘** - 四柱、五行、十神、神煞
3. **紫微斗数** - 十二宫、主星、四化、大限
4. **综合分析** - 性格、事业、财运、感情、健康
5. **大运流年** - 大运走势、流年提醒
6. **趋吉避凶** - 有利因素、注意事项
7. **验证与置信度** - 三层验证结果、置信度评分
8. **免责声明** - 仅供参考，娱乐而已

**PNG信息图**：
- 横版（1920x1080）：适合博客、报告
- 竖版（1080x1920）：适合手机分享、小红书

## 文件输出规范

**⚠️ 重要规则：所有文件输出必须严格遵守以下目录规范**

### 目录结构

```
fortune-teller/
├── agents/         # 子代理配置目录（新增）
│   ├── input-parser-specialist.md
│   ├── bazi-specialist.md
│   ├── ziwei-specialist.md
│   ├── mengpai-specialist.md
│   ├── nanbeipai-specialist.md
│   ├── validation-specialist.md
│   └── report-writer-specialist.md
│
├── lib/            # 计算引擎库（保留）
│   ├── bazi-calculator.js
│   ├── ziwei-calculator.js
│   └── ...
│
├── prompts/        # 提示词模板（保留）
│   ├── ziwei-analysis.md
│   ├── bazi-analysis.md
│   └── ...
│
├── output/         # 正式输出目录
│   ├── [姓名]_命盘数据.json
│   ├── [姓名]_完整命理报告.md
│   ├── [姓名]_命盘信息图_横版.png
│   └── [姓名]_命盘信息图_竖版.png
│
├── test/           # 测试输出目录
└── backup/         # 备份目录
```

## 三层验证机制

### 第一层：计算验证

**目标**: 确保排盘计算的准确性

**验证内容**：
- 八字四柱准确性（年柱、月柱、日柱、时柱）
- 五行统计准确性（数量、缺失）
- 神煞计算准确性（天乙贵人、桃花、驿马等）
- 紫微宫位配置准确性（十二宫、主星）

**方法**：调用计算引擎验证

### 第二层：LLM逻辑验证

**目标**: 确保分析推理的合理性

**验证内容**：
- 因果关系验证（五行生克逻辑链）
- 结论依据验证（判断是否有理论支撑）
- 矛盾检测（不同分析之间是否矛盾）
- 过度推断检测（是否有超出依据的结论）

**方法**：LLM分析推理

### 第三层：派系交叉验证

**目标**: 确保多派系结论的一致性

**验证内容**：
- 八字 vs 紫微（结论是否一致）
- 八字 vs 盲派（口诀是否支持）
- 南派 vs 北派（差异是否可解释）
- 置信度评估（综合评分）

**方法**：派系对比分析

## 技术架构

### 计算引擎（lib/）

保留现有的JavaScript计算引擎，用于：

1. **精确计算**
   - 真太阳时计算
   - 八字排盘计算
   - 紫微斗数排盘
   - 大运流年计算

2. **被Agent调用**
   - 子代理可以通过Bash工具调用计算引擎
   - 例如：`node lib/bazi-calculator.js --date "2025-03-15" --time 14`

3. **验证基准**
   - 为验证专家提供计算基准
   - 确保LLM推理不偏离理论

### 提示词库（prompts/）

保留现有的提示词模板，用于：

1. **操作手册（最高优先）**
   - `prompts/methodology.md` —— **所有子代理必须优先读取**，七步推演法完整操作规程
   - `prompts/enhanced/zuogong-analysis.md` —— 做功链路专项模板（功神识别/五档效率/反做功）

2. **子代理参考**
   - 提供专业知识库
   - 提供分析方法论（bazi/mengpai/ziwei 等）

3. **动态加载**
   - 子代理可以读取prompts/*.md
   - 作为背景知识参考

> ⚠️ **关键约束**：任何派系分析（八字/盲派/紫微）都必须先走 `methodology.md` 的七步推演法
> 步骤1-3 锁定"核心做功路径"，再进入各自补充分析。做功主线优先级高于传统用神喜忌。

### 子代理系统（agents/）

新增的子代理配置文件，定义：

1. **角色定位** - 每个子代理的专业领域
2. **核心能力** - 擅长的分析维度
3. **输入输出** - 结构化的JSON格式
4. **工作流程** - 分析步骤
5. **质量标准** - 输出要求

## Token消耗与时间预估

**总Token消耗**: ~28,000 tokens（含5次Review）

**各阶段消耗**：
- Phase 1（输入解析）: ~2,000 tokens
- Review 1: ~500 tokens
- Phase 2（四大派系）: ~10,000 tokens（并行）
- Review 2: ~1,500 tokens
- Phase 3（验证）: ~3,000 tokens
- Review 3: ~800 tokens
- Phase 4（报告撰写）: ~4,000 tokens
- Review 4: ~1,000 tokens
- Review 5（最终）: ~1,200 tokens
- Phase 6（生成PNG）: ~500 tokens
- 其他开销: ~3,500 tokens

**总时间预估**: 3-5分钟

**Review时间占比**：约20-25%的时间用于Review，但可以避免后期返工，整体效率更高。

## 核心优势

### 1. 专业化分工
- 每个派系有专门的Agent
- 充分利用LLM推理能力
- 输出更专业更深入

### 2. 质量保证
- 三层验证机制
- 三层Review流程
- 置信度评分
- 八字验证

### 3. 可扩展性
- 新增派系只需添加配置文件
- 无需修改JavaScript代码
- 易于维护和优化

### 4. 参考wechat-article-writer成功模式
- 相同的多代理架构
- 相同的自然语言指导
- 相同的Review机制

## 注意事项

1. **日期格式**：支持农历和阳历，系统会自动转换并验证
2. **真太阳时**：提供出生地可以获得更准确的时辰
3. **验证机制**：系统会进行三层验证确保准确
4. **大运流年**：分析会考虑对应的时代背景
5. **置信度**：报告会明确标注置信度评分

## 更新日志

- v2.4.0: 多代理协作版，7个子代理，三层验证，三层Review
- v2.3.0: 一键生成版，自动生成PNG信息图
- v2.2.0: 重大改进版，文件输出规范，优化提示词
- v2.1.0: 完整增强版，三层验证，增强报告生成器
- v1.0.0: 初始版本，包含四大派系排盘和基本分析