From 95bd1403936c0e5f6c627257aab85551ffa51b8e Mon Sep 17 00:00:00 2001
From: yumoqing <yumoqing@gmail.com>
Date: Mon, 3 Aug 2026 16:46:18 +0800
Subject: [PATCH] docs: add README.md and skill/SKILL.md

---
 README.md      | 28 +++++++++++++++++++++++++++-
 skill/SKILL.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 77 insertions(+), 1 deletion(-)
 create mode 100644 skill/SKILL.md

diff --git a/README.md b/README.md
index 15d5962..27bd8cc 100644
--- a/README.md
+++ b/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 .
+```
diff --git a/skill/SKILL.md b/skill/SKILL.md
new file mode 100644
index 0000000..f3449d0
--- /dev/null
+++ b/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.