创建和维护故事世界设定时使用：用 Markdown 与…

适用于已有故事项目（根目录有 `story.md`），需要新增或更新地点、系统、阵营、神器等世界观元素，并维护索引、角色/章节交叉引用和校验的场景。

适用场景

解决思路

1. 【创建地点】读取 `story.md`，获取 genre、era、tone 上下文。
2. 【创建地点】读取 `worldbuilding/_index.md`，查看已有地点和系统。
3. 【创建地点】询问地点名称和类型（city、fortress、wilderness 等）。
4. 【创建地点】通过对话构建地点，覆盖物理描述与氛围。
5. 【创建地点】通过对话构建地点，覆盖与故事相关的历史。
6. 【创建地点】通过对话构建地点，覆盖居民的文化与习俗。
7. 【创建地点】通过对话构建地点，覆盖角色会互动的重要特征。
8. 【创建地点】通过对话构建地点，覆盖故事时间线中的当前状态。
9. 【创建地点】使用 `references/location-template.md` 编写文件。
10. 【创建地点】保存到 `worldbuilding/locations/{name-kebab}.md`。
11. 【创建地点】更新 `worldbuilding/_index.md` 的 locations 表。
12. 【创建地点】如果列出了 notable characters，验证这些角色文件存在，并把该地点的 kebab-case 标识符加入每个角色文件 frontmatter 的 `locations` 列表。
13. 【创建地点】当 CLI 可用时，运行 `story reindex .`、`story links .`、`story validate .`。
14. 【创建系统】读取 `story.md`，获取 genre 和 themes 上下文。
15. 【创建系统】读取 `worldbuilding/_index.md`，查看已有系统。
16. 【创建系统】确定系统类型，并查阅 `references/world-element-types.md` 中对应的提示问题。
17. 【创建系统】通过对话构建系统，回答该类型的关键问题。
18. 【创建系统】使用 `references/system-template.md` 编写文件。
19. 【创建系统】保存到 `worldbuilding/systems/{name-kebab}.md`。
20. 【创建系统】更新 `worldbuilding/_index.md` 的 systems 表。
21. 【创建系统】与会交互该系统的角色建立交叉引用（例如魔法系统对应魔法使用者）。
22. 【创建系统】当 CLI 可用时，运行 `story reindex .`、`story links .`、`story validate .`。
23. 【创建阵营】CLI 可用时，使用 `story add faction "{Faction Name}" --type "{family|guild|government|military|religion|company|community|criminal|other}"`。
24. 【创建阵营】CLI 不可用时，创建 `worldbuilding/factions/{name-kebab}.md`，frontmatter 字段包含 `name`、`type`、`status`、`members`、`locations`、`tags`。
25. 【创建阵营】覆盖目的与意识形态。
26. 【创建阵营】覆盖权力基础、资源和领地。
27. 【创建阵营】覆盖重要成员。
28. 【创建阵营】覆盖冲突和压力点。
29. 【创建阵营】保存到 `worldbuilding/factions/{name-kebab}.md`。
30. 【创建阵营】更新 `worldbuilding/_index.md` 的 Factions 表。
31. 【创建阵营】如果列出了成员，验证这些角色文件存在。
32. 【创建阵营】当 CLI 可用时，运行 `story reindex .`、`story links .`、`story validate .`。
33. 【创建神器】CLI 可用时，使用 `story add artifact "{Artifact Name}" --type "{object|weapon|document|technology|relic|symbol|resource|other}"`。
34. 【创建神器】CLI 不可用时，创建 `worldbuilding/artifacts/{name-kebab}.md`，frontmatter 字段包含 `name`、`type`、`status`、`owner`、`location`、`tags`。
35. 【创建神器】覆盖描述与识别细节。
36. 【创建神器】覆盖功能、限制和代价。
37. 【创建神器】覆盖历史和前任拥有者。
38. 【创建神器】覆盖当前拥有者/位置状态。
39. 【创建神器】保存到 `worldbuilding/artifacts/{name-kebab}.md`。
40. 【创建神器】更新 `worldbuilding/_index.md` 的 Artifacts 表。
41. 【创建神器】如果列出了 owner 或 location，验证这些文件存在并反向交叉引用。
42. 【创建神器】当 CLI 可用时，运行 `story reindex .`、`story links .`、`story validate .`。
43. 【更新世界元素】读取现有文件。
44. 【更新世界元素】进行要求的修改。
45. 【更新世界元素】如果交叉引用发生变化，更新被链接的文件。
46. 【更新世界元素】如果 name、type 或 status 发生变化，更新 `worldbuilding/_index.md`。
47. 【更新世界元素】当 CLI 可用时，运行 `story reindex .`、`story links .`、`story validate .`。
48. 【交叉引用】Locations 通过 frontmatter 的 `notable-characters` 引用角色。
49. 【交叉引用】Characters 通过 frontmatter 的 `locations` 引用地点。
50. 【交叉引用】Factions 引用角色成员和地点。
51. 【交叉引用】Artifacts 引用 owner 角色或阵营，以及当前 location。
52. 【交叉引用】Systems 通过角色 tags 引用 practitioners。
53. 【交叉引用】当地点被用于某章节时，章节 frontmatter 的 `locations` 字段链接回该地点。
54. 【交叉引用】随着元素添加，保持 `worldbuilding/_index.md` 的 world overview 部分为最新。
55. 【CLI 维护】CLI 可用时使用 Story CLI。
56. 【CLI 维护】如果未安装 `story`，在 Story Skills 仓库检出目录中使用 `bun run story --`，或使用同参数的内置回退 `node ../story-maintenance/scripts/story.js`，并把路径解析为相对于此技能文件夹。
57. 【CLI 维护】如果没有任何 CLI 可用，则手动执行 registry、backlink、word-count 检查。
58. 【参考文件】需要地点文件模板时查阅 `references/location-template.md`。
59. 【参考文件】需要系统文件模板时查阅 `references/system-template.md`。
60. 【参考文件】需要阵营文件模板时查阅 `references/faction-template.md`。
61. 【参考文件】需要神器/物件文件模板时查阅 `references/artifact-template.md`。
62. 【参考文件】需要各系统类型的详细提示（magic、political、technology、religion、economic、military、social）时查阅 `references/world-element-types.md`。

适用边界 · 注意事项

• 尚未创建故事项目，或项目根目录没有 `story.md` 时不适用；应先用 story-init 创建项目。
• 如果只是想写独立设定文档，不需要与角色/章节交叉引用，也不需要维护 `worldbuilding/_index.md` 和 CLI 校验，则不必使用此完整流程。
• 如果 `story`、`bun run story --` 和 `node ../story-maintenance/scripts/story.js` 都不可用，依赖 CLI 的自动 registry、backlink、word-count 检查无法执行，只能手动检查。