diff --git a/README.md b/README.md index 4912182..c6a49ed 100644 --- a/README.md +++ b/README.md @@ -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 重新对齐范围和边界;重新确认前不继续实现。 diff --git a/skills/align-plan/SKILL.md b/skills/align-plan/SKILL.md index a48eb24..47f12a3 100644 --- a/skills/align-plan/SKILL.md +++ b/skills/align-plan/SKILL.md @@ -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`,结束规划。不要自动实施或声称已清空上下文。 diff --git a/skills/align-plan/agents/openai.yaml b/skills/align-plan/agents/openai.yaml new file mode 100644 index 0000000..5b1f887 --- /dev/null +++ b/skills/align-plan/agents/openai.yaml @@ -0,0 +1,2 @@ +policy: + allow_implicit_invocation: false diff --git a/skills/execute-plan/SKILL.md b/skills/execute-plan/SKILL.md index 6be2d1b..9e767c1 100644 --- a/skills/execute-plan/SKILL.md +++ b/skills/execute-plan/SKILL.md @@ -1,6 +1,6 @@ --- name: execute-plan -description: 执行用户指定的已批准工程计划,验证目标与范围并完成本地 Git 提交。用于已有计划的实施。 +description: 仅在用户明确要求使用 execute-plan 时启用。执行已批准工程计划,验证目标与范围并完成本地 Git 提交。 --- # 执行已确认计划 diff --git a/skills/execute-plan/agents/openai.yaml b/skills/execute-plan/agents/openai.yaml new file mode 100644 index 0000000..5b1f887 --- /dev/null +++ b/skills/execute-plan/agents/openai.yaml @@ -0,0 +1,2 @@ +policy: + allow_implicit_invocation: false