AgentSkillsCN

lcp-openai-serve

开发应用/openai-serve（Go）。保持 OpenAI 网关行为正确，避免记录提示/输出。

SKILL.md
--- frontmatter
name: lcp-openai-serve
description: Develop apps/openai-serve (Go). Keep OpenAI gateway behavior correct and avoid logging prompts/outputs.
metadata:
  short-description: Work on the OpenAI-compatible gateway

You are working on the OpenAI-compatible HTTP gateway in apps/openai-serve/.

Scope

  • •Module: apps/openai-serve/
  • •Runtime contract: apps/openai-serve/README.md

Development principles

These are the consolidated rules that previously lived in apps/openai-serve/AGENTS.md:

  1. •Design for robustness. Keep modules aligned with SRP.
  2. •Use a ubiquitous language. Keep terminology consistent across code and docs.
  3. •Test-first. Prefer TDD when changing behavior.
  4. •Run golangci-lint v2. When changing code, run make lint and fix findings.
  5. •Use cmp.Diff in tests. Compare expected vs actual with github.com/google/go-cmp/cmp.Diff.
  6. •Make logging diagnosable. Logging level MUST be configurable (for example via env vars).
  7. •Prefer lnd libraries. Use lnd-provided APIs/libraries before re-implementing.

Non-negotiables

  • •Logging is sensitive: do not log raw prompts (messages[].content) or raw model outputs.
  • •Keep behavior stable and explicit: JSON decoding is strict, unsupported fields must be rejected as documented.

Workflow

  1. •Read apps/openai-serve/README.md before changing behavior.
  2. •When adding config/env vars, document them in apps/openai-serve/README.md and keep defaults sane.
  3. •When changing request/response structures, update tests and ensure the documented constraints still hold.

Validation (run from apps/openai-serve/)

  • •make test
  • •make lint
  • •make fmt