ai-proj-helper/skills-core/ai-proj-plugin/README.md

ai-proj Plugin

AI project task and requirement management through direct REST API calls.

Features

• Task Management: Create, list, update, and complete tasks
• Requirement Management: Full requirement lifecycle (draft → review → development → complete)
• Documentation: Create and manage task documents
• Daily Focus: Plan and view today's tasks
• Direct API Integration: Uses REST API directly

Quick Start

Just install the plugin and start using it:

/plugin install ai-proj-plugin@coolbuy-claude-plugins

That's it! No configuration needed.

Usage

This plugin provides Agent Skills that I (Claude) automatically use when you mention relevant topics.

Examples

Task Management:

• "Create a task: implement user authentication"
• "List all in-progress tasks"
• "Complete task 123"
• "Show me task 456"

Requirement Management:

• "Create requirement: add dark mode support"
• "List requirements in draft status"
• "Submit requirement 789 for review"
• "Approve requirement 789"

Daily Focus:

• "Show today's tasks"
• "Add task 123 to today's focus"

Documents:

• "Show the document for task 123"
• "Update task 456's document with: [content]"

Configuration (Optional)

The plugin uses a default API token that works for most users. If you need to use a custom token:

Environment Variable

export AIPROJ_TOKEN="your_custom_token_here"

Add this to your ~/.zshrc or ~/.bashrc to make it persistent.

How It Works

This plugin uses a simple, straightforward approach:

1. Makes direct REST API calls to https://ai.pipexerp.com/api/v1
2. Uses curl for HTTP requests
3. Automatically finds the API token from:
   • $AIPROJ_TOKEN environment variable
   • Built-in default token

Advantages

• ✅ No setup required - works immediately after installation
• ✅ No server process - simple and lightweight
• ✅ No dependencies - just needs curl (built into all systems)
• ✅ Simple architecture - direct API calls
• ✅ Easy debugging - can see exact API calls

API Endpoints

The plugin uses these endpoints:

• GET /tasks - List tasks
• POST /tasks - Create task
• GET /tasks/{id} - Get task details
• PATCH /tasks/{id} - Update task
• DELETE /tasks/{id} - Delete task
• GET /requirements - List requirements
• POST /requirements - Create requirement
• POST /requirements/{id}/actions - Update requirement status
• GET /tasks/{id}/document - Get task document
• PUT /tasks/{id}/document - Update task document
• GET /daily-focus/tasks - Get today's tasks
• POST /daily-focus/tasks - Add task to today

Troubleshooting

"Unauthorized" or API errors

Check your token:

echo $AIPROJ_TOKEN

If empty, either set the environment variable or the plugin will use the default token.

API not responding

Verify the API is accessible:

curl -I https://ai.pipexerp.com/api/v1/health

Skills not working

• Agent Skills don't create slash commands
• Just ask naturally: "create a task", "list tasks", etc.
• The plugin is automatically active when installed

Technical Details

API Base: https://ai.pipexerp.com/api/v1 Authentication: Bearer token in Authorization header Data Format: JSON Date Format: ISO 8601 (YYYY-MM-DD) Default Project ID: 1

Documentation

For detailed API documentation and examples, see skills/SKILL.md.

Support

• Repository: git@gitea.pipexerp.com:huangjun/claude-marketplace.git
• Author: qiudl@zhiyuncai.com