Skip to content

Add apex skills admin#52

Open
ORAsonjameyer wants to merge 9 commits into
oracle:mainfrom
ORAsonjameyer:add-apex-skills-admin
Open

Add apex skills admin#52
ORAsonjameyer wants to merge 9 commits into
oracle:mainfrom
ORAsonjameyer:add-apex-skills-admin

Conversation

@ORAsonjameyer

@ORAsonjameyer ORAsonjameyer commented May 21, 2026

Copy link
Copy Markdown
Member

This PR adds and refines the Oracle APEX Admin skill guidance for APEX administration workflows.

The skill focuses on APEX-admin-owned work: workspace lifecycle, deployment/import review, runtime monitoring, security guardrails, APEX users, schema mapping, and supported APEX administration APIs.

Key changes:

  • Adds a clear APEX Admin identity gate for live MCP-backed work.
  • Requires a confirmed non-SYS/SYSTEM APEX admin identity for routine APEX administration.
  • Routes SYS/SYSDBA bootstrap-only work, such as INTERNAL/APEX Instance Administrator setup, to the documented apxchpwd.sql path.
  • Separates APEX Admin, APEXlang, DB, ORDS, and SQLcl responsibilities.
  • Routes APEX application generation or material app artifact changes to apex/apexlang.
  • Routes generic DB work such as users, grants, quotas, tablespaces, AWR/ASH, SQL Monitor, wait events, ORDS diagnostics, and SQL tuning to the relevant DB/ORDS skills.
  • Adds file-only analysis handling: the skill states when no database access is needed, asks once for additional customer evidence, and asks where analysis output should be saved.
  • Strengthens customer-data handling so reports, findings, filenames, paths, and customer-specific evidence are not written into the skill tree.
  • Adds and updates monitoring coverage for APEX Activity Log, Page Performance, Debug/Error evidence, background jobs, REST data sources, runtime-risk export review, and AI token monitoring.
  • Adds supported-version guidance for APEX 26.1, 24.2, and 24.1 based on the current Oracle APEX support matrix.
  • Adds guidance for APEX-managed schema privilege handling via supported APEX APIs instead of manual grant generation.
  • Keeps admin helper tools limited to static APEX-admin planning and export-risk scanning.

Validation:

  • Reviewed the updated routing and reference files.
  • Verified the APEX Admin skill tree has no stale migration links.
  • Verified there are no scope conflicts with the DB and APEXlang skills.
  • Redundancies are intentionally avoided: when work belongs to DB, ORDS, SQLcl, APEXlang, the APEX Admin skill routes to the owning skill instead of duplicating that guidance.

@ORAsonjameyer ORAsonjameyer force-pushed the add-apex-skills-admin branch from 76ba9ff to 49d5a08 Compare May 30, 2026 19:02
@ORAsonjameyer ORAsonjameyer marked this pull request as ready for review June 8, 2026 10:34
Comment thread apex/admin/tools/workspace-admin-plan.mjs Outdated

@neilfernandez neilfernandez left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just 1 change requested

APEX 23.2 was already documented as expired in version-notes, but still present in generated and recovery gates. Removed it there so all admin checks follow the same policy.

@martin-bach-oracle martin-bach-oracle left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Change requested by Neil has been implemented. My testing concluded positively, this looks good to me.

@krisrice krisrice self-requested a review June 12, 2026 13:43
@krisrice krisrice self-assigned this Jun 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants