docs: 沉淀 Action 表单 visibleWhen 条件显隐契约

tests/test_docs_standards.py

@@ -363,9 +363,34 @@ class TestDocsStandards(unittest.TestCase):
             "_jiangchang_columns.description",
             "datetime_unix_seconds",
             "SCHEMA.md",
+            "字段条件显隐",
+            "visibleWhen",
         ):
             self.assertIn(marker, text, msg=f"ACTIONS.md missing {marker!r}")
 
+    def test_actions_md_disambiguates_visible_when_from_policy(self) -> None:
+        actions = self._read("references/ACTIONS.md")
+        policy = self._read("references/POLICY.md")
+        self.assertIn("字段条件显隐", actions)
+        self.assertIn("inputSchema.properties", actions)
+        self.assertTrue(
+            "POLICY.md" in actions and "L3" in actions,
+            msg="ACTIONS.md must point readers away from Policy L3 visibleWhen",
+        )
+        self.assertTrue(
+            "inputSchema" in policy and "ACTIONS.md" in policy,
+            msg="POLICY.md must disambiguate L3 visibleWhen from Action form visibleWhen",
+        )
+
+    def test_visible_when_example_is_listed(self) -> None:
+        text = self._read("assets/examples/README.md")
+        self.assertIn("visible-when-action.example.json", text)
+        checklist = self._read("development/CHECKLIST.md")
+        self.assertIn("A4-7", checklist)
+        self.assertIn("visibleWhen", checklist)
+        runtime = self._read("development/SKILL_ACTION_RUNTIME.md")
+        self.assertIn("visibleWhen", runtime)
+
     def test_guarded_docs_do_not_reference_amazon_implementation(self) -> None:
         forbidden = (
             "download-settlement-report-amazon",