ignis

name	ignis
description	Use for building and operating Ignis projects with ignis-cli, ignis-sdk, ignis.hcl, SQLite, async jobs, cron schedules, platform object-store presign, service build/publish/deploy, and example-driven project setup.

Ignis

在当前任务是“使用 Ignis 开发或发布 service”时使用这个 skill，而不是修改 Ignis 仓库本身时使用。

• 使用 ignis 初始化、构建、发布和部署 service
• 使用 ignis-sdk 的 HTTP Router、中间件、响应 helper、SQLite、migration 和 object-store presign
• 编写或排查 ignis.hcl，包括 services、jobs 和 schedules
• 使用 examples 里的最小项目结构快速起步
• 你需要先查看ignis是否安装，若为安装就阅读cli文档安装

快速流程

1. 先读 references/integration.md，确认完整接入路径。
2. 如果任务偏 CLI 或发布部署，继续读 references/cli.md。
3. 如果任务偏 ignis.hcl 字段、默认值或示例配置，读 references/ignis-hcl.md。
4. 如果任务偏 ignis-sdk API，用 references/ignis-sdk/index.md 作为入口，只继续打开当前需要的模块或 item 页面。
5. 如果任务涉及 async jobs、manual job API、cron schedules、job runs 或 job execution headers，读 references/jobs-and-schedules.md。
6. 如果任务涉及运行时内置系统 API、http://__ignis.svc/v1/services、平台托管 COS/S3 presigned URL 或 object-store host import，读 references/system-api.md；需要完整上传例子时读 references/object-store-presign.md 和 references/examples/cos-and-jobs-example/。
7. 如果任务涉及登录或 [services.ignis_login]，切到 ignis-login skill。
8. 如果任务涉及 kind = "agent"、OpenCode agent-service、TaskPlan 多 agent workflow、任务 schema、opencode.json 注入、自定义 agent skills 或前端/后端/agent 端到端，读 references/ignis-hcl.md 的 agent service 配置和 references/examples/math-proof-lab/。
9. 如果任务涉及多 agent 协作、TaskPlan、spawn_task_plan、tool_callback_url、父任务等待子计划或 coordinator agent，读 references/taskplan.md。
10. 如果需要最小 HTTP / SQLite 模板，优先读整个 example 项目： references/examples/hello-fullstack/ 和 references/examples/sqlite-example/。

工作规则

• 把 ignis.hcl 文档和 ignis-sdk 生成文档当作配置/API 的事实来源。
• 不要猜测 ignis.hcl 字段、CLI 命令名、ignis-sdk 方法或 secret 约定。
• 当前推荐工作流是：ignis login -> ignis project create -> ignis service new -> ignis service build -> ignis service publish -> ignis service deploy。
• 当前 CLI 不再把本地 dev 作为主工作流；默认以构建、发布、部署为准。
• 简单 handler 可以直接用 wstd::http，但多路由、中间件、统一响应、SQLite 通常优先用 ignis-sdk。
• 需要查 SDK 细节时，优先读 mddoc 生成的单页，不要只靠摘要文档推断。
• 当前公网路由模型是一个 project host 下按 path prefix 暴露 services，例如前端走 /，API 走 /api，不要再假设 api.<project-host> 这类子域。
• 当前 http service 统一使用标准 wasm32-wasip2 构建路径，不要再按 cargo-component 工作流推断 CLI 行为。
• ignis-sdk 依赖来源不要猜测；默认给用户 GitHub Cargo 依赖写法，例如 ignis-sdk = { git = "https://github.com/igniscloud/ignis.git", package = "ignis-sdk", tag = "v0.1.3" }。只有在本地联调 Ignis 仓库时再改用明确的 path。
• 平台托管对象存储优先使用 presign：Wasm service 调 ignis_sdk::object_store，host/control-plane 完成签名，不要把 COS/S3 AK/SK 暴露给 Wasm 或浏览器。公开 feed 图片、头像、公开封面等使用 presign_public_upload，保存返回的稳定 public_url；私有文件、草稿、需鉴权附件继续用 presign_upload + presign_download。平台需要配置 [object_storage] public_bucket 和 public_base_url 后 public URL 才可用。
• Jobs/schedules 是 project automation：在 ignis.hcl 顶层声明 jobs / schedules 后通过 ignis project sync --mode apply 同步；job target 走同项目 HTTP service，不要写任意外部 URL。
• 如果产品需求涉及 LLM、agent、模型调用、结构化生成、工具调用或长任务推理，默认优先使用内部 agent service，而不是在业务 http service 里直接向模型 provider 发 HTTP 请求。
• agent service 是内部任务 agent 容器。OpenCode 用 agent_runtime = "opencode"，发布前在 service 目录放 opencode.json；用 agent_memory 配置记忆模式，必须用 agent_description 描述 agent 能力，供 service discovery、/v1/metadata 和 TaskPlan coordinator 使用；agent 的长期角色说明放在 services/<agent>/AGENTS.md，发布后挂载到 /app/config/AGENTS.md 并追加到内置 one-task 系统提示词；自定义 skills 放在 services/<agent>/skills/<skill>/SKILL.md，发布时会一起进入 agent bundle，并在容器内挂载到 $HOME/.agents/skills；其他 service 通过 http://agent-service.svc/v1/tasks 创建任务，通过 callback 或 GET /v1/tasks/{task_id} 取结果。
• 多 agent 协作不要把编排逻辑写进每个 agent-service。用户 http service 依赖 Ignis 的 taskplan crate，负责 TaskPlan 状态、依赖、output binding 和 child plan 调度；agent-service 只负责 runtime，并通过 tool_callback_url 转发 spawn_task_plan 和 TaskPlan-mode submit_task。业务 service 通过 GET http://__ignis.svc/v1/services 发现同 project services，自行过滤 kind = "agent" 后用 description 组装 available_agents。memory 是 agent-service config，不是 TaskPlan/task 字段。

参考资料

• 接入流程：references/integration.md
• CLI：references/cli.md
• ignis.hcl：references/ignis-hcl.md
• ignis-sdk 生成文档入口：references/ignis-sdk/index.md
• Jobs and schedules：references/jobs-and-schedules.md
• Object-store presign：references/object-store-presign.md
• System API：references/system-api.md
• TaskPlan multi-agent orchestration：references/taskplan.md
• 最小 HTTP 示例项目：references/examples/hello-fullstack/
• SQLite 示例项目：references/examples/sqlite-example/
• COS 上传和jobs，corn使用方式完整示例：references/examples/cos-and-jobs-example/
• OpenCode Math Proof Lab multi-agent theorem proof workflow 示例：references/examples/math-proof-lab/
• 文档索引：references/doc_index.md