docs: add README.md and skill/SKILL.md

README.md

@@ -1,2 +1,28 @@
-# pipeline-sdlc
+# pipeline_sdlc
 
+SDLC 模块 —— 项目管理、迭代计划、Bug追踪、测试管理、AI 驾驶舱。
+
+## 功能
+
+- **项目管理**：软件项目 CRUD
+- **迭代管理**：迭代计划与进度
+- **Bug 追踪**：Bug 提交/确认/关闭（human / agent）
+- **测试管理**：测试计划与用例
+- **AI Cockpit**：自然语言驱动开发驾驶舱
+
+## 数据表
+
+| 表 | 说明 |
+|---|------|
+| sd_projects | 项目定义 |
+| sd_iterations | 迭代计划 |
+| sd_bugs | Bug 追踪 |
+| sd_test_plans | 测试计划 |
+| sd_test_cases | 测试用例 |
+| sd_deploy_envs | 部署环境 |
+
+## 安装
+
+```bash
+cd pkgs/pipeline-sdlc && pip install .
+```

skill/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: pipeline-sdlc
+description: "SDLC module — project management, iterations, bug tracking, test management, and AI cockpit."
+---
+
+# pipeline_sdlc
+
+Complete SDLC lifecycle management with AI-powered development cockpit.
+
+## Architecture
+
+```
+pipeline_sdlc/
+├── pipeline_sdlc/
+│   ├── init.py              # load_pipeline_sdlc()
+│   ├── adapter.py           # LLM context + model management
+│   └── handlers/
+│       ├── design.py        # Design phase agent
+│       ├── develop.py       # Coding phase agent
+│       ├── test.py          # Testing phase agent
+│       ├── deploy.py        # Deployment phase agent
+│       └── ops.py           # Operations phase agent
+├── wwwroot/
+│   ├── api/
+│   │   ├── cockpit_agent.dspy   # Agent task execution
+│   │   ├── cockpit_chat.dspy    # Chat + auto-execute
+│   │   ├── cockpit_cards.dspy   # Dashboard stats
+│   │   └── bug_*.dspy           # Bug operations
+│   └── sd_cockpit/index.ui      # Cockpit main UI
+```
+
+## Key DSPY Endpoints
+
+### Cockpit (AI Development)
+- `cockpit_agent.dspy` — Agent-driven task execution
+- `cockpit_chat.dspy` — Chat with auto-execute
+- `cockpit_cards.dspy` — Dashboard statistics
+
+### Bug Management
+- `bug_confirm.dspy` — Confirm bug
+- `bug_close.dspy` — Close bug
+- `check_iteration_bugs.dspy` — Pre-close bug check
+
+## Pitfalls
+
+- **Cockpit LLM calls**: Uses `pipeline_service.llm_bridge.llm_call()` via ServerEnv.
+- **Workspace isolation**: Each project has `workspace_dir` — agent file ops scoped here.
+- **Deliverable storage**: Agent outputs saved to `pipeline_deliverables` with quality scores.
+- CRUD generated dirs are auto-generated by xls2ui — never edit directly.
+- `index_cockpit.ui` is the new cockpit entry — ensure RBAC registered.