skill(iter-1): fix CLI getRecords flag + docs from eval feedback

Ran 4 end-to-end evals (skill-creator flow): all 23 assertions passed (100%).
The evals exposed 3 issues, now fixed:

1. CLI bug: getRecords/createRecord/updateRecord --target-table flag was
   read as opts['target-table'] but commander stores it camelCase
   (opts.targetTable). Added a pick() helper accepting both forms.
2. trigger-types.md: buttonClick output said record.fields.* implying all
   fields; actually record.fields only contains the button field's count.
   Documented the back-channel API fetch pattern for other fields.
3. automation-guide.md: documented that 'workflow test' uses mock input
   with empty fields, so upstream outputs are absent in test mode — use
   real fire for data-dependent validation.

Also: corrected button field options (workflow.id object, not workflowId).

dist/commands/workflow.js

@@ -466,11 +466,15 @@ function readFile(p) {
 /** Build action config from granular flags. */
 function buildActionConfig(opts) {
     const type = opts.type;
+    // Helper: commander stores --kebab-case flags as camelCase in opts (e.g.
+    // --target-table -> opts.targetTable). Accept both forms for safety.
+    const pick = (k) => (opts[k] ?? opts[toCamel(k)]);
     const config = {};
     switch (type) {
         case 'script': {
-            if (opts['code-file'])
-                config.code = readFile(opts['code-file']);
+            const codeFile = pick('code-file');
+            if (codeFile)
+                config.code = readFile(codeFile);
             else if (opts.code)
                 config.code = opts.code;
             if (opts.timeout)
@@ -493,21 +497,24 @@ function buildActionConfig(opts) {
                 config.method = opts.method;
             if (opts.headers)
                 config.headers = JSON.parse(opts.headers);
-            if (opts['req-body'])
-                config.body = JSON.parse(opts['req-body']);
+            const reqBody = pick('req-body');
+            if (reqBody)
+                config.body = JSON.parse(reqBody);
             break;
         }
         case 'createRecord':
         case 'updateRecord': {
-            if (opts['target-table'])
-                config.tableId = opts['target-table'];
+            const tt = pick('target-table');
+            if (tt)
+                config.tableId = tt;
             if (opts.records)
                 config.records = JSON.parse(opts.records);
             break;
         }
         case 'getRecords': {
-            if (opts['target-table'])
-                config.tableId = opts['target-table'];
+            const tt = pick('target-table');
+            if (tt)
+                config.tableId = tt;
             if (opts.query)
                 config.query = JSON.parse(opts.query);
             break;
@@ -518,3 +525,6 @@ function buildActionConfig(opts) {
     return config;
 }
 exports.buildActionConfig = buildActionConfig;
+function toCamel(s) {
+    return s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}