feat: 10个通用SDLC概念skill放global(project/iteration/feature/task/deliverable/test-plan/test-case/bug/problem/deploy-env)

skills_library/all/bug/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: bug
+description: 通用缺陷(Bug)概念规范——Bug 定义、通用生命周期、严重度/优先级、与用例/功能/迭代的关系、关闭门禁。agent 处理 Bug 时据此操作。产线可用同名 skill 覆盖。触发：提交/确认/修复/验证/关闭 Bug，或提到缺陷、故障、问题单。
+---
+
+# Bug（通用概念）
+
+## 一、概念定义
+
+Bug = 一个**软件缺陷的追踪单元**，从发现到修复验证闭环。
+Bug 由人工或 agent（reporter_type）提交，指派处理人（assignee_id），修复后验证关闭。
+
+## 二、通用生命周期（状态）
+
+| 状态 | 语义 |
+|---|---|
+| open | 新建 |
+| confirmed | 已确认 |
+| fixing | 修复中 |
+| fixed | 已修复 |
+| verified | 已验证 |
+| closed | 已关闭 |
+| rejected | 已驳回 |
+
+通用流转：open → confirmed → fixing → fixed → verified → closed；open/confirmed 可 → rejected；closed/rejected 可 reopen → open。
+
+## 三、与其他概念的关系
+
+- Bug 挂迭代（iteration_id）。
+- Bug 可关联用例（case_id，失败用例驱动）和功能（feature）。
+- 严重度（severity：critical/major/minor/trivial）与优先级（P0-P3）决定处理顺序。
+
+## 四、门禁（通用）
+
+- `close` 前：Bug 已 verified（修复生效）。
+- 迭代准出：未关闭 Bug 清零（或明确豁免）。
+- `fix` 附修复说明（fix_description）+ 修复提交（fix_commit）。
+
+## 五、配套能力（工具）
+
+规划中的 bug 能力（bug_capability）：
+`report_bug` / `confirm_bug` / `start_fix` / `fix_bug` / `verify_bug` / `close_bug` / `reject_bug` / `reopen_bug` / `list_bugs`。
+未固化前，Bug CRUD 走 xls2ui 端点；状态迁移应收敛到能力模块（CAS + 审计）。
+
+## 六、分层覆盖
+
+本 skill 是**通用**Bug 概念规范；产线可用同名 bug skill 覆盖具体流转与角色权限。

skills_library/all/deliverable/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: deliverable
+description: 通用交付件概念规范——交付件定义、通用评审生命周期、与任务/仓库的关系、评审标准。agent 处理交付件时据此操作。产线可用同名 skill 覆盖。触发：提交/评审/驳回交付件，或提到交付物、产出物、评审。
+---
+
+# 交付件（通用概念）
+
+## 一、概念定义
+
+交付件 = 任务产出的**可评审物**（代码、文档、配置、测试报告等）。
+交付件是任务的直接产出，经评审（approved/rejected）后才算任务完成。
+
+## 二、通用生命周期（评审状态）
+
+| 状态 | 语义 |
+|---|---|
+| pending | 待评审 |
+| approved | 评审通过 |
+| rejected | 评审驳回 |
+
+通用流转：pending → approved / rejected。驳回后修改重新提交回 pending。
+
+## 三、与其他概念的关系
+
+- 交付件挂项目（project_id）+ 可选任务（task_id）。
+- 交付件类型（deliverable_type）：code / doc / config / test-report 等。
+- 交付件可关联仓库（repo_name）+ 仓库内路径（target_path）。
+- 交付件评审状态（review_status）与任务状态（task.state 的 review/approved）联动。
+
+## 四、评审标准（通用）
+
+- 满足对应阶段的需求/设计规格。
+- 代码交付件：可编译、可运行、规范合规。
+- 文档交付件：结构完整、无歧义。
+- 评审附意见（review_comment），驳回时意见必填。
+
+## 五、配套能力（工具）
+
+规划中的 deliverable 能力（deliverable_capability）：
+`submit_deliverable` / `approve_deliverable` / `reject_deliverable` / `list_deliverables`。
+未固化前，交付件 CRUD 走 xls2ui 端点；评审状态迁移应收敛到能力模块（CAS + 审计）。
+
+## 六、分层覆盖
+
+本 skill 是**通用**交付件概念规范；产线可用同名 deliverable skill 覆盖具体评审流程。

skills_library/all/deploy-env/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: deploy-env
+description: 通用部署环境概念规范——部署环境定义、通用生命周期、环境类型、验证标准、发布门禁。agent 处理部署/环境时据此操作。产线可用同名 skill 覆盖。触发：配置/验证部署环境，或提到环境、部署、发布、上线。
+---
+
+# 部署环境（通用概念）
+
+## 一、概念定义
+
+部署环境 = 软件运行的**宿主环境**（服务器、数据库、连接配置），是发布/上线的目标。
+环境是部署动作（deploy）的可追踪实体；发布本体（执行部署）复用任务状态机。
+
+## 二、通用生命周期（状态）
+
+| 状态 | 语义 |
+|---|---|
+| configured | 已配置 |
+| verified | 已验证 |
+| failed | 验证失败 |
+
+通用流转：configured → verified / failed。
+
+## 三、与其他概念的关系
+
+- 环境挂项目（project_id）。
+- 环境类型（env_type）：test / staging / production。
+- 环境含 SSH 连接信息 + 数据库连接（db_* 字段）+ 部署目录（deploy_path）。
+- 部署动作（deploy）目标 = 某环境；发布门禁 = 环境 verified。
+
+## 四、门禁（通用）
+
+- 上线（production）前：环境 verified（连接/权限/依赖可用）。
+- 回滚方案：每个环境应有可回滚的部署方案（deploy-guide）。
+
+## 五、配套能力（工具）
+
+规划中的 deploy 能力（deploy_capability）：
+`configure_env` / `verify_env` / `list_envs`（环境管理）+ 发布动作复用任务状态机（deploy 角色）。
+未固化前，环境 CRUD 走 xls2ui 端点。
+
+## 六、分层覆盖
+
+本 skill 是**通用**部署环境概念规范；产线可用同名 deploy-env skill 覆盖具体发布流程与门禁。

skills_library/all/feature/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: feature
+description: 通用功能/需求概念规范——功能定义、通用生命周期、与迭代/任务/用例/Bug 的关系、验收标准。agent 处理功能时据此操作。产线可用同名 skill 覆盖默认状态机。触发：提出/审批/开发/交付/验证功能，或提到新功能、需求、功能点、验收。
+capability: feature_capability
+tools: [propose_feature, approve_feature, reject_feature, start_feature, deliver_feature, verify_feature, reopen_feature, list_features, set_feature_state]
+---
+
+# 功能/需求（通用概念）
+
+## 一、概念定义
+
+功能 = 一个**可追踪的软件能力单元**，是需求拆解出来的「功能点」。
+功能是迭代 scope、测试用例、Bug 的共同锚点：迭代范围、用例、Bug 都应能挂到 feature 上。
+
+## 二、通用生命周期（状态）
+
+| 状态 | 语义 |
+|---|---|
+| proposed | 已提出（待审批） |
+| approved | 已批准（待开发） |
+| in_progress | 开发中 |
+| delivered | 已交付（待验证） |
+| verified | 已验证（验收通过） |
+| rejected | 已驳回 |
+
+通用流转：proposed → approved → in_progress → delivered → verified；proposed/approved 可 → rejected；rejected/verified 可 reopen 回 proposed。
+
+## 三、与其他概念的关系
+
+- 功能挂 project（project_id）+ 可选 iteration（iteration_id）。
+- 功能 → 任务（task_id）：一个功能可由多个任务实现。
+- 功能 → 测试用例：用例验证功能的验收标准（acceptance_criteria）。
+- 功能 → Bug：开发/测试中发现的缺陷挂回功能。
+
+## 四、门禁（通用）
+
+- `approve` 通过：功能描述清晰 + 验收标准明确。
+- `verify` 通过：满足验收标准，且关联 Bug 全部 verified/closed。
+
+## 五、配套能力（feature 能力工具）
+
+`propose_feature` / `approve_feature` / `reject_feature` / `start_feature` /
+`deliver_feature` / `verify_feature` / `reopen_feature` / `list_features` / `set_feature_state`（CAS 兜底）。
+
+## 六、分层覆盖
+
+本 skill 是**通用**功能概念规范；SDLC 产线默认状态机见 `pipelines/sdlc_general/common/feature`（具体角色权限）。项目可用同名 feature skill 覆盖。

