fix: require explicit invocation for Codex skills

2026-09-10 17:13:21 +08:00
parent 56dc99402b
commit 19ee68307b
5 changed files with 15 additions and 5 deletions
@@ -21,10 +21,12 @@ npx -y skills add ssh://git@gitea.fjy8018.top:8022/fjy8018/coding-skills.git --s

 ## 使用

+两个 skill 仅在用户明确调用时启用。Codex 中可使用 `$align-plan`、`$execute-plan` 或通过 skill 选择器调用；普通“规划方案”“执行任务”请求不自动启用。
+
 在项目目录中开始规划，例如：

 ```text
-使用 align-plan，目标是修复订单查询的分页重复问题。
+$align-plan 目标是修复订单查询的分页重复问题。
 本次保留现有接口格式。讨论资产放到 /绝对路径/工程讨论。
 ```

@@ -39,11 +41,15 @@ Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简
 审阅确认后自行开启新会话，指定已批准的计划：

 ```text
-使用 execute-plan 执行 /绝对路径/工程讨论/2026-09-10-pagination-fix/plan.md
+$execute-plan 执行 /绝对路径/工程讨论/2026-09-10-pagination-fix/plan.md
 ```

 支持命令式调用的宿主也可使用对应的 skill 命令，具体语法以宿主为准。Skill 不负责自动创建新会话，也不能保证检测或清除旧上下文。

+Codex 默认根据 `description` 隐式选择 skill；本仓库在每个 skill 的 `agents/openai.yaml` 中设置 `policy.allow_implicit_invocation: false`，保留显式调用。仅修改描述不能代替该策略。[官方调用策略说明](https://learn.chatgpt.com/docs/build-skills)
+
+更新已有安装时须同步整个 skill 目录，包括 `agents/openai.yaml`，不能只替换 SKILL.md。若仍出现旧行为，检查项目级、用户级同名副本，重启 Codex 并在新会话验证；更新配置不会撤回旧会话已加载的正文。其他宿主是否支持此策略需单独确认，不保证仅靠描述就能禁止自动加载。
+
 执行时允许增加必要测试或配置文件并说明理由；涉及业务、接口、架构或其他范围扩展时，需更新计划并确认。验证和 review 通过后创建本地提交，不 push。

 实施时核实引用与兼容用途，移除范围内无用的死代码和被替代的遗留实现。若核心假设、业务语义或架构边界与决策有重大出入，立即停止执行并记录现场，建议回到 align-plan 重新对齐范围和边界；重新确认前不继续实现。