feat: 7个SDLC状态机skill(project/iteration/deliverable/test-plan/test-case/bug/deploy-env) + 概念skill补capability/tools frontmatter

2026-08-17 11:00:15 +08:00 · 2026-08-17 11:00:15 +08:00 · 13769e5515
commit 13769e5515
parent 0e026e6d81
14 changed files with 554 additions and 21 deletions
--- a/skills_library/all/bug/SKILL.md
+++ b/skills_library/all/bug/SKILL.md
@ -1,6 +1,8 @@
 ---
 name: bug
 description: 通用缺陷(Bug)概念规范——Bug 定义、通用生命周期、严重度/优先级、与用例/功能/迭代的关系、关闭门禁。agent 处理 Bug 时据此操作。产线可用同名 skill 覆盖。触发：提交/确认/修复/验证/关闭 Bug，或提到缺陷、故障、问题单。
+capability: bug_capability
+tools: [report_bug, confirm_bug, start_fix, fix_bug, verify_bug, close_bug, reject_bug, reopen_bug, list_bugs, set_bug_state]
 ---

 # Bug（通用概念）
@ -38,9 +40,9 @@ Bug 由人工或 agent（reporter_type）提交，指派处理人（assignee_id

 ## 五、配套能力（工具）

-规划中的 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 + 审计）。
+已固化的 bug 能力（bug_capability）：
+`report_bug` / `confirm_bug` / `start_fix` / `fix_bug` / `verify_bug` / `close_bug` / `reject_bug` / `reopen_bug` / `list_bugs` / `set_bug_state`（CAS 兜底）。
+状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

 ## 六、分层覆盖

--- a/skills_library/all/deliverable/SKILL.md
+++ b/skills_library/all/deliverable/SKILL.md
@ -1,6 +1,8 @@
 ---
 name: deliverable
 description: 通用交付件概念规范——交付件定义、通用评审生命周期、与任务/仓库的关系、评审标准。agent 处理交付件时据此操作。产线可用同名 skill 覆盖。触发：提交/评审/驳回交付件，或提到交付物、产出物、评审。
+capability: deliverable_capability
+tools: [submit_deliverable, approve_deliverable, reject_deliverable, reopen_deliverable, list_deliverables, set_deliverable_state]
 ---

 # 交付件（通用概念）
@ -36,9 +38,9 @@ description: 通用交付件概念规范——交付件定义、通用评审生

 ## 五、配套能力（工具）

-规划中的 deliverable 能力（deliverable_capability）：
-`submit_deliverable` / `approve_deliverable` / `reject_deliverable` / `list_deliverables`。
-未固化前，交付件 CRUD 走 xls2ui 端点；评审状态迁移应收敛到能力模块（CAS + 审计）。
+已固化的 deliverable 能力（deliverable_capability）：
+`submit_deliverable` / `approve_deliverable` / `reject_deliverable` / `reopen_deliverable` / `list_deliverables` / `set_deliverable_state`（CAS 兜底）。
+状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

 ## 六、分层覆盖

--- a/skills_library/all/deploy-env/SKILL.md
+++ b/skills_library/all/deploy-env/SKILL.md
@ -1,6 +1,8 @@
 ---
 name: deploy-env
 description: 通用部署环境概念规范——部署环境定义、通用生命周期、环境类型、验证标准、发布门禁。agent 处理部署/环境时据此操作。产线可用同名 skill 覆盖。触发：配置/验证部署环境，或提到环境、部署、发布、上线。
+capability: deploy_capability
+tools: [configure_env, verify_env, fail_env, list_envs, set_env_state]
 ---

 # 部署环境（通用概念）
@ -34,9 +36,9 @@ description: 通用部署环境概念规范——部署环境定义、通用生

 ## 五、配套能力（工具）

-规划中的 deploy 能力（deploy_capability）：
-`configure_env` / `verify_env` / `list_envs`（环境管理）+ 发布动作复用任务状态机（deploy 角色）。
-未固化前，环境 CRUD 走 xls2ui 端点。
+已固化的 deploy-env 能力（deploy_capability）：
+`configure_env` / `verify_env` / `fail_env` / `list_envs` / `set_env_state`（CAS 兜底）。
+状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

 ## 六、分层覆盖

