@antprofuse/saddle-skill 0.1.2 → 0.1.3

package/SKILL.md

@@ -1,26 +1,30 @@
 ---
 name: saddle-service
-description: 基于已发布的 Saddle 门面包 `saddle-framework = "=0.1.1"` 构建和审查最小 Rust Service 应用。当 AI Coding 需要创建 Saddle 0.1.1 Service 契约、处理器、注册、HTTP/JSON 暴露、固定进程入口，或在不读取和修改 Saddle 中间件实现的前提下验证生成的业务代码时使用。
+description: 基于已发布的 `saddle-framework = "=0.1.1"` 构建和审查 Saddle V1 Rust 业务应用。当 AI Coding 需要创建单进程业务大库、Service 契约与内部调用、HTTP/JSON 入口、托管数据库查询与写入、单层事务、稳定错误、领域事件，或检查线程、运行时、Web、DB 和日志旁路时使用。
 ---
 
-# Saddle Service 0.1.1
+# Saddle V1 研发契约
 
-只使用 `saddle-framework = "=0.1.1"` 已发布的公共 API。
+只将针对 crates.io `saddle-framework = "=0.1.1"` 编译通过的用法视为可用能力。
 
-## 工作流程
+## 执行顺序
 
-1. 将门面依赖精确固定为 `saddle-framework = "=0.1.1"`，并以 `saddle` 作为导入名。
-2. 生成 Service 代码前，阅读 [references/service-0.1.1.md](references/service-0.1.1.md)。
-3. 在 Saddle 仓库内工作时，从已验证的 `examples/helloworld` 消费端示例开始。
-4. 将业务代码限制为请求/响应类型、Service 契约、对应处理器和 Saddle 装配。
-5. 修改参考示例后，执行 [references/service-0.1.1.md](references/service-0.1.1.md) 中记录的 Rust 1.85 和当前工具链检查。
-6. 拒绝使用仅存在于 V1 目标描述中、但尚未由已发布门面提供的 API。
+1. 阅读 [总览](references/overview-0.1.1.md)，确定大库、模块和进程边界。
+2. 按任务读取对应参考：
+   - Service 定义、注册、对外入口或内部调用：读 [Service](references/service-0.1.1.md)。
+   - 启动、异步执行或关闭边界：读 [Runtime](references/runtime-0.1.1.md)。
+   - 查询、写入、行解码或事务：读 [DB 与事务](references/db-0.1.1.md)。
+   - 稳定错误、Trace 上下文或领域事件：读 [Observability](references/observability-0.1.1.md)。
+   - 新增依赖或交付前检查：读 [门禁](references/gates-0.1.1.md)。
+3. 新建应用时复制 `assets/v1-business`，再按领域修改；不要重新装配中间件。
+4. 业务 crate 只直接依赖精确版本的 Saddle 门面和必要的纯计算/序列化依赖。
+5. 完成后执行 [验证](references/validation-0.1.1.md) 中的编译、依赖和边界检查。
 
-## 边界
+## 不可突破的边界
 
-- 不要检查或修改 Saddle 组件实现。
-- 不要替换 Saddle 的进程入口、异步运行时、HTTP 服务器、数据库连接池或可观测性装配。
-- 不要在业务代码中创建线程、运行时、脱离生命周期的任务、路由器、I/O 客户端或数据库连接池。
-- 在没有可编译的 0.1.1 消费端示例前，不要声称数据库、事务、内部 Service 调用、优雅停机或可观测性用法可用。
-- 如果缺少所需公共 API，保留最小可复现的消费端失败案例，通过远程 Git 提交给控制 workspace 评估；不要在这里修补中间件。
-- 将本地设计文档视为设计意图，将针对 crates.io 0.1.1 制品的编译结果视为可用 API 的事实依据。
+- 不读取、复制或修改 Saddle 中间件实现。
+- 不创建线程、async runtime、脱离 Saddle 管理的 task、Web Server、路由器、连接池、底层事务或日志 subscriber。
+- 不绕过 `ServiceClient` 调用其他业务模块，不绕过 `Database` 执行数据库 I/O。
+- 不记录完整请求、响应、SQL 参数、凭据或任意敏感对象。
+- 不使用设计文档中的目标替代已发布 API；编译失败时保留最小复现并提交控制 workspace。
+- 不声称 0.1.1 支持定时任务、后台任务、消息消费、外部 HTTP/RPC、文件 I/O、多数据源、嵌套/分布式事务、Metrics 或跨进程调用。

package/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
-  display_name: "Saddle Service 0.1.1"
-  short_description: "构建经过验证的 Saddle 0.1.1 Service 应用"
-  default_prompt: "使用 $saddle-service 构建一个最小的 Saddle Service 应用。"
+  display_name: "Saddle V1 研发契约"
+  short_description: "使用已发布 API 构建完整 Saddle V1 业务应用"
+  default_prompt: "使用 $saddle-service 按 Saddle V1 契约实现并验证业务模块。"