3.7 KiB
oracle-jump-query Skill Release Standard
Git 提交说明
- 提交信息和发布记录使用简洁、准确的中文。
- 按可独立验证的小功能节点分别提交，不混入无关修改。
- Bug 修复通常只说明修复的功能点和结果，不展开代码缺陷细节；排障或防复发所必需的信息除外。
- 每次将 Skill 推送到私有 Git 后，必须同步更新公共镜像，不再另行等待确认。公共镜像只导入当前私有
main的无历史快照；同步前检查敏感文件、管理员令牌回退和测试结果，不得推送私有提交历史。
Release 1.5.44: 将公共镜像同步纳入每次 Skill Git 发布的必做步骤，同时保留无历史快照和敏感信息检查要求。
Release 1.5.43: 统一 Git 提交与发布记录规范，明确使用简洁中文、按小功能节点提交，并精简 Bug 修复说明。提交 176bd4594779a8489ad25ab828380b2b7ab3354b 已于 2026-08-27 10:18 +08:00 推送到私有 Gitea，并同步安装目录；capabilities --json 验证版本为 1.5.43。
Release 1.5.42: added log_info, log_tail, log_search, log_enable, and log_disable; uses authenticated dedicated transit endpoints and preserves structured log errors. Commit e90cbc9ce3525970b2f07885d52c4f0172bf9d2f was pushed to private Gitea at 2026-08-27 09:51 +08:00, pulled into the installed Skill, and verified by capabilities --json as 1.5.42. Log content is not stored in Skill config, output archives, or release history.
A published VERSION is frozen. Increment it for every later change, update CHANGELOG.md, commit and push to Gitea. Skill updates use Git only: pull the commit into the Codex Skill directory with git pull --ff-only origin main, then run capabilities --json. Do not publish or update this Skill through OSS.
inspection_report and inspection_latest --refresh must run sys_function_check before Agent collection. Missing SYS/current-schema functions stop generation and return the complete SQL bundle. Historical report reads do not run this preflight.
Record version, commit, push time and verification result for every release.
Release 1.5.32: added authenticated awr_status, awr_list, and byte-for-byte awr_download commands. AWR remains disabled until the customer DBA confirms Diagnostics Pack authorization and Agent configuration explicitly enables it. The release commit, push time, and installed-skill verification are recorded in the project release log.
Release 1.5.33: when AWR readiness reports missing function or view permission, resolve the target Agent schema and return the archived DBA SQL with the real account substituted. Never execute the SQL and never emit an unresolved <AGENT_SCHEMA> placeholder.
Release 1.5.34: update archived HENLO_AWR_EXPORT to v1.1 so null rows do not reach DBMS_LOB.WRITEAPPEND, preserve report row boundaries with newlines, and keep deployment strictly manual through the DBA SQL output.
Release 1.5.35: change the Skill default transit endpoint to https://ts.henlo.net, update configuration and documentation examples, preserve existing login/session fields while migrating only transit_url, validate, commit and push to Gitea, then pull and verify the installed Skill.
Release 1.5.36: remove the hard-coded Agent-update administrator token fallback. agent_update must require ORACLE_JUMP_UPGRADE_ADMIN_TOKEN or upgrade_admin_token and fail locally without issuing a request when neither is configured. This rule is mandatory before publishing the manually approved, no-history public mirror snapshot.
Release 1.5.37: update the Skill and README maintenance instructions to document both the private repository and the public no-history mirror, so a fresh public download points to the correct Git addresses.