# 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