--- a/skills_library/all/iteration/SKILL.md
+++ b/skills_library/all/iteration/SKILL.md
@ -1,6 +1,8 @@
 ---
 name: iteration
 description: 通用迭代概念规范——迭代定义、通用生命周期、与功能/测试计划/Bug 的关系、准入准出门禁。agent 处理迭代时据此操作。产线可用同名 skill 覆盖。触发：创建/启动/完成/取消迭代，或提到迭代、sprint、增量、版本迭代。
+capability: iteration_capability
+tools: [create_iteration, start_iteration, complete_iteration, cancel_iteration, list_iterations, set_iteration_state]
 ---

 # 迭代（通用概念）
@ -37,9 +39,9 @@ description: 通用迭代概念规范——迭代定义、通用生命周期、

 ## 五、配套能力（工具）

-规划中的 iteration 能力（iteration_capability）：
-`create_iteration` / `start_iteration` / `complete_iteration` / `cancel_iteration` / `list_iterations`。
-未固化前，迭代 CRUD 走 xls2ui 端点；状态迁移应走能力模块（CAS + 审计）。
+已固化的 iteration 能力（iteration_capability）：
+`create_iteration` / `start_iteration` / `complete_iteration` / `cancel_iteration` / `list_iterations` / `set_iteration_state`（CAS 兜底）。
+状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

 ## 六、分层覆盖

--- a/skills_library/all/project/SKILL.md
+++ b/skills_library/all/project/SKILL.md
@ -1,6 +1,8 @@
 ---
 name: project
 description: 通用项目概念规范——项目定义、通用生命周期、与迭代/功能/任务/仓库/部署环境的关系。agent 处理项目时据此操作。产线可用同名 skill 覆盖默认状态机。触发：创建/启动/完成/归档项目，或提到项目、工程、软件项目。
+capability: project_capability
+tools: [create_project, start_project, complete_project, archive_project, reopen_project, list_projects, set_project_state]
 ---

 # 项目（通用概念）
@ -40,9 +42,9 @@ description: 通用项目概念规范——项目定义、通用生命周期、

 ## 四、配套能力（工具）

-规划中的 project 能力（project_capability）：
-`create_project` / `start_project` / `complete_project` / `archive_project` / `reopen_project` / `list_projects`。
-未固化为工具前，项目 CRUD 走 xls2ui 生成的端点；状态迁移应走能力模块（CAS + 审计）。
+已固化的 project 能力（project_capability）：
+`create_project` / `start_project` / `complete_project` / `archive_project` / `reopen_project` / `list_projects` / `set_project_state`（CAS 兜底）。
+状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

 ## 五、分层覆盖

--- a/skills_library/all/test-case/SKILL.md
+++ b/skills_library/all/test-case/SKILL.md
@ -1,6 +1,8 @@
 ---
 name: test-case
 description: 通用测试用例概念规范——测试用例定义、通用执行生命周期、失败用例如何联动建 Bug。agent 处理测试用例时据此操作。产线可用同名 skill 覆盖。触发：创建/执行用例，或提到用例、测试点、验证步骤、预期结果。
+capability: test_case_capability
+tools: [create_case, pass_case, fail_case, skip_case, block_case, list_cases, set_case_state]
 ---

 # 测试用例（通用概念）
@ -36,9 +38,9 @@ description: 通用测试用例概念规范——测试用例定义、通用执

 ## 五、配套能力（工具）

-规划中的 test-case 能力（test_case_capability）：
-`create_case` / `pass_case` / `fail_case` / `skip_case` / `block_case` / `list_cases`。
-未固化前，用例 CRUD 走 xls2ui 端点；执行状态迁移应收敛到能力模块（CAS + 审计）。
+已固化的 test-case 能力（test_case_capability）：
+`create_case` / `pass_case` / `fail_case` / `skip_case` / `block_case` / `list_cases` / `set_case_state`（CAS 兜底）。
+状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

 ## 六、分层覆盖

--- a/skills_library/all/test-plan/SKILL.md
+++ b/skills_library/all/test-plan/SKILL.md
@ -1,6 +1,8 @@
 ---
 name: test-plan
 description: 通用测试计划概念规范——测试计划定义、通用生命周期、准入准出条件、与迭代/用例的关系。agent 处理测试计划时据此操作。产线可用同名 skill 覆盖。触发：创建/审批/执行/完成测试计划，或提到测试方案、测试策略、测试范围。
+capability: test_plan_capability
+tools: [create_test_plan, approve_plan, start_plan, complete_plan, list_plans, set_plan_state]
 ---

 # 测试计划（通用概念）
