chinaweal-claude-code/CLAUDE.md

2.2 KiB

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)

  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