docs(skill): add plugin module to SKILL.md + routing rules + description

- Module map: new Plugins row (list/install/uninstall, dev allow/revoke)
- Routing rules: 3 new plugin intents (custom UI, allow devs, external API)
- Description: mention dynamic plugins + dev whitelist + CSP
This commit is contained in:
yeuimu
2026-08-13 15:39:56 +00:00
parent 49836d2655
commit bc8c76851d
+15 -9
View File
@@ -5,15 +5,17 @@ description: >-
automation engine). Configure tables, fields, records, views, and automations automation engine). Configure tables, fields, records, views, and automations
(8 triggers incl. recordCreated/Updated/Condition, formSubmitted, scheduledTime, (8 triggers incl. recordCreated/Updated/Condition, formSubmitted, scheduledTime,
buttonClick, webhook; 6 actions: script, sendEmail, httpRequest, createRecord, buttonClick, webhook; 6 actions: script, sendEmail, httpRequest, createRecord,
updateRecord, getRecords), plus secrets and execution history. Trigger when the updateRecord, getRecords), plus secrets, execution history, and dynamic plugins
user wants to manage tables/fields/records/views, build or configure (install/uninstall, base-level mount nodes, developer whitelist, CSP apiOrigins).
automations/workflows, set up button-field triggers, schedule jobs, create Trigger when the user wants to manage tables/fields/records/views, build or
webhooks, inspect run history, or troubleshoot a deployed inkreach-teable configure automations/workflows, set up button-field triggers, schedule jobs,
instance - even without saying "inkreach-teable" but referencing Teable-style IDs create webhooks, inspect run history, install or configure plugins, allow
(bseXXX, tblXXX, fldXXX, recXXX, viwXXX, wflXXX) or ask to configure developers to upload plugins, or troubleshoot a deployed inkreach-teable
tables/automation on the local/deployed instance. Also covers dev/deploy tasks instance - even without saying "inkreach-teable" but referencing Teable-style
(build, restart systemd services). Uses the inkreach-teable CLI, which targets IDs (bseXXX, tblXXX, fldXXX, recXXX, viwXXX, wflXXX) or ask to configure
the project's OWN automation contract (NOT the official teable CLI). tables/automation/plugins on the local/deployed instance. Also covers dev/deploy
tasks (build, restart systemd services). Uses the inkreach-teable CLI, which
targets the project's OWN automation contract (NOT the official teable CLI).
--- ---
# inkreach-teable operations # inkreach-teable operations
@@ -50,6 +52,7 @@ Respond in the user's language. Keep answers concise and action-oriented.
| Execution History | Inspect run results / rerun failures | `runs list/get/rerun` | [cli-reference.md § runs](guides/cli-reference.md#runs) | | Execution History | Inspect run results / rerun failures | `runs list/get/rerun` | [cli-reference.md § runs](guides/cli-reference.md#runs) |
| Manual Trigger | Test by firing button-click/webhook | `fire button-click`, `fire webhook` | [automation-guide.md § Testing](guides/automation-guide.md#testing--triggering) | | Manual Trigger | Test by firing button-click/webhook | `fire button-click`, `fire webhook` | [automation-guide.md § Testing](guides/automation-guide.md#testing--triggering) |
| SQL | Read-only analytics, JOINs, aggregation | `sql <sql>` | [cli-reference.md § sql](guides/cli-reference.md#sql) | | SQL | Read-only analytics, JOINs, aggregation | `sql <sql>` | [cli-reference.md § sql](guides/cli-reference.md#sql) |
| Plugins | Install/manage dynamic plugins, developer whitelist, CSP | `plugin list/install/uninstall`, `plugin dev allow/revoke` | [cli-reference.md § plugin](guides/cli-reference.md#plugin) |
| Dev/Deploy | Build, restart services, known gotchas | (systemd / pnpm build) | [development.md](guides/development.md) | | Dev/Deploy | Build, restart services, known gotchas | (systemd / pnpm build) | [development.md](guides/development.md) |
### 2.2 Routing Rules ### 2.2 Routing Rules
@@ -67,6 +70,9 @@ Respond in the user's language. Keep answers concise and action-oriented.
| Schedule recurring job | Trigger `scheduledTime` (only type+interval work) | Passing triggerTime/weekdays (backend ignores) | | Schedule recurring job | Trigger `scheduledTime` (only type+interval work) | Passing triggerTime/weekdays (backend ignores) |
| Per-row AI / transformation | Action `script` reading `triggerInput` | Manual row-by-row via record API | | Per-row AI / transformation | Action `script` reading `triggerInput` | Manual row-by-row via record API |
| Send notification | Action `sendEmail` or `httpRequest` | — | | Send notification | Action `sendEmail` or `httpRequest` | — |
| Add a custom UI / view / panel | Plugins: `plugin install --position base` | Manually editing DB rows |
| Allow a user to upload plugins | Plugins: `plugin dev allow <userIdOrEmail>` (admin only) | — |
| Plugin needs external API access | Plugins: declare `apiOrigins` in `plugin.json` manifest | Editing CSP in next.config.js (global) |
| Read records for later writes | `record get` (returns record IDs) | `sql` (no record IDs returned) | | Read records for later writes | `record get` (returns record IDs) | `sql` (no record IDs returned) |
| Analytics / aggregation / JOIN | `sql` with GROUP BY | Fetch all records + compute in code | | Analytics / aggregation / JOIN | `sql` with GROUP BY | Fetch all records + compute in code |
| Store an API key for a script | `secret set` → read in script via `process.env.NAME` | Hardcoding in script code | | Store an API key for a script | `secret set` → read in script via `process.env.NAME` | Hardcoding in script code |