@ -34,9 +36,9 @@ description: 通用测试计划概念规范——测试计划定义、通用生

 ## 五、配套能力（工具）

-规划中的 test-plan 能力（test_plan_capability）：
-`create_test_plan` / `approve_plan` / `start_plan` / `complete_plan` / `list_plans`。
-未固化前，测试计划 CRUD 走 xls2ui 端点；状态迁移应收敛到能力模块（CAS + 审计）。
+已固化的 test-plan 能力（test_plan_capability）：
+`create_test_plan` / `approve_plan` / `start_plan` / `complete_plan` / `list_plans` / `set_plan_state`（CAS 兜底）。
+状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

 ## 六、分层覆盖

--- a/skills_library/pipelines/sdlc_general/common/bug/SKILL.md
+++ b/skills_library/pipelines/sdlc_general/common/bug/SKILL.md
@ -0,0 +1,89 @@
+---
+name: bug
+description: SDLC 产线默认 Bug 状态机规范——定义 Bug 状态、合法流转、角色→操作权限、严重度/优先级、关闭门禁。agent 处理 Bug 时据此操作，LLM 读本 skill 判断流转合法性。项目可同名 skill 覆盖。触发：上报/确认/修复/验证/关闭/驳回 Bug。
+capability: bug_capability
+tools: [report_bug, confirm_bug, start_fix, fix_bug, verify_bug, close_bug, reject_bug, reopen_bug, list_bugs, set_bug_state]
+---
+
+# Bug 状态机规范（SDLC 产线默认）
+
+本 skill 是**规范**（Bug 状态 + 流转规则 + 严重度/优先级 + 关闭门禁）。Bug 操作由系统固化的 **bug 能力**（工具）执行，
+本 skill 描述这些工具该怎么用、什么时候能用。
+
+## 一、核心模型
+
+- Bug = 一个软件缺陷的追踪单元，从发现到修复验证闭环。
+- **状态存表**（sd_bugs.status），**流转规则在本 skill**（LLM 读后判断合法性）。
+- 工具只做 CAS 原子迁移（`WHERE id=... AND iteration_id=... AND status IN (...)`），**不校验合法性**。
+- 每次迁移自动写审计（audit_log，append-only）。
+
+## 二、Bug 状态（SDLC 默认）
+
+| 状态 | 语义 |
+|---|---|
+| open | 新建 |
+| confirmed | 已确认 |
+| fixing | 修复中 |
+| fixed | 已修复 |
+| verified | 已验证 |
+| closed | 已关闭 |
+| rejected | 已驳回 |
+
+## 三、合法流转图
+
+```
+open ──confirm──▶ confirmed ──start_fix──▶ fixing ──fix──▶ fixed ──verify──▶ verified ──close──▶ closed
+  │                     │
+  │ reject              │ reject
+  ▼                     ▼
+rejected ◀─────────────────────────────────────────────────────────────┘
+   ▲                              ▲
+   │                              │
+   └────────── reopen ────────────┘  (closed/rejected → open)
+```
+
+明确规则：
+- `report`：新建 → open。
+- `confirm`：open → confirmed。
+- `start_fix`：confirmed → fixing（记录处理人）。
+- `fix`：fixing → fixed（附修复说明 fix_description + fix_commit）。
+- `verify`：fixed → verified（记录验证人）。
+- `close`：verified → closed（记录关闭时间）。
+- `reject`：open/confirmed → rejected（附意见）。
+- `reopen`：closed/rejected → open。
+
+## 四、角色 → 操作权限（业务级 RBAC）
+
+| 角色 | 可执行操作 |
+|---|---|
+| agent.test | report / verify / close（上报、验证、关闭） |
+| agent.develop | start_fix / fix（修复） |
+| agent.pm | confirm / reject / reopen（确认、驳回、重开） |
+| agent.main_agent | 代客户上报/推进 Bug |
+| owner.superuser（人） | 最终裁决兜底 |
+
+## 五、严重度与优先级
+
+- 严重度（severity）：critical / major / minor / trivial。
+- 优先级（priority）：P0 / P1 / P2 / P3。
+- 处理顺序按严重度 + 优先级排序。
+
+## 六、门禁
+
+- `close` 前：Bug 已 verified（修复生效）。
+- 迭代准出：未关闭 Bug 清零（或明确豁免，见 iteration skill）。
+
+## 七、人拍板点（human gate）
+
+需要人裁决（如 Bug 驳回争议、关闭豁免）时，**不直接改状态**，而是走问题冒泡到 `owner.superuser`
+（见 team-communication skill，problem_type 用 approval/confirm）。人答复后由 agent 再执行状态迁移。
+
+## 八、配套能力（bug 能力工具）
+
+`report_bug` / `confirm_bug` / `start_fix` / `fix_bug` / `verify_bug` /
+`close_bug` / `reject_bug` / `reopen_bug` / `list_bugs` / `set_bug_state`（通用 CAS 兜底）。
+
+## 九、分层覆盖
+
+本 skill 是 **SDLC 产线默认**状态机；项目可用**同名 bug skill** 覆盖具体流转与角色权限。
+加载优先级（低→高）：global → org → pipeline(common) → role → project → user。
--- a/skills_library/pipelines/sdlc_general/common/deliverable/SKILL.md
+++ b/skills_library/pipelines/sdlc_general/common/deliverable/SKILL.md
@ -0,0 +1,72 @@
+---
+name: deliverable
+description: SDLC 产线默认交付件评审状态机规范——定义评审状态、合法流转、角色→操作权限、评审标准。agent 处理交付件时据此操作，LLM 读本 skill 判断流转合法性。项目可同名 skill 覆盖。触发：提交/评审/驳回交付件。
+capability: deliverable_capability
+tools: [submit_deliverable, approve_deliverable, reject_deliverable, reopen_deliverable, list_deliverables, set_deliverable_state]
+---
+
+# 交付件评审状态机规范（SDLC 产线默认）
+
+本 skill 是**规范**（交付件评审状态 + 流转规则 + 评审标准）。交付件操作由系统固化的 **deliverable 能力**（工具）执行，
+本 skill 描述这些工具该怎么用、什么时候能用。
+
+## 一、核心模型
+
+- 交付件 = 任务产出的可评审物（代码/文档/配置/测试报告），经评审通过才算任务完成。
+- **状态存表**（pipeline_deliverables.review_status），**流转规则在本 skill**（LLM 读后判断合法性）。
+- 工具只做 CAS 原子迁移（`WHERE id=... AND project_id=... AND review_status=from`），**不校验合法性**。
+- 每次迁移自动写审计（audit_log，append-only）。
+
+## 二、评审状态（SDLC 默认）
+
+| 状态 | 语义 |
+|---|---|
+| pending | 待评审 |
+| approved | 评审通过 |
+| rejected | 评审驳回 |
+
+## 三、合法流转图
+
+```
+         submit              approve
+(新建) ───────▶ pending ───────────▶ approved
+                  │  ▲
+        reject    │  │  reopen
+                  ▼  │
+               rejected
+```
+
+明确规则：
+- `submit`：新建 → pending。
+- `approve`：pending → approved。
+- `reject`：pending → rejected（意见必填）。
+- `reopen`：rejected → pending（修改后重新提交评审）。
+
+## 四、角色 → 操作权限（业务级 RBAC）
+
+| 角色 | 可执行操作 |
+|---|---|
+| agent.develop / agent.design / agent.test / agent.deploy | submit（提交交付件） |
+| agent.pm | approve / reject（评审把关） |
+| agent.main_agent | 代客户提交、评审 |
+| owner.superuser（人） | 最终评审兜底 |
+
+## 五、评审标准（门禁）
+
+- `approve`：满足对应阶段需求/设计规格；代码可编译可运行；文档结构完整无歧义。
+- `reject`：附评审意见（review_comment 必填）。
+
+## 六、人拍板点（human gate）
+
+需要人评审时，**不直接改状态**，而是走问题冒泡到 `owner.superuser`
+（见 team-communication skill，problem_type 用 approval/confirm）。人答复后由 agent 再执行状态迁移。
+
+## 七、配套能力（deliverable 能力工具）
+
+`submit_deliverable` / `approve_deliverable` / `reject_deliverable` /
+`reopen_deliverable` / `list_deliverables` / `set_deliverable_state`（通用 CAS 兜底）。
+
+## 八、分层覆盖
+
+本 skill 是 **SDLC 产线默认**状态机；项目可用**同名 deliverable skill** 覆盖评审流程。
+加载优先级（低→高）：global → org → pipeline(common) → role → project → user。
--- a/skills_library/pipelines/sdlc_general/common/deploy-env/SKILL.md
+++ b/skills_library/pipelines/sdlc_general/common/deploy-env/SKILL.md
@ -0,0 +1,75 @@
+---
+name: deploy-env
+description: SDLC 产线默认部署环境状态机规范——定义环境状态、合法流转、角色→操作权限、验证标准、发布门禁。agent 处理部署环境时据此操作，LLM 读本 skill 判断流转合法性。项目可同名 skill 覆盖。触发：配置/验证部署环境。
+capability: deploy_capability
+tools: [configure_env, verify_env, fail_env, list_envs, set_env_state]
+---
+
+# 部署环境状态机规范（SDLC 产线默认）
+
+本 skill 是**规范**（环境状态 + 流转规则 + 验证标准 + 发布门禁）。环境操作由系统固化的 **deploy 能力**（工具）执行，
+本 skill 描述这些工具该怎么用、什么时候能用。
+发布本体（执行部署动作）复用 task 状态机（deploy 角色）；本能力管「环境」这个可追踪实体。
+
+## 一、核心模型
+
+- 部署环境 = 软件运行的宿主环境（服务器/数据库/连接配置），是发布/上线的目标。
+- **状态存表**（sd_deploy_envs.status），**流转规则在本 skill**（LLM 读后判断合法性）。
+- 工具只做 CAS 原子迁移（`WHERE id=... AND project_id=... AND status IN (...)`），**不校验合法性**。
+- 每次迁移自动写审计（audit_log，append-only）。
+
+## 二、环境状态（SDLC 默认）
+
+| 状态 | 语义 |
+|---|---|
+| configured | 已配置 |
+| verified | 已验证 |
+| failed | 验证失败 |
+
+## 三、合法流转图
+
+```
+              verify(成功)
+configured ───────────────▶ verified
+    │                          │
+    │ verify(失败)             │ fail
+    ▼                          ▼
+failed ◀────────────────────────┘
+```
+
+明确规则：
+- `configure`：新建 → configured。
+- `verify`（成功）：configured/failed → verified（记录验证时间）。
+- `fail`（验证失败）：configured/verified → failed（附失败原因）。
+
+## 四、角色 → 操作权限（业务级 RBAC）
+
+| 角色 | 可执行操作 |
+|---|---|
+| agent.deploy | configure / verify / fail（配置与验证环境） |
+| agent.main_agent | 代客户配置/验证环境 |
+| owner.superuser（人） | 生产环境验证确认兜底 |
+
+## 五、环境类型
+
+- env_type：test / staging / production。
+- 环境含 SSH 连接信息（host/port/user/ssh_key_path）+ 数据库连接（db_*）+ 部署目录（deploy_path）。
+
+## 六、门禁（发布门禁）
+
+- 上线（production）前：环境 verified（连接/权限/依赖可用）。
+- 回滚方案：每个环境应有可回滚的部署方案（deploy-guide）。
+
+## 七、人拍板点（human gate）
+
+生产环境验证/上线确认时，**不直接改状态**，而是走问题冒泡到 `owner.superuser`
+（见 team-communication skill，problem_type 用 approval/confirm）。人答复后由 agent 再执行状态迁移。
+
+## 八、配套能力（deploy 能力工具）
+
+`configure_env` / `verify_env` / `fail_env` / `list_envs` / `set_env_state`（通用 CAS 兜底）。
+
+## 九、分层覆盖
+
+本 skill 是 **SDLC 产线默认**状态机；项目可用**同名 deploy-env skill** 覆盖具体发布流程与门禁。
+加载优先级（低→高）：global → org → pipeline(common) → role → project → user。
--- a/skills_library/pipelines/sdlc_general/common/iteration/SKILL.md
+++ b/skills_library/pipelines/sdlc_general/common/iteration/SKILL.md
@ -0,0 +1,71 @@
+---
+name: iteration
+description: SDLC 产线默认迭代状态机规范——定义迭代状态、合法流转、角色→操作权限、准入准出门禁。agent 处理迭代时据此操作，LLM 读本 skill 判断流转合法性。项目可同名 skill 覆盖。触发：创建/启动/完成/取消迭代。
+capability: iteration_capability
+tools: [create_iteration, start_iteration, complete_iteration, cancel_iteration, list_iterations, set_iteration_state]
+---
+
+# 迭代状态机规范（SDLC 产线默认）
+
+本 skill 是**规范**（迭代状态 + 流转规则 + 角色权限 + 准入准出）。迭代操作由系统固化的 **iteration 能力**（工具）执行，
+本 skill 描述这些工具该怎么用、什么时候能用。
+
+## 一、核心模型
+
+- 迭代 = 项目的一次增量交付周期（sprint/版本），功能/测试计划/Bug 按迭代组织。
+- **状态存表**（sd_iterations.status），**流转规则在本 skill**（LLM 读后判断合法性）。
+- 工具只做 CAS 原子迁移（`WHERE id=... AND project_id=... AND status=from`），**不校验合法性**。
+- 每次迁移自动写审计（audit_log，append-only）。
+
+## 二、迭代状态（SDLC 默认）
+
+| 状态 | 语义 |
+|---|---|
+| planning | 规划中 |
+| in_progress | 进行中 |
+| completed | 已完成 |
+| cancelled | 已取消 |
+
+## 三、合法流转图
+
+```
+planning ──start──▶ in_progress ──complete──▶ completed
+    │                   │
+    │ cancel            │ cancel
+    ▼                   ▼
+cancelled ◀─────────────┘
+```
+
+明确规则：
+- `create`：新建 → planning。
+- `start`：planning → in_progress。
+- `complete`：in_progress → completed。
+- `cancel`：planning/in_progress → cancelled（附原因）。
+
+## 四、角色 → 操作权限（业务级 RBAC）
+
+| 角色 | 可执行操作 |
+|---|---|
+| agent.main_agent | 代客户创建/启动/完成/取消迭代 |
+| agent.pm | 迭代完成把关（complete，检查准出条件） |
+| owner.superuser（人） | 最终确认、取消兜底 |
+
+## 五、门禁
+
+- **准入**（start 前）：迭代范围（scope）明确，含可验收的功能清单。
+- **准出**（complete 前）：迭代内功能全部 verified、测试计划 completed、未关闭 Bug 清零（或明确豁免，见 feature/test-plan/bug skill）。
+
+## 六、人拍板点（human gate）
+
+需要人审批/确认（如准出豁免、强制取消）时，**不直接改状态**，而是走问题冒泡到 `owner.superuser`
+（见 team-communication skill，problem_type 用 approval/confirm）。人答复后由 agent 再执行状态迁移。
+
+## 七、配套能力（iteration 能力工具）
+
+`create_iteration` / `start_iteration` / `complete_iteration` / `cancel_iteration` /
+`list_iterations` / `set_iteration_state`（通用 CAS 兜底）。
+
+## 八、分层覆盖
+
+本 skill 是 **SDLC 产线默认**状态机；项目可用**同名 iteration skill** 覆盖。
+加载优先级（低→高）：global → org → pipeline(common) → role → project → user。
--- a/skills_library/pipelines/sdlc_general/common/project/SKILL.md
+++ b/skills_library/pipelines/sdlc_general/common/project/SKILL.md
@ -0,0 +1,69 @@
+---
+name: project
+description: SDLC 产线默认项目生命周期状态机规范——定义项目状态、合法流转、角色→操作权限、门禁、人拍板点。agent 处理项目时据此操作，LLM 读本 skill 判断流转合法性。项目可同名 skill 覆盖。触发：创建/启动/完成/归档/重新打开项目。
+capability: project_capability
+tools: [create_project, start_project, complete_project, archive_project, reopen_project, list_projects, set_project_state]
+---
+
+# 项目生命周期状态机规范（SDLC 产线默认）
+
+本 skill 是**规范**（项目状态 + 流转规则 + 角色权限）。项目操作由系统固化的 **project 能力**（工具）执行，
+本 skill 描述这些工具该怎么用、什么时候能用。
+
+## 一、核心模型
+
+- 项目 = 软件开发工作的顶层容器，聚合迭代/功能/任务/仓库/部署环境。
+- **状态存表**（sd_projects.status），**流转规则在本 skill**（LLM 读后判断合法性）。
+- 工具只做 CAS 原子迁移（`WHERE id=... AND status=from`），**不校验合法性**——合法性由你读本 skill 判断。
+- 每次迁移自动写审计（audit_log，append-only）。
+
+## 二、项目状态（SDLC 默认）
+
+| 状态 | 语义 |
+|---|---|
+| draft | 草稿（已创建，未启动） |
+| active | 进行中 |
+| completed | 已完成 |
+| archived | 已归档 |
+
+## 三、合法流转图
+
+```
+draft ──start──▶ active ──complete──▶ completed ──archive──▶ archived
+                    ▲                                           │
+                    └──────────── reopen ───────────────────────┘
+```
+
+明确规则：
+- `start`：draft/archived → active（启动 / 重新激活）。
+- `complete`：active → completed。
+- `archive`：completed → archived（也兼容 active 强制归档）。
+- `reopen`：archived → active。
+
+## 四、角色 → 操作权限（业务级 RBAC）
+
+| 角色 | 可执行操作 |
+|---|---|
+| agent.main_agent | 代客户启动/完成/归档/重开项目（start/complete/archive/reopen） |
+| agent.pm | 项目完成/归档的审核把关（complete/archive） |
+| owner.superuser（人） | 最终确认、归档兜底 |
+
+## 五、门禁
+
+- `complete` 前：项目内迭代全部 completed、未关闭 Bug 清零（见 iteration/bug skill）。
+- `archive` 前：项目已 completed，或经人拍板确认强制归档。
+
+## 六、人拍板点（human gate）
+
+需要人审批/确认（如强制归档、恢复项目）时，**不直接改状态**，而是走问题冒泡到 `owner.superuser`
+（见 team-communication skill，problem_type 用 approval/confirm）。人答复后由 agent 再执行状态迁移。
+
+## 七、配套能力（project 能力工具）
+
+`create_project` / `start_project` / `complete_project` / `archive_project` /
+`reopen_project` / `list_projects` / `set_project_state`（通用 CAS 兜底）。
+
+## 八、分层覆盖
+
+本 skill 是 **SDLC 产线默认**状态机；项目可用**同名 project skill** 覆盖：简化/扩展状态机、改角色权限。
+加载优先级（低→高）：global → org → pipeline(common) → role → project → user。
--- a/skills_library/pipelines/sdlc_general/common/test-case/SKILL.md
+++ b/skills_library/pipelines/sdlc_general/common/test-case/SKILL.md
@ -0,0 +1,75 @@
+---
+name: test-case
+description: SDLC 产线默认测试用例执行状态机规范——定义执行状态、合法流转、角色→操作权限、失败用例联动建 Bug。agent 处理测试用例时据此操作，LLM 读本 skill 判断流转合法性。项目可同名 skill 覆盖。触发：创建/执行用例。
+capability: test_case_capability
+tools: [create_case, pass_case, fail_case, skip_case, block_case, list_cases, set_case_state]
+---
+
+# 测试用例执行状态机规范（SDLC 产线默认）
+
+本 skill 是**规范**（用例执行状态 + 流转规则 + 失败联动建 Bug）。用例操作由系统固化的 **test-case 能力**（工具）执行，
+本 skill 描述这些工具该怎么用、什么时候能用。
+
+## 一、核心模型
+
+- 测试用例 = 一个可执行的验证单元（前置条件 + 步骤 + 预期结果），执行后记录实际结果与状态。
+- **状态存表**（sd_test_cases.status），**流转规则在本 skill**（LLM 读后判断合法性）。
+- 工具只做 CAS 原子迁移（`WHERE id=... AND plan_id=... AND status IN (...)`），**不校验合法性**。
+- 每次迁移自动写审计（audit_log，append-only）。
+
+## 二、用例执行状态（SDLC 默认）
+
+| 状态 | 语义 |
+|---|---|
+| pending | 待执行 |
+| pass | 通过 |
+| fail | 失败 |
+| blocked | 阻塞 |
+| skipped | 跳过 |
+
+## 三、合法流转图
+
+```
+            pass
+pending ──────────▶ pass
+   │   ▲
+   │   │ (fail 允许 pass 回退到 fail 复测)
+   ├──fail──▶ fail
+   ├──block─▶ blocked
+   └──skip──▶ skipped
+```
+
+明确规则：
+- `create`：新建 → pending。
+- `pass`：pending/fail → pass（失败复测通过）。
+- `fail`：pending/pass → fail（记录实际结果）。
+- `block`：pending → blocked（因环境/依赖无法执行，注明原因）。
+- `skip`：pending → skipped（有意不测，注明原因）。
+
+## 四、角色 → 操作权限（业务级 RBAC）
+
+| 角色 | 可执行操作 |
+|---|---|
+| agent.test | create / pass / fail / skip / block（编写与执行用例） |
+| agent.main_agent | 代客户创建/执行用例 |
+| owner.superuser（人） | 最终执行确认兜底 |
+
+## 五、失败联动建 Bug（关键规范）
+
+- 用例 `fail` 后，**应创建关联 Bug**：调 `report_bug(case_id=<用例ID>, ...)`，让缺陷走 bug 生命周期闭环（见 bug skill）。
+- 失败用例的 actual_result 应描述实际结果与预期不符之处，作为 Bug 描述的依据。
+
+## 六、人拍板点（human gate）
+
+需要人确认执行结果/豁免失败用例时，**不直接改状态**，而是走问题冒泡到 `owner.superuser`
+（见 team-communication skill，problem_type 用 approval/confirm）。人答复后由 agent 再执行状态迁移。
+
+## 七、配套能力（test-case 能力工具）
+
+`create_case` / `pass_case` / `fail_case` / `skip_case` / `block_case` /
+`list_cases` / `set_case_state`（通用 CAS 兜底）。
+
+## 八、分层覆盖
+
+本 skill 是 **SDLC 产线默认**状态机；项目可用**同名 test-case skill** 覆盖具体执行流程。
+加载优先级（低→高）：global → org → pipeline(common) → role → project → user。
--- a/skills_library/pipelines/sdlc_general/common/test-plan/SKILL.md
+++ b/skills_library/pipelines/sdlc_general/common/test-plan/SKILL.md
@ -0,0 +1,68 @@
+---
+name: test-plan
+description: SDLC 产线默认测试计划状态机规范——定义计划状态、合法流转、角色→操作权限、准入准出门禁。agent 处理测试计划时据此操作，LLM 读本 skill 判断流转合法性。项目可同名 skill 覆盖。触发：创建/审批/执行/完成测试计划。
+capability: test_plan_capability
+tools: [create_test_plan, approve_plan, start_plan, complete_plan, list_plans, set_plan_state]
+---
+
+# 测试计划状态机规范（SDLC 产线默认）
+
+本 skill 是**规范**（测试计划状态 + 流转规则 + 准入准出）。测试计划操作由系统固化的 **test-plan 能力**（工具）执行，
+本 skill 描述这些工具该怎么用、什么时候能用。
+
+## 一、核心模型
+
+- 测试计划 = 一次测试活动的策略定义（范围/环境/准入/准出），是测试用例的分组单位。
+- **状态存表**（sd_test_plans.status），**流转规则在本 skill**（LLM 读后判断合法性）。
+- 工具只做 CAS 原子迁移（`WHERE id=... AND iteration_id=... AND status=from`），**不校验合法性**。
+- 每次迁移自动写审计（audit_log，append-only）。
+
+## 二、测试计划状态（SDLC 默认）
+
+| 状态 | 语义 |
+|---|---|
+| draft | 草稿 |
+| approved | 已审批 |
+| executing | 执行中 |
+| completed | 已完成 |
+
+## 三、合法流转图
+
+```
+draft ──approve──▶ approved ──start──▶ executing ──complete──▶ completed
+```
+
+明确规则：
+- `create`：新建 → draft。
+- `approve`：draft → approved。
+- `start`：approved → executing。
+- `complete`：executing → completed。
+
+## 四、角色 → 操作权限（业务级 RBAC）
+
+| 角色 | 可执行操作 |
+|---|---|
+| agent.test | create / start / complete（编写与执行测试计划） |
+| agent.pm | approve（审批测试策略） |
+| agent.main_agent | 代客户创建/审批/推进测试计划 |
+| owner.superuser（人） | 最终审批兜底 |
+
+## 五、门禁
+
+- **准入**（start 前）：计划已 approve，entry_criteria（准入条件）满足。
+- **准出**（complete 前）：计划内用例全部执行（pending 清零），失败用例已建 Bug 并闭环（见 test-case/bug skill）。
+
+## 六、人拍板点（human gate）
+
+需要人审批测试策略/准出豁免时，**不直接改状态**，而是走问题冒泡到 `owner.superuser`
+（见 team-communication skill，problem_type 用 approval/confirm）。人答复后由 agent 再执行状态迁移。
+
+## 七、配套能力（test-plan 能力工具）
+
+`create_test_plan` / `approve_plan` / `start_plan` / `complete_plan` /
+`list_plans` / `set_plan_state`（通用 CAS 兜底）。
+
+## 八、分层覆盖
+
+本 skill 是 **SDLC 产线默认**状态机；项目可用**同名 test-plan skill** 覆盖具体流程。
+加载优先级（低→高）：global → org → pipeline(common) → role → project → user。