@happyvertical/github-动作
GitHub Actions为CI/CD自动化服务。 提供AI动力的发行分解(标签,重复检测,项目板管理),执行规划并附有"就绪验证定义",以及标准化的标签管理. 用途 @happyvertical/repos 财务报告和审定财务报表 @happyvertical/projects 用于 GitHub API 交互.
安装
npm install @happyvertical/github-actions
同伴依赖性 : @happyvertical/repos, (中文(简体) ), @happyvertical/projects。 。 。 .
CLI 使用量
该软件包提供了两个CLI命令:
曲线
在 GitHub 动作工作流程中运行 AI 驱动的发行分解 :
# Required env vars: GITHUB_TOKEN, GITHUB_REPOSITORY, ISSUE_NUMBER, ISSUE_TITLE, ISSUE_AUTHOR
# Optional: ISSUE_BODY, CONFIG (path to config file or JSON string)
npx @happyvertical/github-actions triage
标签
对寄存器应用标准化标签(类型、优先级、大小、状态、代理) :
github-actions labels --owner happyvertical --repo sdk --dry-run
github-actions labels --owner happyvertical --repo sdk --include-area --area core --area api
配置
创建一个 .github/triage-config.json数字 :
{
"repoDescription": "TypeScript monorepo for AI agent development",
"packagePattern": "@happyvertical/*",
"packageExamples": ["@happyvertical/ai", "@happyvertical/sql"],
"projectEnabled": true,
"projectId": "PVT_kwDOB9Y8ns4A8-TY",
"statusFieldId": "PVTSSF_lADOB9Y8ns4A8-TYzgw0GaY",
"statusOptions": {
"To Do": "c0c9ab27",
"In Progress": "ce670088",
"Review & Testing": "ee1f96bd"
}
}
| 外地 | 类型 | 需求 | 说明 |
|---|---|---|---|
repoDescription | 字符串 | 对 | AI背景简介 |
packagePattern | 字符串 | 没有 | Monorepo软件包模式(例如, @happyvertical/*(中文(简体) ) |
packageExamples | 字符串 [] | 没有 | AI 指导的示例包名 |
projectEnabled | 布尔 | 没有 | 启用 GitHub 项目 V2 集成 |
projectId | 字符串 | 如果项目 | 工程 V2 ID |
statusFieldId | 字符串 | 如果项目 | 状态字段标识 |
statusOptions | 对象 | 如果项目 | 选项 ID 映射的状态名称 |
程序化 API
问题 Trage
import { triageIssue } from '@happyvertical/github-actions';
const result = await triageIssue({
token: process.env.GITHUB_TOKEN!,
owner: 'happyvertical',
repo: 'sdk',
issueNumber: 123,
issueTitle: 'Add Redis cache support',
issueBody: 'We need distributed caching...',
issueAuthor: 'username',
config: {
repoDescription: 'TypeScript monorepo for AI agent development',
packagePattern: '@happyvertical/*',
projectEnabled: false,
},
});
Triage用AI(GitHub Models API)来分析这个问题,应用类型/优先级/大小标签,搜索复制品,张贴有条理的评论,并可选择更新项目板.
规划
import { startPlanning, completePlanning } from '@happyvertical/github-actions';
// Generate an AI implementation plan and post it as a comment
const planResult = await startPlanning(context);
// Validate Definition of Ready and move to Ready status
const completeResult = await completePlanning(context);
标签管理
import {
getAllStandardLabels,
getLabelsByCategory,
migrateLabel,
} from '@happyvertical/github-actions';
const allLabels = getAllStandardLabels(); // type, priority, size, status, agent
const bugLabels = getLabelsByCategory('type');
const newName = migrateLabel('enhancement'); // → 'type: feature'
共用水电费
import {
createRepository,
createProject,
getAICompletion,
parseAIJson,
} from '@happyvertical/github-actions';
// Adapter factories for @happyvertical/repos and @happyvertical/projects
const repo = await createRepository(token, 'happyvertical', 'sdk');
const project = await createProject(token, projectId, statusFieldId, statusOptions);
// AI completion with auto-provider selection (GitHub Models → OpenAI → Anthropic)
const response = await getAICompletion([
{ role: 'system', content: 'You are a helpful assistant.' },
{ role: 'user', content: 'Analyze this issue...' },
]);
建筑
triage/——问题分解:AI分析,标签,重复检测,项目板更新planning/实施规划:AI计划生成,即期验证的定义shared/——AI客户端(GitHub Models,OpenAI,Anthropic),GitHub API帮助器,标签定义,项目公用事业,适配器工厂cli.ts——CLI入站点triage, (中文(简体) ),labels命令)
许可证
麻省理工学院