skills_library/all/iteration/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: iteration
+description: 通用迭代概念规范——迭代定义、通用生命周期、与功能/测试计划/Bug 的关系、准入准出门禁。agent 处理迭代时据此操作。产线可用同名 skill 覆盖。触发：创建/启动/完成/取消迭代，或提到迭代、sprint、增量、版本迭代。
+---
+
+# 迭代（通用概念）
+
+## 一、概念定义
+
+迭代 = 项目的一次**增量交付周期**（sprint/版本），把一批功能/修复打包，在固定周期内交付。
+迭代是规划与执行的分组单位，功能、测试计划、Bug 都按迭代组织。
+
+## 二、通用生命周期（状态）
+
+| 状态 | 语义 |
+|---|---|
+| planning | 规划中 |
+| in_progress | 进行中 |
+| completed | 已完成 |
+| cancelled | 已取消 |
+
+通用流转：planning → in_progress → completed；planning/in_progress 可 → cancelled。
+
+## 三、与其他概念的关系
+
+```
+迭代 iteration（挂 project）
+ ├── 功能 feature（1:N，本迭代要交付的能力）
+ ├── 测试计划 test-plan（1:N，本迭代的测试策略）
+ └── Bug bug（1:N，本迭代发现的缺陷）
+```
+
+## 四、门禁（通用）
+
+- **准入**：迭代范围（scope）明确，含可验收的功能清单。
+- **准出**：迭代内功能全部 verified、测试计划 completed、未关闭 Bug 清零（或明确豁免）。
+
+## 五、配套能力（工具）
+
+规划中的 iteration 能力（iteration_capability）：
+`create_iteration` / `start_iteration` / `complete_iteration` / `cancel_iteration` / `list_iterations`。
+未固化前，迭代 CRUD 走 xls2ui 端点；状态迁移应走能力模块（CAS + 审计）。
+
+## 六、分层覆盖
+
+本 skill 是**通用**迭代概念规范；SDLC 产线可用同名 iteration skill 覆盖具体状态机与角色权限。

skills_library/all/problem/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: problem
+description: 通用问题/沟通概念规范——问题定义、冒泡机制、处理方归属、与任务/角色的关系。agent 遇到疑问/阻塞/退回意见时据此处理。产线可用同名 skill 覆盖冒泡路径。触发：发现问题、角色缺信息、审核退回、故障上报、待处理问题>0。
+capability: communication
+tools: [raise_problem, resolve_problem, escalate_problem, list_problems_for]
+---
+
+# 问题（通用概念）
+
+## 一、概念定义
+
+问题 = 协作中的**疑问/阻塞/退回意见**，沿冒泡路径向上传递，直到被解决。
+问题不属于某个角色私有，而是显式路由给「当前处理方」（current_handler_role + agentid）。
+
+## 二、通用生命周期（状态）
+
+| 状态 | 语义 |
+|---|---|
+| pending | 冒泡中（未解决） |
+| answered | 已解决（停止冒泡） |
+
+## 三、冒泡机制（通用）
+
+- **提问题**（raise_problem）：显式指定首处理方（role + agentid）。
+- **查待办**（list_problems_for）：按「当前该我处理」确定性过滤。
+- **解决**（resolve_problem）：停止冒泡，关联任务自动恢复。
+- **转交**（escalate_problem）：答不了，显式转给下一个处理方。
+
+冒泡路径是**规范知识**，不存进数据（改 skill 后历史数据不残留旧路径）。处理方 = role + agentid（agentid 空 = 该角色任意 agent 可处理）。
+
+## 四、与其他概念的关系
+
+- 问题挂项目（tenant_id）+ 可选任务（task_id）。
+- 角色提问可挂起任务（task → waiting），解决后恢复（→ submitted）。
+
+## 五、配套能力（communication 工具）
+
+`raise_problem` / `resolve_problem` / `escalate_problem` / `list_problems_for`。
+
+## 六、分层覆盖
+
+本 skill 是**通用**问题概念规范；SDLC 产线默认冒泡路径（need_info/review_reject/fault_report/approval 各类型路径）见 `pipelines/sdlc_general/common/team-communication`。项目可用同名 skill 覆盖。

