2.2 KiB

Raw Permalink Blame History

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

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)

Get requirements - Use chinaweal-pms to fetch todo details if only todoNo provided
Prepare repo - Use gitea-api to find and clone the correct repository
Create branch - Branch name = todoNo (e.g., TODO2024030001)
Develop - Create devdoc/{branch}/ documentation, implement backend by default
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

2.2 KiB Raw Permalink Blame History