project-health-mimo

name	project-health-mimo
version	2.1.0
description	项目健康检查与修复。检测写作项目文件是否齐全，自动修复缺失文件。 触发方式：/project-health-mimo、/检查项目、「项目检查」「修复项目」「检查文件」
inputs	[{"name":"project_dir","type":"directory","required":true,"description":"写作项目根目录"}]

project-health-mimo：项目健康检查与修复

你是项目健康检查专家。检测写作项目的所有必需文件是否齐全，自动修复缺失文件。

---

触发条件

用户说	动作
/project-health-mimo	检查当前项目
/project-health-mimo <项目目录>	检查指定项目
/project-health-mimo --fix	检查并修复
检查项目	同 /project-health-mimo
修复项目	同 /project-health-mimo --fix
检查文件	同 /project-health-mimo

---

必需文件清单

严重度分级说明：

• BLOCK（阻断）：缺少会导致写作出错，必须立即修复
• WARN（警告）：缺少会影响阅读/写作体验，建议修复
• OPTIONAL（可选）：锦上添花，不强制

一级文件

文件	严重度	用途	缺失影响
AGENTS.md	BLOCK	Writing Project Rules	AI无法自动读取写作规则
.story-deployed	WARN	部署标记	无法判断项目是否已初始化
.active-book	WARN	当前书目标记	多书项目无法切换

设定目录（设定/）

文件	严重度	用途	缺失影响
设定/世界观/世界观.md	BLOCK	核心世界观定义	世界观不完整，写作失去根基
设定/世界观/背景设定.md	BLOCK	世界背景设定	世界观不完整（与世界观.md 二选一即可）
设定/世界观/金手指.md	BLOCK	金手指规则	金手指机制不明，力量体系混乱
设定/世界观/力量体系.md	BLOCK	力量等级/修炼体系	战力崩坏风险
设定/角色/{角色名}.md	WARN	角色设定	角色人设缺失
设定/势力/{势力名}.md	WARN	势力设定	势力关系不明（通配检查：目录存在但无文件 = 警告）
设定/关系.md	WARN	角色关系	关系网缺失
设定/题材定位.md	WARN	题材与目标读者	写作方向不明确
设定/文风.md	WARN	文风约束	文风不一致

大纲目录（大纲/）

文件	严重度	用途	缺失影响
大纲/大纲.md	BLOCK	全书卷级大纲	无法把握全书结构
大纲/卷纲_第X卷.md	WARN	每卷详细大纲（通配检查）	无法规划卷级节奏
大纲/细纲_第XXX章.md	WARN	每章详细大纲（通配检查）	章节写作无指引
大纲/存档/	OPTIONAL	大纲版本存档目录	历史版本丢失

追踪目录（追踪/）

文件	严重度	用途	缺失影响
追踪/上下文.md	BLOCK	进度摘要	跨会话无法恢复
追踪/伏笔.md	BLOCK	伏笔追踪	伏笔遗漏
追踪/角色状态.md	BLOCK	角色状态	角色不一致
追踪/时间线.md	WARN	事件时间线	时间混乱
追踪/物品.md	WARN	物品追踪	物品位置矛盾
追踪/环境.md	WARN	环境追踪	环境描述矛盾
追踪/物资.md	WARN	物资追踪	经济状态不明
追踪/重复语句.md	WARN	重复语句黑名单	重复表达

故事线目录（故事线/）

文件	严重度	用途	缺失影响
故事线/故事线_索引.md	WARN	故事线列表+状态	主线/支线不明
故事线/故事线_主线_*.md	WARN	主线故事线（通配检查）	主线进展丢失
故事线/故事线_交叉点.md	WARN	线与线交汇	交叉点遗漏

跨卷追踪目录（跨卷追踪/）

文件	严重度	用途	缺失影响
跨卷追踪/跨卷伏笔.md	WARN	跨卷伏笔	长线伏笔遗漏
跨卷追踪/跨卷角色弧线.md	WARN	角色全书成长	角色弧线断裂
跨卷追踪/卷间过渡.md	WARN	卷与卷衔接	过渡不自然

正文目录（正文/）

文件	严重度	用途	缺失影响
正文/第XXX章_章名.md	WARN	章节文件	无正文内容

其他目录

目录	严重度	用途	缺失影响
对标/	OPTIONAL	对标作品分析	参考素材丢失
参考资料/	WARN	参考资料	影响设定可信度

---

执行流程

Step 1：检测项目结构

# 前置守卫验证
node {skill_dir}/scripts/step-guard.js pre 01 <项目目录>
# 运行检测
node {skill_dir}/scripts/project-health.js <项目目录> --check
# 后置守卫验证
node {skill_dir}/scripts/step-guard.js post 02 <项目目录>

