From 0ac9a833e41672992184a4435568bacf369f2786 Mon Sep 17 00:00:00 2001
From: hyper <hx.hyper@qq.com>
Date: Sat, 12 Sep 2026 22:51:00 +0800
Subject: [PATCH] docs(reference): regenerate declare block docs

Regenerate `docs/reference.md` and the skill copy from `known.ts`.
---
 .agents/skills/tttk-authoring/reference.md | 16 +++++++++++-----
 docs/reference.md                          | 16 +++++++++++-----
 2 files changed, 22 insertions(+), 10 deletions(-)

diff --git a/.agents/skills/tttk-authoring/reference.md b/.agents/skills/tttk-authoring/reference.md
index 1a7a70c..db2946f 100644
--- a/.agents/skills/tttk-authoring/reference.md
+++ b/.agents/skills/tttk-authoring/reference.md
@@ -297,13 +297,19 @@ d6,结果
 
 Reactive variable / tag-modifier definitions.
 
-Columns (any order): `tag`, `threshold`, `key`, `expr`. A row with an empty `tag` declares a variable; a row with a `#tag` applies a modifier when that tag is active.
+YAML with two optional maps. `vars:` maps a `$name` to its expression. `tags:` maps a tag name to a map of thresholds to `$target` modifiers: at that tag count the target gains the value, so sibling thresholds stack. Tag names may be written with or without the leading `#`. YAML resolves bare numbers to numbers and everything else to strings; both become expression text.
 
 ````markdown
-```csv role=declare
-tag,threshold,key,expr
-,,$hp,$con*5+$mod_hp
-#warrior,2,$mod_hp,20
+```yaml role=declare
+vars:
+  $hp: $con*5 + $mod_hp
+  $ac: 10 + $dex
+tags:
+  warrior:
+    1:
+      $mod_hp: 20
+    2:
+      $mod_str: 1
 ```
 ````
 
diff --git a/docs/reference.md b/docs/reference.md
index 1a7a70c..db2946f 100644
--- a/docs/reference.md
+++ b/docs/reference.md
@@ -297,13 +297,19 @@ d6,结果
 
 Reactive variable / tag-modifier definitions.
 
-Columns (any order): `tag`, `threshold`, `key`, `expr`. A row with an empty `tag` declares a variable; a row with a `#tag` applies a modifier when that tag is active.
+YAML with two optional maps. `vars:` maps a `$name` to its expression. `tags:` maps a tag name to a map of thresholds to `$target` modifiers: at that tag count the target gains the value, so sibling thresholds stack. Tag names may be written with or without the leading `#`. YAML resolves bare numbers to numbers and everything else to strings; both become expression text.
 
 ````markdown
-```csv role=declare
-tag,threshold,key,expr
-,,$hp,$con*5+$mod_hp
-#warrior,2,$mod_hp,20
+```yaml role=declare
+vars:
+  $hp: $con*5 + $mod_hp
+  $ac: 10 + $dex
+tags:
+  warrior:
+    1:
+      $mod_hp: 20
+    2:
+      $mod_str: 1
 ```
 ````