仓库初始化
This commit is contained in:
parent
9b08123e2a
commit
642d2ff64e
|
|
@ -0,0 +1,23 @@
|
||||||
|
{
|
||||||
|
"name": "chinaweal-skills",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"description": "众望通企业内部 Claude Code Skills 集合，包含 PMS 开发、Gitea API 等企业业务集成技能",
|
||||||
|
"author": {
|
||||||
|
"name": "lirh",
|
||||||
|
"email": "lirh@chinaweal.com"
|
||||||
|
},
|
||||||
|
"homepage": "https://github.com/lirh chinaweal-skills",
|
||||||
|
"repository": "https://github.com/lirh/chinaweal-skills",
|
||||||
|
"license": "Apache-2.0",
|
||||||
|
"keywords": [
|
||||||
|
"pms",
|
||||||
|
"gitea",
|
||||||
|
"enterprise",
|
||||||
|
"chinaweal",
|
||||||
|
"development"
|
||||||
|
],
|
||||||
|
"categories": [
|
||||||
|
"development",
|
||||||
|
"enterprise"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1 @@
|
||||||
|
settings.local.json
|
||||||
|
|
@ -0,0 +1,58 @@
|
||||||
|
# CLAUDE.md
|
||||||
|
|
||||||
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
This is a Claude Code Skills plugin for 众望通 (ChinaWeal) enterprise, providing PMS (Project Management System) integration and Gitea code hosting platform integration.
|
||||||
|
|
||||||
|
## Repository Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
.
|
||||||
|
├── .claude-plugin/plugin.json # Plugin marketplace manifest
|
||||||
|
└── skills/
|
||||||
|
├── chinaweal-pms/ # PMS todo query skill
|
||||||
|
├── gitea-api/ # Gitea API integration
|
||||||
|
│ └── scripts/gitea.js # Node.js helper for Gitea API calls
|
||||||
|
└── pms-development/ # PMS todo development workflow (depends on above two)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Available Skills
|
||||||
|
|
||||||
|
| Skill | Purpose | Trigger Keywords |
|
||||||
|
|-------|---------|------------------|
|
||||||
|
| chinaweal-pms | Query PMS todos | PMS, 待办, todo |
|
||||||
|
| gitea-api | Gitea repository management | Gitea, 仓库管理 |
|
||||||
|
| pms-development | Full PMS todo development workflow | 开发PMS待办 |
|
||||||
|
|
||||||
|
## Required Environment Variables
|
||||||
|
|
||||||
|
```bash
|
||||||
|
CHINAWEAL_PMS_TOKEN # PMS system authentication token
|
||||||
|
GITEA_TOKEN47 # Gitea API token (server: 47.107.61.133:3000)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Key APIs
|
||||||
|
|
||||||
|
**PMS API** (chinaweal.com.cn):
|
||||||
|
- `GET /pms-api/api/todo/unfinished/list/all` - List unfinished todos
|
||||||
|
- `GET /pms-api/api/todo/detail/{todoNo}` - Get todo details
|
||||||
|
|
||||||
|
**Gitea API** (47.107.61.133:3000/api/v1):
|
||||||
|
- User: `GET /user`, `GET /users/{username}/repos`
|
||||||
|
- Repos: `POST /user/repos`, `GET /repos/{owner}/{repo}/branches`
|
||||||
|
- Issues: `GET /repos/{owner}/{repo}/issues`, `POST /repos/{owner}/{repo}/issues`
|
||||||
|
|
||||||
|
## Development Workflow (pms-development)
|
||||||
|
|
||||||
|
1. **Get requirements** - Use chinaweal-pms to fetch todo details if only todoNo provided
|
||||||
|
2. **Prepare repo** - Use gitea-api to find and clone the correct repository
|
||||||
|
3. **Create branch** - Branch name = todoNo (e.g., `TODO2024030001`)
|
||||||
|
4. **Develop** - Create `devdoc/{branch}/` documentation, implement backend by default
|
||||||
|
5. **Push** - Force push to remote after checking branch doesn't exist remotely
|
||||||
|
|
||||||
|
**Constraints**:
|
||||||
|
- Default is backend-only development unless frontend is explicitly specified
|
||||||
|
- Compile failures > 3 attempts → terminate and report
|
||||||
|
- Development docs saved to `devdoc/` directory
|
||||||
64
README.md
64
README.md
|
|
@ -1,3 +1,65 @@
|
||||||
# chinaweal-skills
|
# chinaweal-skills
|
||||||
|
|
||||||
公司适用的skills
|
众望通企业 Claude Code Skills 插件集合，用于企业业务系统集成开发。
|
||||||
|
|
||||||
|
## 插件列表
|
||||||
|
|
||||||
|
### pms-development
|
||||||
|
|
||||||
|
PMS 待办开发工具。用于开发 PMS 系统中的待办任务，包括仓库克隆、分支创建、需求开发、代码检查和分支推送。
|
||||||
|
|
||||||
|
**触发场景**: 开发 PMS 待办、开发待办
|
||||||
|
|
||||||
|
**依赖**: chinaweal-pms, gitea-api
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### chinaweal-pms
|
||||||
|
|
||||||
|
众望通 PMS 系统数据查询工具。用于查询 PMS 系统中的待办任务数据。
|
||||||
|
|
||||||
|
**触发场景**: 查询待办、待办详情、"PMS"、"待办"、"todo"
|
||||||
|
|
||||||
|
**前置要求**: 需要配置环境变量 `CHINAWEAL_PMS_TOKEN`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### gitea-api
|
||||||
|
|
||||||
|
Gitea API 调用工具。用于与 Gitea 代码托管平台进行交互。
|
||||||
|
|
||||||
|
**触发场景**: 调用 Gitea API、仓库管理、用户管理、Issue/PR 管理
|
||||||
|
|
||||||
|
**前置要求**: 需要配置环境变量 `GITEA_TOKEN47`
|
||||||
|
|
||||||
|
**API 基础地址**: `http://47.107.61.133:3000/api/v1`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 安装
|
||||||
|
|
||||||
|
将插件克隆到本地：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/lirh/chinaweal-skills.git ~/.claude/skills/chinaweal-skills
|
||||||
|
```
|
||||||
|
|
||||||
|
## 配置
|
||||||
|
|
||||||
|
### 环境变量
|
||||||
|
|
||||||
|
使用 `chinaweal-pms` 需要配置：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export CHINAWEAL_PMS_TOKEN="your-pms-token"
|
||||||
|
```
|
||||||
|
|
||||||
|
使用 `gitea-api` 需要配置：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export GITEA_TOKEN47="your-gitea-token"
|
||||||
|
```
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
Apache-2.0
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,135 @@
|
||||||
|
---
|
||||||
|
name: chinaweal-pms
|
||||||
|
description: |
|
||||||
|
众望通 PMS 系统数据查询工具。用于查询 PMS 系统中的待办任务数据。
|
||||||
|
|
||||||
|
当用户提到以下场景时使用此 Skill：
|
||||||
|
(1) 查询待办、待办详情、待办任务
|
||||||
|
(2) 需要从 PMS 系统获取任务信息
|
||||||
|
(3) 用户提到 "PMS"、"待办"、"todo"、"所有待办"、"未完成待办"
|
||||||
|
version: 1.0.0
|
||||||
|
license: Apache-2.0
|
||||||
|
metadata:
|
||||||
|
author: lirh
|
||||||
|
category: development
|
||||||
|
tags:
|
||||||
|
- pms
|
||||||
|
- chinaweal
|
||||||
|
- enterprise
|
||||||
|
- todo
|
||||||
|
---
|
||||||
|
|
||||||
|
# Chinaweal PMS 系统查询
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
|
||||||
|
此 Skill 用于查询众望通 PMS 系统（Project Management System）的数据。
|
||||||
|
|
||||||
|
## 认证配置
|
||||||
|
|
||||||
|
使用此 Skill 前，需要配置环境变量 `CHINAWEAL_PMS_TOKEN`：
|
||||||
|
|
||||||
|
- **环境变量名称**: `CHINAWEAL_PMS_TOKEN`
|
||||||
|
- **用途**: PMS 系统的用户授权 Token
|
||||||
|
|
||||||
|
### 请求鉴权方式
|
||||||
|
|
||||||
|
所有 API 请求需要在请求头中携带 Authorization 信息：
|
||||||
|
|
||||||
|
```
|
||||||
|
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
|
||||||
|
```
|
||||||
|
|
||||||
|
其中 `{CHINAWEAL_PMS_TOKEN}` 需要替换为环境变量 `CHINAWEAL_PMS_TOKEN` 的值。
|
||||||
|
|
||||||
|
## 功能清单
|
||||||
|
|
||||||
|
### 功能1: 查询所有未完成待办
|
||||||
|
|
||||||
|
查询当前用户的所有未完成待办任务列表。
|
||||||
|
|
||||||
|
**接口地址**: `https://www.chinaweal.com.cn/pms-api/api/todo/unfinished/list/all`
|
||||||
|
|
||||||
|
**请求方法**: GET
|
||||||
|
|
||||||
|
**请求头**:
|
||||||
|
```
|
||||||
|
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
|
||||||
|
Content-Type: application/json
|
||||||
|
```
|
||||||
|
|
||||||
|
**查询参数**:
|
||||||
|
- `status` - 任务状态，0 表示未完成
|
||||||
|
|
||||||
|
**响应关键字段**:
|
||||||
|
- `todoNo` - 待办编号
|
||||||
|
- `todoTitle` - 待办标题
|
||||||
|
- `todoDescription` - 待办描述
|
||||||
|
- `createTime` - 创建时间
|
||||||
|
|
||||||
|
**使用示例**
|
||||||
|
|
||||||
|
```
|
||||||
|
帮我查询所有待办
|
||||||
|
查询所有未完成的待办
|
||||||
|
看看我有哪些待办任务
|
||||||
|
我的待办有哪些
|
||||||
|
```
|
||||||
|
|
||||||
|
### 功能2: 查询待办详情
|
||||||
|
|
||||||
|
查询指定待办编号的详细信息。
|
||||||
|
|
||||||
|
**接口地址**: `https://www.chinaweal.com.cn/pms-api/api/todo/detail/{todoNo}`
|
||||||
|
|
||||||
|
**请求方法**: GET
|
||||||
|
|
||||||
|
**请求头**:
|
||||||
|
```
|
||||||
|
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
|
||||||
|
Content-Type: application/json
|
||||||
|
```
|
||||||
|
|
||||||
|
**路径参数**:
|
||||||
|
- `todoNo` - 待办编号
|
||||||
|
|
||||||
|
**响应关键字段**:
|
||||||
|
- `todoTitle` - 待办标题
|
||||||
|
- `todoDescription` - 待办任务的详情描述
|
||||||
|
- `todoAtt` - 待办附件下载地址清单（下载地址中包含 `filename` 参数，表示附件原名）
|
||||||
|
|
||||||
|
### 使用示例
|
||||||
|
|
||||||
|
```
|
||||||
|
帮我查询待办号 TODO2024030001 的详情
|
||||||
|
查询一下 todoNo 为 12345 的待办信息
|
||||||
|
```
|
||||||
|
|
||||||
|
### 调用方式
|
||||||
|
|
||||||
|
使用 exec 工具执行 curl 命令进行 API 调用。
|
||||||
|
|
||||||
|
**查询所有未完成待办**:
|
||||||
|
```bash
|
||||||
|
CHINAWEAL_PMS_TOKEN="your-token-here"
|
||||||
|
|
||||||
|
curl -X GET "https://www.chinaweal.com.cn/pms-api/api/todo/unfinished/list/all" \
|
||||||
|
-H "Authorization: Bearer ${CHINAWEAL_PMS_TOKEN}" \
|
||||||
|
-H "Content-Type: application/json"
|
||||||
|
```
|
||||||
|
|
||||||
|
**查询单个待办详情**:
|
||||||
|
```bash
|
||||||
|
CHINAWEAL_PMS_TOKEN="your-token-here"
|
||||||
|
TODO_NO="TODO2024030001"
|
||||||
|
|
||||||
|
curl -X GET "https://www.chinaweal.com.cn/pms-api/api/todo/detail/${TODO_NO}" \
|
||||||
|
-H "Authorization: Bearer ${CHINAWEAL_PMS_TOKEN}" \
|
||||||
|
-H "Content-Type: application/json"
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. 确保环境变量 `CHINAWEAL_PMS_TOKEN` 已正确配置
|
||||||
|
2. 待办编号 `todoNo` 需要从 PMS 系统获取
|
||||||
|
3. 附件下载地址中包含 `filename` 参数，即为附件原文件名
|
||||||
|
|
@ -0,0 +1,99 @@
|
||||||
|
---
|
||||||
|
name: gitea-api
|
||||||
|
description: |
|
||||||
|
Gitea API 调用工具。用于与 Gitea 代码托管平台进行交互，包括仓库管理、用户管理、组织操作、Issue/PR 管理等。
|
||||||
|
|
||||||
|
当用户提到以下场景时使用此 Skill：
|
||||||
|
(1) 需要调用 Gitea API (如 /api/v1/ 开头的接口)
|
||||||
|
(2) 需要在 Gitea 上创建/查询/管理仓库
|
||||||
|
(3) 需要管理用户、组织、团队
|
||||||
|
(4) 需要操作 Issue、Pull Request
|
||||||
|
(5) 需要查看/管理 Git 提交、分支
|
||||||
|
(6) 用户提到 "Gitea"、"代码托管"、"仓库管理"
|
||||||
|
version: 1.0.0
|
||||||
|
license: Apache-2.0
|
||||||
|
metadata:
|
||||||
|
author: lirh
|
||||||
|
category: development
|
||||||
|
tags:
|
||||||
|
- gitea
|
||||||
|
- api
|
||||||
|
- git
|
||||||
|
- repository
|
||||||
|
---
|
||||||
|
|
||||||
|
# Gitea API Skill
|
||||||
|
|
||||||
|
## 快速开始
|
||||||
|
|
||||||
|
此 Skill 提供调用 Gitea API 的能力。API 基础 URL: `http://47.107.61.133:3000/api/v1`
|
||||||
|
|
||||||
|
认证方式：使用环境变量 `GITEA_TOKEN47` 作为 Bearer Token。
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 方式一：使用封装好的工具函数
|
||||||
|
|
||||||
|
直接调用以下工具函数（见 scripts/gitea.js）：
|
||||||
|
|
||||||
|
- `gitea_get(endpoint, params)` - GET 请求
|
||||||
|
- `gitea_post(endpoint, data)` - POST 请求
|
||||||
|
- `gitea_patch(endpoint, data)` - PATCH 请求
|
||||||
|
- `gitea_delete(endpoint)` - DELETE 请求
|
||||||
|
|
||||||
|
示例：
|
||||||
|
```
|
||||||
|
调用 gitea_get 获取当前用户信息
|
||||||
|
调用 gitea_get 获取仓库列表
|
||||||
|
调用 gitea_post 创建新仓库
|
||||||
|
```
|
||||||
|
|
||||||
|
### 方式二：直接使用 curl
|
||||||
|
|
||||||
|
```bash
|
||||||
|
TOKEN=$GITEA_TOKEN47
|
||||||
|
curl -H "Authorization: token $TOKEN" http://47.107.61.133:3000/api/v1/user
|
||||||
|
```
|
||||||
|
|
||||||
|
## 常用 API 示例
|
||||||
|
|
||||||
|
### 用户相关
|
||||||
|
- `GET /user` - 获取当前用户信息
|
||||||
|
- `GET /users/{username}` - 获取指定用户信息
|
||||||
|
- `GET /users/{username}/repos` - 获取用户仓库列表
|
||||||
|
|
||||||
|
### 仓库相关
|
||||||
|
- `GET /repos/{owner}/{repo}` - 获取仓库信息
|
||||||
|
- `POST /user/repos` - 创建仓库（当前用户）
|
||||||
|
- `POST /orgs/{org}/repos` - 在组织中创建仓库
|
||||||
|
- `GET /repos/{owner}/{repo}/branches` - 获取分支列表
|
||||||
|
- `GET /repos/{owner}/{repo}/commits` - 获取提交历史
|
||||||
|
|
||||||
|
### Issue 相关
|
||||||
|
- `GET /repos/{owner}/{repo}/issues` - 获取 Issue 列表
|
||||||
|
- `POST /repos/{owner}/{repo}/issues` - 创建 Issue
|
||||||
|
- `GET /repos/{owner}/{repo}/issues/{index}` - 获取 Issue 详情
|
||||||
|
- `PATCH /repos/{owner}/{repo}/issues/{index}` - 更新 Issue
|
||||||
|
|
||||||
|
### 组织相关
|
||||||
|
- `GET /orgs` - 获取组织列表
|
||||||
|
- `GET /orgs/{org}` - 获取组织详情
|
||||||
|
- `POST /orgs` - 创建组织
|
||||||
|
- `GET /orgs/{org}/members` - 获取组织成员
|
||||||
|
|
||||||
|
### 管理相关 (需要管理员权限)
|
||||||
|
- `GET /admin/users` - 列出所有用户
|
||||||
|
- `POST /admin/users` - 创建用户
|
||||||
|
- `DELETE /admin/users/{username}` - 删除用户
|
||||||
|
|
||||||
|
## 错误处理
|
||||||
|
|
||||||
|
API 返回状态码说明：
|
||||||
|
- 200/201: 成功
|
||||||
|
- 204: 成功（无返回内容）
|
||||||
|
- 400: 请求参数错误
|
||||||
|
- 401: 未认证
|
||||||
|
- 403: 权限不足
|
||||||
|
- 404: 资源不存在
|
||||||
|
- 422: 验证错误
|
||||||
|
- 500: 服务器错误
|
||||||
|
|
@ -0,0 +1,93 @@
|
||||||
|
#!/usr/bin/env node
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gitea API Client
|
||||||
|
* 提供调用 Gitea API 的工具函数
|
||||||
|
*/
|
||||||
|
|
||||||
|
const BASE_URL = 'http://47.107.61.133:3000/api/v1';
|
||||||
|
|
||||||
|
function getToken() {
|
||||||
|
// 优先从环境变量读取，其次从命令行参数读取
|
||||||
|
const token = process.env['GITEA_TOKEN47'];
|
||||||
|
if (!token) {
|
||||||
|
// 检查是否有命令行传入的 token
|
||||||
|
const tokenArg = process.argv.find(arg => arg.startsWith('--token='));
|
||||||
|
if (tokenArg) {
|
||||||
|
return tokenArg.replace('--token=', '');
|
||||||
|
}
|
||||||
|
throw new Error('环境变量 GITEA_TOKEN47 未设置，请设置环境变量或使用 --token= 参数');
|
||||||
|
}
|
||||||
|
return token;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function giteaRequest(method, endpoint, data = null, params = {}) {
|
||||||
|
const token = getToken();
|
||||||
|
let url = `${BASE_URL}${endpoint}`;
|
||||||
|
|
||||||
|
// 添加查询参数
|
||||||
|
if (Object.keys(params).length > 0) {
|
||||||
|
const queryString = new URLSearchParams(params).toString();
|
||||||
|
url += `?${queryString}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
const options = {
|
||||||
|
method,
|
||||||
|
headers: {
|
||||||
|
'Authorization': `token ${token}`,
|
||||||
|
'Content-Type': 'application/json',
|
||||||
|
'Accept': 'application/json'
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
if (data && (method === 'POST' || method === 'PATCH' || method === 'PUT')) {
|
||||||
|
options.body = JSON.stringify(data);
|
||||||
|
}
|
||||||
|
|
||||||
|
const response = await fetch(url, options);
|
||||||
|
|
||||||
|
// 处理响应
|
||||||
|
const contentType = response.headers.get('content-type');
|
||||||
|
if (contentType && contentType.includes('application/json')) {
|
||||||
|
const result = await response.json();
|
||||||
|
if (!response.ok) {
|
||||||
|
throw new Error(`API Error: ${response.status} - ${JSON.stringify(result)}`);
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
} else {
|
||||||
|
if (!response.ok) {
|
||||||
|
throw new Error(`API Error: ${response.status} - ${response.statusText}`);
|
||||||
|
}
|
||||||
|
return response.status === 204 ? null : await response.text();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 导出工具函数
|
||||||
|
const gitea = {
|
||||||
|
get: (endpoint, params = {}) => giteaRequest('GET', endpoint, null, params),
|
||||||
|
post: (endpoint, data = {}) => giteaRequest('POST', endpoint, data),
|
||||||
|
patch: (endpoint, data = {}) => giteaRequest('PATCH', endpoint, data),
|
||||||
|
put: (endpoint, data = {}) => giteaRequest('PUT', endpoint, data),
|
||||||
|
delete: (endpoint) => giteaRequest('DELETE', endpoint)
|
||||||
|
};
|
||||||
|
|
||||||
|
// CLI 模式
|
||||||
|
if (require.main === module) {
|
||||||
|
const args = process.argv.slice(2);
|
||||||
|
const command = args[0];
|
||||||
|
|
||||||
|
if (command === 'get') {
|
||||||
|
const endpoint = args[1];
|
||||||
|
gitea.get(endpoint).then(result => console.log(JSON.stringify(result, null, 2)));
|
||||||
|
} else if (command === 'post') {
|
||||||
|
const endpoint = args[1];
|
||||||
|
const data = JSON.parse(args[2] || '{}');
|
||||||
|
gitea.post(endpoint, data).then(result => console.log(JSON.stringify(result, null, 2)));
|
||||||
|
} else {
|
||||||
|
console.log('Usage:');
|
||||||
|
console.log(' node gitea.js get <endpoint>');
|
||||||
|
console.log(' node gitea.js post <endpoint> <json-data>');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = gitea;
|
||||||
|
|
@ -0,0 +1,88 @@
|
||||||
|
---
|
||||||
|
name: pms-development
|
||||||
|
description: PMS待办开发工具。用于开发PMS系统中的待办任务。当用户提到开发PMS待办、开发待办时使用此技能。需要根据待办详情进行代码开发，包括仓库克隆、分支创建、需求开发、代码检查和分支推送。
|
||||||
|
version: 1.0.0
|
||||||
|
license: Apache-2.0
|
||||||
|
metadata:
|
||||||
|
author: lirh
|
||||||
|
category: development
|
||||||
|
tags:
|
||||||
|
- pms
|
||||||
|
- development
|
||||||
|
- enterprise
|
||||||
|
---
|
||||||
|
|
||||||
|
# PMS待办开发
|
||||||
|
|
||||||
|
## 触发条件
|
||||||
|
|
||||||
|
用户要求开发PMS待办时使用此技能。
|
||||||
|
|
||||||
|
## 步骤一：获取需求
|
||||||
|
|
||||||
|
### 情况A：用户已提供详细需求
|
||||||
|
直接进入步骤二。
|
||||||
|
|
||||||
|
### 情况B：用户只提供PMS待办编号
|
||||||
|
1. 调用 chinaweal-pms skill 查询待办详情
|
||||||
|
2. 从待办详情中提取需求描述、技术要求等信息
|
||||||
|
|
||||||
|
## 步骤二：仓库准备
|
||||||
|
|
||||||
|
### 2.1 确定仓库
|
||||||
|
1. 分析需求/待办详情，判断属于哪个仓库
|
||||||
|
2. 如无法判断，使用 gitea-api skill 查询仓库清单
|
||||||
|
3. 从仓库清单中找到匹配的仓库
|
||||||
|
|
||||||
|
### 2.2 克隆仓库
|
||||||
|
1. 选择合适的本地路径存放仓库
|
||||||
|
2. 如果父目录不存在，创建父目录
|
||||||
|
3. 克隆命令：`git clone <仓库地址> <本地路径>`
|
||||||
|
|
||||||
|
### 2.3 检查仓库状态
|
||||||
|
- 如果仓库为空，删除目录后重新克隆
|
||||||
|
|
||||||
|
## 步骤三：分支创建
|
||||||
|
|
||||||
|
1. 切换到仓库目录
|
||||||
|
2. 拉取远端主分支最新代码
|
||||||
|
3. 创建新分支：
|
||||||
|
- 如果是开发PMS待办，分支名 = 待办编号
|
||||||
|
- 否则分支名 = 当前日期时间（格式：yyyyMMddHHmm）
|
||||||
|
4. 切换到新分支
|
||||||
|
|
||||||
|
## 步骤四：需求开发
|
||||||
|
|
||||||
|
### 4.1 创建开发文档
|
||||||
|
|
||||||
|
在项目根目录创建 `devdoc/` 目录，然后创建（文件名前缀为当前分支名称）：
|
||||||
|
|
||||||
|
**{分支名}_需求清单.md** - 列出需要开发的功能点
|
||||||
|
|
||||||
|
**{分支名}_开发思路与改动.md** - 记录每个需求的开发思路和具体代码改动
|
||||||
|
|
||||||
|
**{分支名}_失败报告.md** - 记录开发失败的原因和尝试次数
|
||||||
|
|
||||||
|
### 4.2 进行开发
|
||||||
|
在新建分支中进行代码开发。
|
||||||
|
|
||||||
|
### 4.3 代码检查
|
||||||
|
开发完成后：
|
||||||
|
1. 检查语法错误
|
||||||
|
2. 尝试编译项目
|
||||||
|
3. 如有错误，尝试修复
|
||||||
|
4. 同一问题修复3次仍失败，记录到 `devdoc/{分支名}_失败报告.md`，终止开发
|
||||||
|
|
||||||
|
## 步骤五：推送分支
|
||||||
|
|
||||||
|
1. 检查远端仓库是否存在当前分支
|
||||||
|
2. 如果远端分支已存在，报告用户无法推送
|
||||||
|
3. 如果远端分支不存在，强制推送分支到远端
|
||||||
|
|
||||||
|
## 关键约束
|
||||||
|
|
||||||
|
- **默认只开发后端接口**：如果没有明确指定仓库，或者没有明确指定需要开发前端，则默认只开发后端接口
|
||||||
|
- 所有操作在workspace中进行
|
||||||
|
- 开发文档必须保存到 `devdoc/` 目录，文件名以分支名为前缀
|
||||||
|
- 编译失败超过3次必须终止并报告
|
||||||
|
- 推送前必须检查远端分支是否存在
|
||||||
Loading…
Reference in New Issue