@lark-apaas/coding-steering

Stack-specific steering content for miaoda coding templates.

Consumed by miaoda-cli at app init time and synced into the user project's .agent/steering/. Not a runtime dependency — no entry in user package.json.

Layout

steering/
├── _common/
│   └── skills/                    # cross-stack shared skills
├── <stack>/
│   ├── tech.md                    # always-loaded, injected into agent system prompt
│   ├── skills/<id>/SKILL.md       # progressive disclosure, triggered by description match
│   └── skills_local/<id>/SKILL.md # local-only variant; overrides skills/<id> when syncing
│                                  #   to a local-dev project (e.g. via lark-cli)
└── ...

Top-level directory names (other than _common) ARE the stackId — discovery is by directory convention, no central manifest.

Supported stacks

Each top-level directory under steering/ is one stack. A stack here is independent of the template package of the same name — steering may carry a stackId that has no template yet (and vice versa). Current state:

| stackId (directory) | What it is | tech.md | skills/ | template package | |---|---|---|---|---| | vite-react | React + Vite SPA | ✅ | plugin-guide, react-three-fiber | coding-template-vite-react | | html | 妙搭 html，带 devserver | ✅ | rich-interactive-design | coding-template-html | | nestjs-react-fullstack | NestJS + React 全栈 | — | authn/authz/feishu/plugin/devops/trigger/user-* … + skills_local/ (code-fix, coding-guide) | coding-template-nestjs-react-fullstack | | design-html | 无构建纯静态 HTML 托管（源码即产物，类 Claude Design） | — | （占位，待补） | coding-template-design-html | | design-stack | 带构建的 design / 创意栈（有工具链，区别于 buildless 的 design-html） | — | （占位，待补） | （暂无） |

design-html 与 design-stack 是两个有意分开的 design 栈：前者无构建、纯静态托管； 后者带构建步骤（工具链驱动）。两者均为独立 stackId，不要合并。

新增 stack 见 adding-new-stack.md。

Sync mapping (executed by miaoda-cli)

| Source in this package | Destination in user project | |---|---| | steering/<stack>/tech.md | .agent/steering/tech.md | | steering/<stack>/skills/<id>/** | .agent/steering/skills/<id>/** | | steering/<stack>/skills_local/<id>/** | .agent/steering/skills/<id>/** (local-dev sync only) | | steering/_common/skills/<id>/** | .agent/steering/skills/<id>/** |

Precedence when the same <id> exists in multiple sources (lowest → highest, later wins): _common/skills → <stack>/skills → <stack>/skills_local (local-dev sync only).

skills_local is a stack-specific variant intended for the local-development sync path (miaoda skills sync --local, driven by lark-cli apps). The cloud sandbox sync path ignores skills_local and uses skills as-is, so authors of skills_local content can assume "本地 agent" semantics (no ddl_sql / plugin_instance / sandbox-log tools, etc.).

Writing rules

See steering-authoring-rules.md. Core principles:

• Forward-compatible always: never break old usage, only @deprecated it
• Latest is safe: existing user projects can always pull the latest version
• Describe by current structure: when introducing version-dependent guidance, write for the stack's current layout

License

MIT — see LICENSE.