From 0e026e6d8131a05145de661a90755b2ad830b94e Mon Sep 17 00:00:00 2001 From: yumoqing Date: Mon, 17 Aug 2026 07:31:20 +0800 Subject: [PATCH] =?UTF-8?q?feat:=2010=E4=B8=AA=E9=80=9A=E7=94=A8SDLC?= =?UTF-8?q?=E6=A6=82=E5=BF=B5skill=E6=94=BEglobal(project/iteration/featur?= =?UTF-8?q?e/task/deliverable/test-plan/test-case/bug/problem/deploy-env)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills_library/all/bug/SKILL.md | 47 ++++++++++++++++++++++++ skills_library/all/deliverable/SKILL.md | 45 +++++++++++++++++++++++ skills_library/all/deploy-env/SKILL.md | 43 ++++++++++++++++++++++ skills_library/all/feature/SKILL.md | 47 ++++++++++++++++++++++++ skills_library/all/iteration/SKILL.md | 46 +++++++++++++++++++++++ skills_library/all/problem/SKILL.md | 42 +++++++++++++++++++++ skills_library/all/project/SKILL.md | 49 +++++++++++++++++++++++++ skills_library/all/task/SKILL.md | 47 ++++++++++++++++++++++++ skills_library/all/test-case/SKILL.md | 45 +++++++++++++++++++++++ skills_library/all/test-plan/SKILL.md | 43 ++++++++++++++++++++++ 10 files changed, 454 insertions(+) create mode 100644 skills_library/all/bug/SKILL.md create mode 100644 skills_library/all/deliverable/SKILL.md create mode 100644 skills_library/all/deploy-env/SKILL.md create mode 100644 skills_library/all/feature/SKILL.md create mode 100644 skills_library/all/iteration/SKILL.md create mode 100644 skills_library/all/problem/SKILL.md create mode 100644 skills_library/all/project/SKILL.md create mode 100644 skills_library/all/task/SKILL.md create mode 100644 skills_library/all/test-case/SKILL.md create mode 100644 skills_library/all/test-plan/SKILL.md diff --git a/skills_library/all/bug/SKILL.md b/skills_library/all/bug/SKILL.md new file mode 100644 index 0000000..3bc1803 --- /dev/null +++ b/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 覆盖具体流转与角色权限。 diff --git a/skills_library/all/deliverable/SKILL.md b/skills_library/all/deliverable/SKILL.md new file mode 100644 index 0000000..30afee6 --- /dev/null +++ b/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 覆盖具体评审流程。 diff --git a/skills_library/all/deploy-env/SKILL.md b/skills_library/all/deploy-env/SKILL.md new file mode 100644 index 0000000..c91e038 --- /dev/null +++ b/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 覆盖具体发布流程与门禁。 diff --git a/skills_library/all/feature/SKILL.md b/skills_library/all/feature/SKILL.md new file mode 100644 index 0000000..1f3cfd4 --- /dev/null +++ b/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 覆盖。 diff --git a/skills_library/all/iteration/SKILL.md b/skills_library/all/iteration/SKILL.md new file mode 100644 index 0000000..446da23 --- /dev/null +++ b/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 覆盖具体状态机与角色权限。 diff --git a/skills_library/all/problem/SKILL.md b/skills_library/all/problem/SKILL.md new file mode 100644 index 0000000..ca402d2 --- /dev/null +++ b/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 覆盖。 diff --git a/skills_library/all/project/SKILL.md b/skills_library/all/project/SKILL.md new file mode 100644 index 0000000..ffe8d9a --- /dev/null +++ b/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。 diff --git a/skills_library/all/task/SKILL.md b/skills_library/all/task/SKILL.md new file mode 100644 index 0000000..e21871c --- /dev/null +++ b/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 覆盖。 diff --git a/skills_library/all/test-case/SKILL.md b/skills_library/all/test-case/SKILL.md new file mode 100644 index 0000000..0e56b2c --- /dev/null +++ b/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 覆盖具体执行流程。 diff --git a/skills_library/all/test-plan/SKILL.md b/skills_library/all/test-plan/SKILL.md new file mode 100644 index 0000000..306abb8 --- /dev/null +++ b/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 覆盖具体流程。