• Skill 名称: agile-github-task-from-diff
• Skill 简称: 从 Git Diff 创建 GitHub 任务
• 来源: 社区第三方 (generic-automation-and-it)
• 运行宿主: 只能在使用 gh CLI 和 Python 环境的开发环境中运行，不依赖特定 Agent 工具
• 核心定位: 通过分析当前分支与 main 分支的差异，自动生成水平切片的技术任务 Issue 并关联到父级功能 Issue，适用于敏捷开发中的任务分解场景

🧩 内部核心组成

该 Skill 核心为一个 Python 脚本，主要包含以下组件：

主要脚本文件

• scripts/create_github_task_from_diff.py - 核心执行脚本

命令/工具功能表

命令/参数	功能简述
--feature-issue	指定父级功能 Issue（编号或URL）
--title	自定义任务标题（覆盖自动生成）
--repo	指定 GitHub 仓库（owner/repo格式）
--project	指定 GitHub 项目编号
--no-project	仅创建 Issue，不添加到项目
--base-ref	指定对比的基础分支
--dry-run	预览模式，不实际创建
--open	创建后在浏览器打开 Issue

核心处理逻辑

• 计算当前分支与基准分支的差异
• 按技术层分类：backend、tests、documentation、ai-tooling、config、general
• 自动生成标题和验收标准清单
• 通过 gh CLI 创建 Issue 和项目管理

🛠 安装与启用方式

1. 前置依赖:

- git 命令行工具

- gh GitHub CLI（需认证 repo 和 project 权限）

- Python 3 环境

1. 安装步骤:

```bash

skills install --user generic-automation-and-it/smooth-ai-stockanalysis

```

1. 启用要求:

- 目标仓库需存在 task 标签：gh label create task --color 0075ca

- gh auth status 验证认证状态

- 确保 origin/main 分支最新或通过 --base-ref 指定

📋 标准工作流

1. 用户执行命令：运行脚本并提供父级功能 Issue 参数
2. 差异分析：脚本计算当前分支与基准分支的 git diff
3. 层级分类：自动识别变更所属的技术层（后端、测试、文档等）
4. 内容生成：基于变更路径生成任务标题和验收标准
5. Issue 创建：通过 gh issue create 创建 GitHub Issue
6. 项目管理：将 Issue 添加到指定 GitHub 项目
7. 关联设置：通过 REST API 将任务关联为父级功能的子 Issue
8. 分支重命名：建议按 <type>/<issue>-short-description 格式重命名分支

⚠️ 关键限制、缺陷、注意事项

平台限制

• 仅支持 GitHub 平台，不支持 GitLab、Bitbucket 等其他代码托管平台
• 依赖 gh CLI 工具，不支持纯 API 调用方式

使用要求

• 需要有 GitHub repo 和 project 的操作权限
• 目标仓库必须预先创建 task 标签
• 分支必须有相对于基准分支的实际变更内容

生产环境适用性

• 适用于开发环境，生产环境需谨慎评估权限和自动化程度
• 依赖外部工具链稳定性（gh CLI、GitHub API）

已知限制

• 空 diff 会导致执行失败
• 子 Issue 关联依赖 GitHub REST API，可能存在权限问题
• 分支重命名建议需要手动确认执行

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景

• 敏捷开发团队：需要将功能垂直切片为水平技术任务的团队
• 代码审查前：在创建 PR 前自动生成任务描述和验收标准
• 多层级项目：使用 GitHub Projects 进行项目管理的团队
• 标准化流程：需要强制执行分支命名和任务关联规范的团队

❌ 不适合场景

• 小型个人项目：流程过于复杂，不适合简单项目
• 非 GitHub 平台：仅支持 GitHub 生态
• 无权限环境：没有 GitHub repo 和 project 操作权限的情况
• 紧急修复：流程步骤较多，不适合需要快速处理的紧急任务

skills install --user generic-automation-and-it/smooth-ai-stockanalysis