Gitlink
/
gitlink-cli
0
0
Fork 49
Code Issues Pull Requests 11 Packages Projects Releases 10 Wiki Activity

新增gitlink-dev-full-cycle技能 #269

Merged
wbtiger merged 1 commits from wdgde/gitlink-cli:feature/skill into master 2026-07-14 22:29:32 +08:00
Conversation 0 Commits 1 Files Changed 3 +767
wdgde commented 2026-06-22 09:25:19 +08:00
Contributor
Copy Link

合并请求描述

新增 gitlink-dev-full-cycle 技能，提供从需求到上线的完整开发流程规范。该技能集成 gitlink-cli 工具链，支持三分支模型（master/feature-xxx/release-xxx）的标准化研发流程，覆盖项目初始化、需求分析、技术设计、编码开发、测试验证、发布上线 6 个阶段，每个阶段都有明确的输出文档和检查清单。

相关 Issue

关联 Issue 编号：无

变更内容

1. 新增 gitlink-dev-full-cycle 技能定义

新增 skills/gitlink-dev-full-cycle/SKILL.md 技能定义文件，包含以下内容：

6 阶段开发流程：

  • 阶段零：项目初始化 - 创建远程仓库、克隆到本地、初始化项目骨架、保护 master 分支
  • 阶段一：需求分析 - 确认需求背景、核心功能点、验收标准，输出 requirements.md
  • 阶段二：技术设计 - 分析技术选型、数据模型、接口契约，输出 design.md
  • 阶段三：编码开发 - 创建 feature 分支、拆分任务、实现功能、输出 api.md 和代码注释
  • 阶段四：测试验证 - 单元测试、创建 release 分支、触发流水线、PR Review、输出 test-report.md
  • 阶段五：发布上线 - 触发生产流水线、release 合并回 master、创建 Release、输出 CHANGELOG.md 和 release-notes.md

三分支模型规范：

  • master：主分支，存放最新发布的稳定代码，严禁直接提交或推送
  • feature-xxx：开发分支，从 master 拉取，用于日常功能开发和缺陷修复
  • release-xxx：发布分支，从 master 拉取，用于版本发布准备，发版后保留不删除

分支流转规则：

  1. 每次开发时从 master 拉取 feature-xxx 分支
  2. 开发自测完成后，提交 PR 将 feature-xxx 合并到 release-xxx
  3. 发版后将 release-xxx 合并回 master

gitlink-cli 集成规范：

  • 仓库创建与管理：gitlink-cli repo +create / +info
  • 分支创建与保护：gitlink-cli branch +create / +protect
  • PR 流程：gitlink-cli pr +create / +review / +merge
  • CI/CD 流水线：gitlink-cli pipeline +run / +runs、gitlink-cli ci +builds / +logs
  • Release 发布：gitlink-cli release +create
  • AI Code Review：gitlink-cli workflow +pr-summary
  • 仓库健康检查：gitlink-cli workflow +health / +repo-report

核心规则：

  • 所有与 GitLink 平台的交互必须通过 gitlink-cli 完成，禁止绕过直接使用 Web 界面或 API
  • 禁止使用 gitlink-cli api 命令（原始 API 请求易误操作）
  • 执行 gitlink-cli 命令前，必须先通过 --help 查询确认子命令格式（部分子命令有 + 前缀）
  • master 分支严禁直接提交代码
  • feature-xxx 必须经过 release-xxx 才能合回 master
  • 不可逆操作（release-xxx 合并回 master、触发生产流水线）执行前必须获得用户确认

2. 新增各阶段检查清单

新增 skills/gitlink-dev-full-cycle/references/checklist.md，包含各阶段关键检查点：

  • 阶段零检查清单：仓库创建确认、本地初始化确认、master 分支保护确认、基础文档确认
  • 阶段一检查清单：需求背景确认、功能点确认、验收标准确认、需求文档确认
  • 阶段二检查清单：技术选型确认、架构设计确认、接口契约确认、设计文档确认
  • 阶段三检查清单：feature 分支创建确认、代码规范确认、单元测试确认、文档输出确认
  • 阶段四检查清单：单元测试通过确认、release 分支创建确认、流水线通过确认、PR Review 通过确认、测试报告确认
  • 阶段五检查清单：发布前确认、生产流水线通过确认、release 合并回 master 确认、Release 创建确认、文档输出确认

3. 新增文档模板

新增 skills/gitlink-dev-full-cycle/references/templates.md，包含以下标准模板：

  • README.md 模板：项目简介、技术栈、本地开发启动步骤、目录结构说明
  • requirements.md 模板：需求背景、目标用户、用户故事、功能清单、验收标准（AC）、Out-of-scope、依赖与风险
  • design.md 模板：技术栈选型表、系统架构图、数据模型 DDL、接口契约、关键实现思路、风险与缓解措施
  • api.md 模板：接口路径、方法、参数、响应、错误码
  • test-report.md 模板：测试范围、测试环境、AC 逐条验证结果、单元测试覆盖率、遗留问题清单
  • CHANGELOG.md 模板：Added / Changed / Fixed / Breaking Changes
  • release-notes.md 模板：版本号、上线时间、更新内容、验证方式、回滚方案

