fix: require explicit invocation for Codex skills
This commit is contained in:
mujing
@@ -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 重新对齐范围和边界；重新确认前不继续实现。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: align-plan
|
||||
description: 通过调查和多轮问答对齐工程目标，生成待审阅计划。用于实施前明确需求、约束与范围；不实施代码。
|
||||
description: 仅在用户明确要求使用 align-plan 时启用。通过调查和多轮问答对齐工程目标，生成待审阅计划；不实施代码。
|
||||
---
|
||||
|
||||
# 对齐目标并生成计划
|
||||
@@ -60,4 +60,4 @@ description: 通过调查和多轮问答对齐工程目标，生成待审阅计
|
||||
|
||||
用户确认当前文件内容后记录批准依据与日期。实质修订直接更新 plan.md，清除旧批准依据并重置为待确认，再给摘要与链接；重新确认前不执行变化。写入或摘要不代表批准。
|
||||
|
||||
确认后给出新会话提示：`使用 execute-plan 执行 /绝对路径/plan.md`，结束规划。不要自动实施或声称已清空上下文。
|
||||
确认后给出新会话提示：`$execute-plan 执行 /绝对路径/plan.md`，结束规划。不要自动实施或声称已清空上下文。
|
||||
|
||||
@@ -0,0 +1,2 @@
|
||||
policy:
|
||||
allow_implicit_invocation: false
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: execute-plan
|
||||
description: 执行用户指定的已批准工程计划，验证目标与范围并完成本地 Git 提交。用于已有计划的实施。
|
||||
description: 仅在用户明确要求使用 execute-plan 时启用。执行已批准工程计划，验证目标与范围并完成本地 Git 提交。
|
||||
---
|
||||
|
||||
# 执行已确认计划
|
||||
|
||||
@@ -0,0 +1,2 @@
|
||||
policy:
|
||||
allow_implicit_invocation: false
|
||||
Reference in New Issue
Block a user