59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
|
# 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
|