@bossmissing/agent-meta 0.3.0 → 0.4.0

package/README.md

@@ -89,6 +89,7 @@ meta check --strict
 | --- | --- | --- |
 | `ironbank` | MCP：`https://test-ib-mcp.hillinsight.tech/mcp` | skills：ironbank-mcp-reference / ironbank-citations / ironbank-docs-research / ironbank-note-links；AGENTS.md 规则：文档与 bug 记录在 IronBank，遇到 `hillinsight://ib_note?...` 深链用 MCP 解析，引用笔记时输出同格式链接 |
 | `playwright` | MCP：`npx @playwright/mcp@latest`（[microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)，浏览器自动化） | — |
+| `dev-env` | skills：dev-env（本地环境约定：项目进程本机启动，redis/mysql/mq 等中间件用 docker compose 启动，compose 只声明中间件） | AGENTS.md 规则：中间件依赖走 Docker，绝不本机全局安装 |
 | `superpowers` | Claude Code 插件（[obra/superpowers](https://github.com/obra/superpowers)，planning/TDD/debugging skills） | AGENTS.md 规则：默认不使用 brainstorming，除非人类明确要求 |
 
 ```bash

package/assets/skills/dev-env/dev-env/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: dev-env
+description: |
+  本地开发 / 测试环境启动约定：项目进程直接本机启动，依赖的中间件
+  （Redis / MySQL / PostgreSQL / Kafka / RabbitMQ 等）通过 Docker 启动。
+  触发条件：用户要求"起本地环境"、"启动开发环境"、"跑集成测试"、
+  "起 redis / mysql / mq"，或应用报中间件连接失败（Connection refused /
+  ECONNREFUSED）需要排查本地依赖时。执行本地环境相关操作前必须先读取本 skill。
+---
+
+# Local Dev Environment（进程本机跑，中间件 Docker 跑）
+
+## 原则
+
+- 项目进程**永远直接在本机启动**（`pnpm dev` 等，见 AGENTS.md 项目命令）：
+  热重载、debugger、IDE 集成都保持可用。
+- 中间件依赖一律用 docker compose 启动，**不在本机全局安装**
+  （不 `brew install mysql`、不 `apt install redis`）。
+- compose 文件只声明中间件，**绝不包含应用本身**。
+
+## 文件约定
+
+- 项目根的 `docker-compose.dev.yml`：每个中间件一个 service，数据挂 named
+  volume，端口映射到 localhost。
+- 项目具体依赖哪些中间件、端口、应用启动命令：以 AGENTS.md 项目命令段和
+  `docs/engineering/testing.md` 为准，本 skill 只定义通用流程。
+- 文件不存在时：先从 AGENTS.md / README / `.env.example` / 配置文件识别项目
+  依赖哪些中间件，生成 compose 模板，并和用户确认版本与端口后再落盘。
+
+## 启动流程
+
+1. `docker info` 确认 Docker 正在运行。
+2. `docker compose -f docker-compose.dev.yml up -d`
+3. 等依赖就绪再起应用：`docker compose ps` 看 `healthy`；没有 healthcheck 的
+   service 用端口探测（`nc -z localhost <port>`）。MySQL/PostgreSQL 首次启动
+   有初始化耗时，连接被拒时先等再重试，不要急着改配置。
+4. 本机启动应用（AGENTS.md 项目命令）。
+5. 跑测试。
+
+## 日常操作
+
+- 状态：`docker compose -f docker-compose.dev.yml ps`
+- 单个中间件日志：`docker compose -f docker-compose.dev.yml logs -f redis`
+- 停止：`docker compose -f docker-compose.dev.yml down`（保留数据卷）
+- 重置数据：`down -v`（会删数据，执行前必须用户确认）
+- 端口冲突：`lsof -i :<port>` 找到占用方，和用户确认后再调整端口映射。
+
+## 硬性规则
+
+- 绝不在本机全局安装中间件；缺什么就加进 compose。
+- `down -v` 或删除数据卷前必须得到用户确认。
+- compose 里的账号密码只用于本地开发，绝不复用任何真实环境的凭据。

package/dist/core/mcp-packs.js

@@ -18,6 +18,14 @@ export const MCP_PACKS = {
         server: { command: "npx", args: ["@playwright/mcp@latest"] },
         hasSkills: false,
     },
+    "dev-env": {
+        name: "dev-env",
+        title: "本地开发环境约定（进程本机跑，redis/mysql/mq 用 Docker）",
+        hasSkills: true,
+        agentRules: [
+            "Local dev/test environment: run the project process directly on the host; start middleware dependencies (redis/mysql/mq) with Docker via the dev-env skill. Never install middleware globally on the host.",
+        ],
+    },
     superpowers: {
         name: "superpowers",
         title: "Superpowers (obra/superpowers, Claude Code plugin: planning/TDD/debugging skills)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bossmissing/agent-meta",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Agent Meta CLI - manage AI agent collaboration metadata (AGENTS.md, domain docs, ADRs, frontmatter checks)",
   "keywords": [
     "cli",