skills_library/all/project/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: project
+description: 通用项目概念规范——项目定义、通用生命周期、与迭代/功能/任务/仓库/部署环境的关系。agent 处理项目时据此操作。产线可用同名 skill 覆盖默认状态机。触发：创建/启动/完成/归档项目，或提到项目、工程、软件项目。
+---
+
+# 项目（通用概念）
+
+## 一、概念定义
+
+项目 = 一个软件开发工作的**顶层容器**，聚合该软件的全部迭代、功能、任务、仓库、部署环境。
+项目是租户/组织下的最小交付单元，一切其他概念都挂在 project 下。
+
+## 二、通用生命周期（状态）
+
+| 状态 | 语义 |
+|---|---|
+| draft | 草稿（已创建，未启动） |
+| active | 进行中 |
+| completed | 已完成 |
+| archived | 已归档 |
+
+通用流转：draft → active → completed → archived。归档后可重新激活（archived → active）。
+
+## 三、与其他概念的关系
+
+```
+项目 project
+ ├── 迭代 iteration（1:N，一次增量交付周期）
+ │     ├── 功能 feature
+ │     ├── 测试计划 test-plan
+ │     └── Bug bug
+ ├── 功能 feature（1:N，可追踪的软件能力单元）
+ ├── 任务 task（1:N，工作单元执行实例）
+ ├── 仓库 repository（1:N，代码仓库）
+ └── 部署环境 deploy-env（1:N，运行宿主）
+```
+
+- 功能、任务、Bug 都挂 project_id（或经 iteration 间接挂）。
+- 项目可关联产线定义（pipeline_id），决定该项目的开发流程/角色/工具集。
+
+## 四、配套能力（工具）
+
+规划中的 project 能力（project_capability）：
+`create_project` / `start_project` / `complete_project` / `archive_project` / `reopen_project` / `list_projects`。
+未固化为工具前，项目 CRUD 走 xls2ui 生成的端点；状态迁移应走能力模块（CAS + 审计）。
+
+## 五、分层覆盖
+
+本 skill 是**通用**项目概念规范；SDLC 产线可用同名 project skill 覆盖（在 pipelines/{id}/common/）定义具体状态机与角色权限。加载优先级（低→高）：global → org → pipeline(common) → role → project → user。

skills_library/all/task/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: task
+description: 通用任务概念规范——任务定义、通用生命周期（认领/执行/审核/完成/挂起/失败/重试）、角色操作权限。agent 处理任务时据此操作。产线可用同名 skill 覆盖默认状态机。触发：认领/提交/审核/退回/完成/重试任务，或提到任务、工作项。
+capability: task_capability
+tools: [claim_task, submit_task, approve_task, reject_task, complete_task, mark_failed, retry_task, suspend_task, revive_task, set_task_state]
+---
+
+# 任务（通用概念）
+
+## 一、概念定义
+
+任务 = 一个**工作单元的执行实例**，沿状态机流转，由某个角色/agent 认领执行、产出交付件、经审核。
+状态存表，流转规则在本 skill（LLM 读后判断合法性）；工具只做 CAS 原子迁移，不校验合法性。
+
+## 二、通用生命周期（状态）
+
+| 状态 | 语义 |
+|---|---|
+| submitted | 待认领（新任务 / 退回后重新认领） |
+| running | 执行中 |
+| review | 已提交产出，待审核 |
+| approved | 审核通过 |
+| completed | 全流程完成 |
+| waiting | 挂起等回答 |
+| failed | 失败 |
+
+通用流转：submitted →(claim)→ running →(submit)→ review →(approve)→ approved →(complete)→ completed；
+running →(suspend)→ waiting →(revive)→ submitted；任意执行失败 → failed →(retry)→ submitted。
+
+## 三、与其他概念的关系
+
+- 任务挂项目（tenant_id/project_id）+ 角色（role）。
+- 任务产出交付件（deliverable），交付件经评审（review_status）。
+- 角色执行中缺信息/被退回 → 提问题（problem，见 problem 概念）冒泡。
+
+## 四、角色 → 操作权限（业务级 RBAC，通用模式）
+
+执行角色（开发/测试/部署等）认领、提交；审核角色（PM）approve/reject/complete；人角色最终兜底审批。
+
+## 五、配套能力（task 能力工具）
+
+`claim_task` / `submit_task` / `approve_task` / `reject_task` / `complete_task` /
+`mark_failed` / `retry_task` / `suspend_task` / `revive_task` / `set_task_state`（CAS 兜底）。
+
+## 六、分层覆盖
+
+本 skill 是**通用**任务概念规范；SDLC 产线默认状态机见 `pipelines/sdlc_general/common/task`（具体角色：agent.pm 审核、agent.develop 执行等）。项目可用同名 task skill 覆盖。

