From 65c6917c465353e1952d94cd90696399443a7bf7 Mon Sep 17 00:00:00 2001
From: yumoqing <yumoqing@gmail.com>
Date: Mon, 17 Aug 2026 07:10:28 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20feature=20skill=20=E5=8A=9F=E8=83=BD/?=
 =?UTF-8?q?=E9=9C=80=E6=B1=82=E7=8A=B6=E6=80=81=E6=9C=BA=E8=A7=84=E8=8C=83?=
 =?UTF-8?q?(proposed=E2=86=92approved=E2=86=92in=5Fprogress=E2=86=92delive?=
 =?UTF-8?q?red=E2=86=92verified)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../sdlc_general/common/feature/SKILL.md      | 81 +++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 skills_library/pipelines/sdlc_general/common/feature/SKILL.md

diff --git a/skills_library/pipelines/sdlc_general/common/feature/SKILL.md b/skills_library/pipelines/sdlc_general/common/feature/SKILL.md
new file mode 100644
index 0000000..3c2ac2d
--- /dev/null
+++ b/skills_library/pipelines/sdlc_general/common/feature/SKILL.md
@@ -0,0 +1,81 @@
+---
+name: feature
+description: SDLC 产线默认功能/需求状态机规范——定义功能状态、合法流转、角色→操作权限、门禁、验收标准。agent 处理功能时据此操作，LLM 读本 skill 判断流转合法性。项目可同名 skill 覆盖。触发：提出/审批/开发/交付/验证功能，或用户提到新功能、需求拆解、功能验收。
+capability: feature_capability
+tools: [propose_feature, approve_feature, reject_feature, start_feature, deliver_feature, verify_feature, reopen_feature, list_features, set_feature_state]
+---
+
+# 功能/需求状态机规范（SDLC 产线默认）
+
+本 skill 是**规范**（功能状态 + 流转规则 + 角色权限 + 验收）。功能操作由系统固化的 **feature 能力**（工具）执行，
+本 skill 描述这些工具该怎么用、什么时候能用。
+
+## 一、核心模型
+
+- 功能 = 一个可追踪的软件能力单元（用户需求拆解出来的「功能点」），沿状态机流转。
+- **状态存表**（sd_features.status），**流转规则在本 skill**（LLM 读后判断合法性）。
+- 工具只做 CAS 原子迁移（`WHERE status=from AND project_id=...`），**不校验合法性**——合法性由你读本 skill 判断。
+- 每次迁移自动写审计（audit_log，append-only）。
+- 功能是迭代 scope、测试用例、Bug 的共同锚点：迭代范围、用例、Bug 都应能挂到 feature_id。
+
+## 二、功能状态（SDLC 默认）
+
+| 状态 | 语义 |
+|---|---|
+| proposed | 已提出（待审批） |
+| approved | 已批准（待开发） |
+| in_progress | 开发中 |
+| delivered | 已交付（待验证） |
+| verified | 已验证（验收通过） |
+| rejected | 已驳回 |
+
+## 三、合法流转图
+
+```
+proposed ──approve──▶ approved ──start──▶ in_progress ──deliver──▶ delivered ──verify──▶ verified
+    │                    │                                                            
+    │ reject             │ reject                                                     
+    ▼                    ▼                                                            
+rejected ◀────────────────┴──────────── reopen ────────────────────────────────────────┘
+                                          (verified 也可 reopen 回炉到 proposed)
+```
+
+明确规则：
+- `propose`：新建 → proposed（功能诞生）。
+- `approve`：proposed → approved（需求评审通过）。
+- `reject`：proposed/approved → rejected（驳回，附意见）。
+- `start`：approved → in_progress（开始开发）。
+- `deliver`：in_progress → delivered（开发完成，交付验收）。
+- `verify`：delivered → verified（验收通过）。
+- `reopen`：rejected/verified → proposed（重新打开 / 回炉）。
+
+## 四、角色 → 操作权限（业务级 RBAC）
+
+| 角色 | 可执行操作 |
+|---|---|
+| agent.requirement | propose（拆解需求提功能） |
+| agent.pm | approve、reject、verify（评审、驳回、验收拍板） |
+| agent.develop | start、deliver（开发、交付） |
+| agent.main_agent | 代客户提功能（propose）、按冒泡链路由（见 team-communication） |
+| owner.superuser（人） | 最终审批兜底、验收确认 |
+
+## 五、门禁
+
+- `approve` 通过：功能描述清晰 + 验收标准（acceptance_criteria）明确。
+- `reject`：附意见，功能回 proposed/rejected，被驳回的提出方（requirement）响应后重新 propose。
+- `verify` 通过：功能满足验收标准，且关联 Bug 全部 verified/closed（质量清零门禁，见 bug skill）。
+
+## 六、人拍板点（human gate）
+
+需要人审批/确认（如需求评审、验收签字）时，**不直接改状态**，而是走问题冒泡到 `owner.superuser`
+（见 team-communication skill，problem_type 用 approval/confirm）。人答复后由 agent 再执行状态迁移。
+
+## 七、配套能力（feature 能力工具）
+
+`propose_feature` / `approve_feature` / `reject_feature` / `start_feature` /
+`deliver_feature` / `verify_feature` / `reopen_feature` / `list_features` / `set_feature_state`（通用 CAS 兜底）。
+
+## 八、分层覆盖
+
+本 skill 是 **SDLC 产线默认**状态机；项目可用**同名 feature skill** 覆盖：简化/扩展状态机、改角色权限。
+加载优先级（低→高）：global → org → pipeline(common) → role → project → user。