refactor: clarify skill completion and require verified local commits

2026-09-16 14:11:00 +08:00
parent e126bd4f00
commit f2443a4855
3 changed files with 15 additions and 11 deletions
@@ -50,7 +50,7 @@ Codex 默认根据 `description` 隐式选择 skill；本仓库在每个 skill

 更新已有安装时须同步整个 skill 目录，包括 `agents/openai.yaml`，不能只替换 SKILL.md。若仍出现旧行为，检查项目级、用户级同名副本，重启 Codex 并在新会话验证；更新配置不会撤回旧会话已加载的正文。其他宿主是否支持此策略需单独确认，不保证仅靠描述就能禁止自动加载。

-执行时允许增加必要测试或配置文件并说明理由；涉及业务、接口、架构或其他范围扩展时，需更新计划并确认。验证和 review 通过后创建本地提交，不 push。
+执行时允许增加必要测试或配置文件并说明理由；涉及业务、接口、架构或其他范围扩展时，需更新计划并确认。批准范围内连续完成实现、必要检查、问题修复和 review，再执行本地 `git commit`，不逐步询问是否继续、不 push。存在本任务变更时，只有核实实际 commit hash 与提交内容后才算完成；提交阻塞须明确报告未完成，不能只说“可提交”。无任务差异时提供目标已满足的证据，不创建空提交。

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

@@ -115,6 +115,8 @@ npx skills add . --list

 ## 参考来源

+参考 [OpenAI 关于 GPT-6 Astra 的 skill 与提示设计建议](https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra)：精确描述触发条件，按任务读取资料，以交付结果和决策边界约束工作，避免固定步骤造成过早停止。两个 skill 各自只有一个工作流，保持自包含，不为拆分而新增路由文件；显式调用、用户审阅及范围约束继续保留。
+
 独立编写本仓库指令，借鉴以下机制，不复制其完整工作流，也不要求安装这些项目：

 - [Ponytail](https://github.com/DietrichGebert/ponytail)：理解问题后，优先复用并选择满足目标的最小实现。