skills_library/all/test-case/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: test-case
+description: 通用测试用例概念规范——测试用例定义、通用执行生命周期、失败用例如何联动建 Bug。agent 处理测试用例时据此操作。产线可用同名 skill 覆盖。触发：创建/执行用例，或提到用例、测试点、验证步骤、预期结果。
+---
+
+# 测试用例（通用概念）
+
+## 一、概念定义
+
+测试用例 = 一个**可执行的验证单元**：前置条件（precondition）+ 步骤（steps）+ 预期结果（expected_result）。
+用例是验证功能验收标准的最小单位，执行后记录实际结果与状态。
+
+## 二、通用生命周期（执行状态）
+
+| 状态 | 语义 |
+|---|---|
+| pending | 待执行 |
+| pass | 通过 |
+| fail | 失败 |
+| blocked | 阻塞 |
+| skipped | 跳过 |
+
+通用流转：pending → pass / fail / blocked / skipped。
+
+## 三、与其他概念的关系
+
+- 用例挂测试计划（plan_id），间接挂迭代。
+- 用例关联功能（验收标准）。
+- **失败用例 → 建 Bug**：用例 fail 时，应创建关联 Bug（Bug 的 case_id 指向用例），走 bug 生命周期闭环。
+
+## 四、执行规范（通用）
+
+- 执行记录 executed_by / executed_at / duration_ms。
+- 实际结果（actual_result）与预期不符 → 判定 fail。
+- 因环境/依赖无法执行 → blocked；有意不测 → skipped（须注明原因）。
+
+## 五、配套能力（工具）
+
+规划中的 test-case 能力（test_case_capability）：
+`create_case` / `pass_case` / `fail_case` / `skip_case` / `block_case` / `list_cases`。
+未固化前，用例 CRUD 走 xls2ui 端点；执行状态迁移应收敛到能力模块（CAS + 审计）。
+
+## 六、分层覆盖
+
+本 skill 是**通用**测试用例概念规范；产线可用同名 test-case skill 覆盖具体执行流程。

skills_library/all/test-plan/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: test-plan
+description: 通用测试计划概念规范——测试计划定义、通用生命周期、准入准出条件、与迭代/用例的关系。agent 处理测试计划时据此操作。产线可用同名 skill 覆盖。触发：创建/审批/执行/完成测试计划，或提到测试方案、测试策略、测试范围。
+---
+
+# 测试计划（通用概念）
+
+## 一、概念定义
+
+测试计划 = 一次**测试活动**的策略定义：范围（scope）、环境要求、准入/准出条件。
+测试计划是测试用例的分组单位，一次迭代通常有一个测试计划。
+
+## 二、通用生命周期（状态）
+
+| 状态 | 语义 |
+|---|---|
+| draft | 草稿 |
+| approved | 已审批 |
+| executing | 执行中 |
+| completed | 已完成 |
+
+通用流转：draft → approved → executing → completed。
+
+## 三、与其他概念的关系
+
+- 测试计划挂迭代（iteration_id）。
+- 测试计划 → 测试用例（test-case，1:N，plan_id 关联）。
+- 准入条件（entry_criteria）：开始执行测试的前置条件。
+- 准出条件（exit_criteria）：测试结束的标准，是迭代完成的 gate 之一。
+
+## 四、门禁（通用）
+
+- 准出：计划内用例全部执行（pending 清零），失败用例已建 Bug 并闭环。
+
+## 五、配套能力（工具）
+
+规划中的 test-plan 能力（test_plan_capability）：
+`create_test_plan` / `approve_plan` / `start_plan` / `complete_plan` / `list_plans`。
+未固化前，测试计划 CRUD 走 xls2ui 端点；状态迁移应收敛到能力模块（CAS + 审计）。
+
+## 六、分层覆盖
+
+本 skill 是**通用**测试计划概念规范；产线可用同名 test-plan skill 覆盖具体流程。