测试情况

测试环境

  • 操作系统：Linux
  • 依赖工具：gitlink-cli

测试内容

  • 技能文件格式校验，符合 SKILL.md 规范（YAML frontmatter + Markdown 正文）
  • 文档模板结构完整性检查，所有模板字段齐全
  • 检查清单覆盖各阶段关键节点，无遗漏
  • gitlink-cli 命令格式正确性验证，+ 前缀使用正确

测试结果

  • 技能定义文件格式正确，可被正常加载和识别
  • 文档模板结构完整，可直接复制使用
  • 检查清单覆盖全面，确保流程规范执行
  • gitlink-cli 命令示例格式正确，可直接执行

影响范围

新增文件

文件路径 行数 说明
skills/gitlink-dev-full-cycle/SKILL.md 323 技能定义文件，包含完整流程规范、分支策略、gitlink-cli 集成规范
skills/gitlink-dev-full-cycle/references/checklist.md - 各阶段检查清单
skills/gitlink-dev-full-cycle/references/templates.md - 文档模板集合

影响范围

  • 新增技能，不影响现有功能
  • 用户可通过触发词激活该技能，获得完整的开发流程指导

破坏性变更

  • 无破坏性变更

检查清单

  • 代码遵循项目编码规范
  • 已添加必要的注释和文档
  • 文档结构清晰，易于理解和遵循
  • 无明显的性能问题
  • 无安全风险
  • 已自测验证功能正确性
  • 提交信息格式正确

部署注意事项

  • 无需特殊部署步骤，技能文件为纯文档类型
  • 使用该技能需确保 gitlink-cli 已安装并完成认证（gitlink-cli auth status）

其他说明

技能触发词

用户可通过以下触发词激活该技能：

  • 新需求开发、全流程推进、从需求到上线、启动需求、开发测试发布、feature 全流程、需求落地、需求闭环、从 0 到 1 交付、从零开始开发、新建项目开发

使用场景

  • 新项目从零开始开发
  • 新需求从分析到上线全流程
  • 团队标准化研发流程规范
  • gitlink-cli 工具链集成指导
