From 13769e55155f01f71e1d6cf51a85a5ee628f5e11 Mon Sep 17 00:00:00 2001 From: yumoqing Date: Mon, 17 Aug 2026 11:00:15 +0800 Subject: [PATCH] =?UTF-8?q?feat:=207=E4=B8=AASDLC=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E6=9C=BAskill(project/iteration/deliverable/test-plan/test-cas?= =?UTF-8?q?e/bug/deploy-env)=20+=20=E6=A6=82=E5=BF=B5skill=E8=A1=A5capabil?= =?UTF-8?q?ity/tools=20frontmatter?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills_library/all/bug/SKILL.md | 8 +- skills_library/all/deliverable/SKILL.md | 8 +- skills_library/all/deploy-env/SKILL.md | 8 +- skills_library/all/iteration/SKILL.md | 8 +- skills_library/all/project/SKILL.md | 8 +- skills_library/all/test-case/SKILL.md | 8 +- skills_library/all/test-plan/SKILL.md | 8 +- .../sdlc_general/common/bug/SKILL.md | 89 +++++++++++++++++++ .../sdlc_general/common/deliverable/SKILL.md | 72 +++++++++++++++ .../sdlc_general/common/deploy-env/SKILL.md | 75 ++++++++++++++++ .../sdlc_general/common/iteration/SKILL.md | 71 +++++++++++++++ .../sdlc_general/common/project/SKILL.md | 69 ++++++++++++++ .../sdlc_general/common/test-case/SKILL.md | 75 ++++++++++++++++ .../sdlc_general/common/test-plan/SKILL.md | 68 ++++++++++++++ 14 files changed, 554 insertions(+), 21 deletions(-) create mode 100644 skills_library/pipelines/sdlc_general/common/bug/SKILL.md create mode 100644 skills_library/pipelines/sdlc_general/common/deliverable/SKILL.md create mode 100644 skills_library/pipelines/sdlc_general/common/deploy-env/SKILL.md create mode 100644 skills_library/pipelines/sdlc_general/common/iteration/SKILL.md create mode 100644 skills_library/pipelines/sdlc_general/common/project/SKILL.md create mode 100644 skills_library/pipelines/sdlc_general/common/test-case/SKILL.md create mode 100644 skills_library/pipelines/sdlc_general/common/test-plan/SKILL.md diff --git a/skills_library/all/bug/SKILL.md b/skills_library/all/bug/SKILL.md index 3bc1803..cf3e915 100644 --- 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 生成的端点。 ## 六、分层覆盖 diff --git a/skills_library/all/deliverable/SKILL.md b/skills_library/all/deliverable/SKILL.md index 30afee6..b1a4cf2 100644 --- 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 生成的端点。 ## 六、分层覆盖 diff --git a/skills_library/all/deploy-env/SKILL.md b/skills_library/all/deploy-env/SKILL.md index c91e038..b879267 100644 --- 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 生成的端点。 ## 六、分层覆盖 diff --git a/skills_library/all/iteration/SKILL.md b/skills_library/all/iteration/SKILL.md index 446da23..2a8e110 100644 --- 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 生成的端点。 ## 六、分层覆盖 diff --git a/skills_library/all/project/SKILL.md b/skills_library/all/project/SKILL.md index ffe8d9a..d9f77cb 100644 --- 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 生成的端点。 ## 五、分层覆盖 diff --git a/skills_library/all/test-case/SKILL.md b/skills_library/all/test-case/SKILL.md index 0e56b2c..f47cb19 100644 --- 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 生成的端点。 ## 六、分层覆盖 diff --git a/skills_library/all/test-plan/SKILL.md b/skills_library/all/test-plan/SKILL.md index 306abb8..2347527 100644 --- 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 生成的端点。 ## 六、分层覆盖 diff --git a/skills_library/pipelines/sdlc_general/common/bug/SKILL.md b/skills_library/pipelines/sdlc_general/common/bug/SKILL.md new file mode 100644 index 0000000..2e234d5 --- /dev/null +++ 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。 diff --git a/skills_library/pipelines/sdlc_general/common/deliverable/SKILL.md b/skills_library/pipelines/sdlc_general/common/deliverable/SKILL.md new file mode 100644 index 0000000..117f7ae --- /dev/null +++ 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。 diff --git a/skills_library/pipelines/sdlc_general/common/deploy-env/SKILL.md b/skills_library/pipelines/sdlc_general/common/deploy-env/SKILL.md new file mode 100644 index 0000000..93825eb --- /dev/null +++ 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。 diff --git a/skills_library/pipelines/sdlc_general/common/iteration/SKILL.md b/skills_library/pipelines/sdlc_general/common/iteration/SKILL.md new file mode 100644 index 0000000..703a740 --- /dev/null +++ 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。 diff --git a/skills_library/pipelines/sdlc_general/common/project/SKILL.md b/skills_library/pipelines/sdlc_general/common/project/SKILL.md new file mode 100644 index 0000000..142ef7c --- /dev/null +++ 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。 diff --git a/skills_library/pipelines/sdlc_general/common/test-case/SKILL.md b/skills_library/pipelines/sdlc_general/common/test-case/SKILL.md new file mode 100644 index 0000000..c708a23 --- /dev/null +++ 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。 diff --git a/skills_library/pipelines/sdlc_general/common/test-plan/SKILL.md b/skills_library/pipelines/sdlc_general/common/test-plan/SKILL.md new file mode 100644 index 0000000..ed03061 --- /dev/null +++ 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。