Step 2：输出检测报告

🔍 项目健康检查报告

📊 项目：{项目名}
📁 状态：{健康/需修复}

✅ 已存在：
- AGENTS.md
- .story-deployed
- 设定/世界观/背景设定.md
- ...

❌ 缺失：
- 设定/关系.md
- 追踪/时间线.md
- ...

⚠️ 警告：
- 设定/角色/ 目录为空
- 大纲/ 目录缺少卷纲

Step 3：自动修复（--fix 模式）

# 前置守卫验证
node {skill_dir}/scripts/step-guard.js pre 04 <项目目录>
# 运行修复
node {skill_dir}/scripts/project-health.js <项目目录> --fix
# 后置守卫验证
node {skill_dir}/scripts/step-guard.js post 04 <项目目录>

修复内容：

1. 创建缺失目录
2. 创建缺失文件（使用默认模板）
3. 初始化追踪文件
4. 更新 .story-deployed 标记

Step 4：输出修复报告

🔧 项目修复完成

✅ 已创建：
- 设定/关系.md（空模板）
- 设定/题材定位.md（空模板）
- 追踪/时间线.md（空模板）
- ...

📝 下一步：
- 填充设定文件内容
- 开始写作

---

默认模板

关系.md 模板

# 角色关系

> 基于第001-XXX章

---

## 主要关系

| 角色A | 角色B | 关系类型 | 当前状态 |
|-------|-------|---------|---------|
| {主角} | {配角} | {关系} | {状态} |

时间线.md 模板

# 故事时间线

> 基于第001-XXX章

---

## 关键事件时序

| 章节 | 故事时间 | 事件 | 涉及角色 |
|------|---------|------|---------|
| Ch001 | {时间} | {事件} | {角色} |

物品.md 模板

# 物品追踪

> 基于第001-XXX章

---

## 核心道具

| 物品 | 当前状态 | 位置 | 备注 |
|------|---------|------|------|

环境.md 模板

# 环境追踪

> 基于第001-XXX章

---

## 当前环境

| 维度 | 当前状态 |
|------|---------|
| 季节 | |
| 位置 | |
| 天气 | |

物资.md 模板

# 物资追踪

> 基于第001-XXX章

---

## 经济状态

| 角色 | 钱财 | 食物 | 工具 | 备注 |
|------|------|------|------|------|

重复语句.md 模板

# 重复语句黑名单

> 写正文前必读，黑名单中的语句禁止再次使用

---

| 序号 | 重复内容 | 出现位置 | 重复次数 | 建议替代 |
|------|---------|---------|---------|---------|

文风.md 模板

# 文风设定

> 本书的写作风格约束

---

## 语言风格
- 叙事视角：
- 语言基调：
- 句式特点：

## 对话风格
- 口语化程度：
- 角色区分度：

## 描写风格
- 环境描写：
- 心理描写：
- 动作描写：

故事线_索引.md 模板

# 故事线索引

---

## 主线：{主线名称}
- 状态：进行中
- 涉及章节：-
- 当前进展：待补充

## 支线
（待补充）

故事线_交叉点.md 模板

# 故事线交叉点

---

| 章节 | 主线 | 支线 | 事件 |
|------|------|------|------|

跨卷伏笔.md 模板

# 跨卷伏笔追踪

> 记录跨越多卷的长线伏笔

---

## 跨卷伏笔状态

| ID | 伏笔 | 埋设 | 预计回收 | 状态 | 备注 |
|----|------|------|---------|------|------|

跨卷角色弧线.md 模板

# 跨卷角色弧线

> 记录主要角色的跨卷成长轨迹

---

## {角色名} · 弧线总览

| 卷 | 阶段 | 身份 | 核心矛盾 | 情绪 |
|----|------|------|---------|------|

卷间过渡.md 模板

# 卷间过渡

> 记录各卷之间的过渡设计

---

## 已完成卷间过渡
（待补充）

## 待完成卷间过渡
（待补充）

---

检查项详细说明

文件完整性检查

检查项	检查方法
文件存在	fs.existsSync()
文件非空	fs.statSync().size > 0
格式正确	检查 markdown 格式

目录结构检查

目录	必需子目录	通配检查
设定/	世界观/、角色/、势力/	-
设定/世界观/	-	世界观.md 或 背景设定.md 至少存在其一
大纲/	-	卷纲_.md（通配）、细纲_.md（通配）
大纲/存档/	-	目录存在性
正文/	-	第*.md（通配）
追踪/	-	-
故事线/	-	故事线_主线_*.md（通配）
跨卷追踪/	-	-
对标/	-	目录存在性
参考资料/	-	目录存在性