## 合并请求描述 新增 `gitlink-dev-full-cycle` 技能，提供从需求到上线的完整开发流程规范。该技能集成 gitlink-cli 工具链，支持三分支模型（master/feature-xxx/release-xxx）的标准化研发流程，覆盖项目初始化、需求分析、技术设计、编码开发、测试验证、发布上线 6 个阶段，每个阶段都有明确的输出文档和检查清单。 ## 相关 Issue 关联 Issue 编号：无 ## 变更内容 ### 1. 新增 gitlink-dev-full-cycle 技能定义 新增 `skills/gitlink-dev-full-cycle/SKILL.md` 技能定义文件，包含以下内容： **6 阶段开发流程：** - 阶段零：项目初始化 - 创建远程仓库、克隆到本地、初始化项目骨架、保护 master 分支 - 阶段一：需求分析 - 确认需求背景、核心功能点、验收标准，输出 requirements.md - 阶段二：技术设计 - 分析技术选型、数据模型、接口契约，输出 design.md - 阶段三：编码开发 - 创建 feature 分支、拆分任务、实现功能、输出 api.md 和代码注释 - 阶段四：测试验证 - 单元测试、创建 release 分支、触发流水线、PR Review、输出 test-report.md - 阶段五：发布上线 - 触发生产流水线、release 合并回 master、创建 Release、输出 CHANGELOG.md 和 release-notes.md **三分支模型规范：** - `master`：主分支，存放最新发布的稳定代码，严禁直接提交或推送 - `feature-xxx`：开发分支，从 master 拉取，用于日常功能开发和缺陷修复 - `release-xxx`：发布分支，从 master 拉取，用于版本发布准备，发版后保留不删除 **分支流转规则：** 1. 每次开发时从 master 拉取 feature-xxx 分支 2. 开发自测完成后，提交 PR 将 feature-xxx 合并到 release-xxx 3. 发版后将 release-xxx 合并回 master **gitlink-cli 集成规范：** - 仓库创建与管理：`gitlink-cli repo +create / +info` - 分支创建与保护：`gitlink-cli branch +create / +protect` - PR 流程：`gitlink-cli pr +create / +review / +merge` - CI/CD 流水线：`gitlink-cli pipeline +run / +runs`、`gitlink-cli ci +builds / +logs` - Release 发布：`gitlink-cli release +create` - AI Code Review：`gitlink-cli workflow +pr-summary` - 仓库健康检查：`gitlink-cli workflow +health / +repo-report` **核心规则：** - 所有与 GitLink 平台的交互必须通过 gitlink-cli 完成，禁止绕过直接使用 Web 界面或 API - 禁止使用 `gitlink-cli api` 命令（原始 API 请求易误操作） - 执行 gitlink-cli 命令前，必须先通过 `--help` 查询确认子命令格式（部分子命令有 `+` 前缀） - master 分支严禁直接提交代码 - feature-xxx 必须经过 release-xxx 才能合回 master - 不可逆操作（release-xxx 合并回 master、触发生产流水线）执行前必须获得用户确认 ### 2. 新增各阶段检查清单 新增 `skills/gitlink-dev-full-cycle/references/checklist.md`，包含各阶段关键检查点： - 阶段零检查清单：仓库创建确认、本地初始化确认、master 分支保护确认、基础文档确认 - 阶段一检查清单：需求背景确认、功能点确认、验收标准确认、需求文档确认 - 阶段二检查清单：技术选型确认、架构设计确认、接口契约确认、设计文档确认 - 阶段三检查清单：feature 分支创建确认、代码规范确认、单元测试确认、文档输出确认 - 阶段四检查清单：单元测试通过确认、release 分支创建确认、流水线通过确认、PR Review 通过确认、测试报告确认 - 阶段五检查清单：发布前确认、生产流水线通过确认、release 合并回 master 确认、Release 创建确认、文档输出确认 ### 3. 新增文档模板 新增 `skills/gitlink-dev-full-cycle/references/templates.md`，包含以下标准模板： - **README.md 模板**：项目简介、技术栈、本地开发启动步骤、目录结构说明 - **requirements.md 模板**：需求背景、目标用户、用户故事、功能清单、验收标准（AC）、Out-of-scope、依赖与风险 - **design.md 模板**：技术栈选型表、系统架构图、数据模型 DDL、接口契约、关键实现思路、风险与缓解措施 - **api.md 模板**：接口路径、方法、参数、响应、错误码 - **test-report.md 模板**：测试范围、测试环境、AC 逐条验证结果、单元测试覆盖率、遗留问题清单 - **CHANGELOG.md 模板**：Added / Changed / Fixed / Breaking Changes - **release-notes.md 模板**：版本号、上线时间、更新内容、验证方式、回滚方案 ## 测试情况 ### 测试环境 - 操作系统：Linux - 依赖工具：gitlink-cli ### 测试内容 - [x] 技能文件格式校验，符合 SKILL.md 规范（YAML frontmatter + Markdown 正文） - [x] 文档模板结构完整性检查，所有模板字段齐全 - [x] 检查清单覆盖各阶段关键节点，无遗漏 - [x] gitlink-cli 命令格式正确性验证，`+` 前缀使用正确 ### 测试结果 - 技能定义文件格式正确，可被正常加载和识别 - 文档模板结构完整，可直接复制使用 - 检查清单覆盖全面，确保流程规范执行 - gitlink-cli 命令示例格式正确，可直接执行 ## 影响范围 ### 新增文件 | 文件路径 | 行数 | 说明 | |---------|------|------| | `skills/gitlink-dev-full-cycle/SKILL.md` | 323 | 技能定义文件，包含完整流程规范、分支策略、gitlink-cli 集成规范 | | `skills/gitlink-dev-full-cycle/references/checklist.md` | - | 各阶段检查清单 | | `skills/gitlink-dev-full-cycle/references/templates.md` | - | 文档模板集合 | ### 影响范围 - 新增技能，不影响现有功能 - 用户可通过触发词激活该技能，获得完整的开发流程指导 ### 破坏性变更 - 无破坏性变更 ## 检查清单 - [x] 代码遵循项目编码规范 - [x] 已添加必要的注释和文档 - [x] 文档结构清晰，易于理解和遵循 - [x] 无明显的性能问题 - [x] 无安全风险 - [x] 已自测验证功能正确性 - [x] 提交信息格式正确 ## 部署注意事项 - 无需特殊部署步骤，技能文件为纯文档类型 - 使用该技能需确保 gitlink-cli 已安装并完成认证（`gitlink-cli auth status`） ## 其他说明 ### 技能触发词 用户可通过以下触发词激活该技能： - 新需求开发、全流程推进、从需求到上线、启动需求、开发测试发布、feature 全流程、需求落地、需求闭环、从 0 到 1 交付、从零开始开发、新建项目开发 ### 使用场景 - 新项目从零开始开发 - 新需求从分析到上线全流程 - 团队标准化研发流程规范 - gitlink-cli 工具链集成指导
wdgde added 1 commit 2026-06-22 09:25:20 +08:00
2138ffa028 feat: 新增 gitlink-dev-full-cycle 技能 
添加需求开发测试发布全流程技能，包含：
- 6阶段流程：项目初始化→需求分析→技术设计→编码开发→测试验证→发布上线
- 三分支模型：master/feature-xxx/release-xxx
- 集成 gitlink-cli 的完整操作规范
- 各阶段检查清单和文档模板
wbtiger merged commit ad80f8bb68 into master 2026-07-14 22:29:21 +08:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Gitlink/gitlink-cli#269
No description provided.
Delete Branch "wdgde/gitlink-cli:feature/skill"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?