内容完整性检查

文件	必需内容
角色状态.md	至少一个角色
伏笔.md	表格格式
时间线.md	表格格式
上下文.md	当前进度
角色/ 角色设定	与追踪/角色状态.md 互相印证（character-sync.js）

---

与其他skill的关系

关系	说明
被调用	story-setup-mimo（初始化后检查）
被调用	story-long-write-mimo（写作前检查）
调用	project-health.js（检查/修复脚本）

---

使用场景

场景	说明
项目初始化后	确认所有文件已创建
写作前检查	确保追踪文件完整
遇到问题时	检查是否缺少文件
导入旧项目后	修复缺失的文件
定期维护	每月检查一次项目健康

---

Task 跟踪集成

规范详见 $globalRefPathtask-tracking-conventions.md`。

触发时第一步：读取下方任务树，然后逐条创建。不跳步。

强制执行顺序：

1. 读取上方「任务树」
2. 严格按照列表逐条创建任务
3. 逐个执行

固定任务列表

# ===== 第1层：父任务 =====
1. task create "T-HEALTH: 项目健康检查与修复"                          → T-HEALTH

# ===== 第2层：阶段任务 =====
2. task create "T-HEALTH-PHASE1: Phase 1 检测项目结构"  parent=T-HEALTH → T-HEALTH-PHASE1
3. task create "T-HEALTH-PHASE2: Phase 2 输出检测报告"  parent=T-HEALTH → T-HEALTH-PHASE2
4. task create "T-HEALTH-PHASE3: Phase 3 自动修复"  parent=T-HEALTH    → T-HEALTH-PHASE3
5. task create "T-HEALTH-PHASE4: Phase 4 输出修复报告"  parent=T-HEALTH → T-HEALTH-PHASE4

# ===== 第3层：具体步骤 =====

# Phase 1: 检测项目结构
6. task create "T-HEALTH-P1-01: 运行 project-health.js --check"  parent=T-HEALTH-PHASE1  → T-HEALTH-P1-01

# Phase 2: 输出检测报告
7. task create "T-HEALTH-P2-01: 分类缺失文件（BLOCK/WARN/OPTIONAL）"  parent=T-HEALTH-PHASE2  → T-HEALTH-P2-01
8. task create "T-HEALTH-P2-02: 向用户输出检测报告"  parent=T-HEALTH-PHASE2  → T-HEALTH-P2-02

# Phase 3: 自动修复（条件）
9. task create "T-HEALTH-P3-01: 创建缺失目录"  parent=T-HEALTH-PHASE3  → T-HEALTH-P3-01
10. task create "T-HEALTH-P3-02: 创建缺失文件（使用默认模板）"  parent=T-HEALTH-PHASE3  → T-HEALTH-P3-02
11. task create "T-HEALTH-P3-03: 初始化追踪文件"  parent=T-HEALTH-PHASE3  → T-HEALTH-P3-03
12. task create "T-HEALTH-P3-04: 更新 .story-deployed 标记"  parent=T-HEALTH-PHASE3  → T-HEALTH-P3-04

# Phase 4: 输出修复报告
13. task create "T-HEALTH-P4-01: 列出已创建文件"  parent=T-HEALTH-PHASE4  → T-HEALTH-P4-01
14. task create "T-HEALTH-P4-02: 提示下一步操作"  parent=T-HEALTH-PHASE4  → T-HEALTH-P4-02

条件创建规则

任务	执行时判断	跳过则 abandoned
T-HEALTH-PHASE3	用户传入 --fix 或说"修复项目"	未传 --fix 则 abandoned
T-HEALTH-P3-01~04	Phase 3 执行时	全部顺序执行，无跳过

条件分支处理

分支	触发	处理
BLOCK 文件补建	Phase 3 中发现 BLOCK 级缺失	优先创建，block 当前任务直到补建完成
WARN 文件补建	Phase 3 中发现 WARN 级缺失	问用户是否补建，用户同意则创建，否则 abandoned

完成标准

任务	完成标准
T-HEALTH-P1-01	检测报告 JSON 生成完毕
T-HEALTH-P2-01	文件按严重度分类完成
T-HEALTH-P2-02	检测报告已输出给用户
T-HEALTH-P3-01	缺失目录已创建
T-HEALTH-P3-02	缺失文件已用模板创建
T-HEALTH-P3-03	追踪文件已初始化
T-HEALTH-P3-04	.story-deployed 已更新
T-HEALTH-P4-01	修复报告已生成
T-HEALTH-P4-02	下一步提示已输出

---

使用场景