team-toon-tack 2.1.0 → 2.3.2

package/.claude-plugin/marketplace.json

@@ -0,0 +1,19 @@
+{
+	"name": "ttt-marketplace",
+	"owner": {
+		"name": "wayne930242",
+		"email": "wayne930242@gmail.com"
+	},
+	"metadata": {
+		"description": "Linear task management tools for Claude Code - efficient workflow without MCP overhead",
+		"version": "1.0.0"
+	},
+	"plugins": [
+		{
+			"name": "team-toon-tack",
+			"source": "./",
+			"description": "Linear task sync & management CLI with commands and skills",
+			"version": "2.3.2"
+		}
+	]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+	"name": "team-toon-tack",
+	"description": "Linear task sync & management CLI for Claude Code - saves tokens vs MCP",
+	"version": "2.3.2",
+	"author": {
+		"name": "wayne930242",
+		"email": "wayne930242@gmail.com"
+	},
+	"repository": "https://github.com/wayne930242/team-toon-tack",
+	"license": "MIT",
+	"keywords": [
+		"claude-code",
+		"linear",
+		"task-management",
+		"workflow",
+		"productivity"
+	]
+}

package/README.md

@@ -14,7 +14,7 @@ Optimized Linear workflow for Claude Code — saves significant tokens compared
 - **QA Team Support** — Auto-update parent issues in QA team to "Testing" when completing dev tasks
 - **Attachment Download** — Auto-download Linear images and files to local `.ttt/output/` for AI vision analysis
 - **Blocked Status** — Set tasks as blocked when waiting on external dependencies
-- **Auto Command Setup** — `ttt init` can install Claude Code commands with custom prefix
+- **Claude Code Plugin** — Install plugin for `/ttt:*` commands and auto-activated skills
 - **Cycle History** — Local `.toon` files preserve cycle data for AI context
 - **User Filtering** — Only see issues assigned to you or unassigned
 
@@ -36,7 +36,6 @@ During init, you'll configure:
 - **QA team(s)**: For cross-team parent issue updates, each with its own testing status (optional)
 - **Completion mode**: How task completion is handled (see below)
 - **Status source**: `remote` (update Linear immediately) or `local` (work offline, sync with `ttt sync --update`)
-- **Claude Code commands**: Auto-install with optional prefix (e.g., `/ttt:work-on`)
 
 ### Completion Modes
 
@@ -47,17 +46,30 @@ During init, you'll configure:
 | `upstream_strict` | Mark task as Done + parent to Testing. Falls back to dev testing if no parent. Default when QA team configured. |
 | `upstream_not_strict` | Mark task as Done + parent to Testing. No fallback if no parent. |
 
-### 2. Daily Workflow
+### 2. Install Claude Code Plugin (Optional)
 
-In Claude Code:
+```
+/plugin marketplace add wayne930242/team-toon-tack
+/plugin install team-toon-tack@wayne930242
+```
+
+### 3. Daily Workflow
+
+In Claude Code (with plugin installed):
 
 ```
-/sync              # Fetch all Linear issues for current cycle
-/work-on next      # Pick highest priority task & start working
-/done-job          # Complete task with AI-generated summary
+/ttt:sync              # Fetch all Linear issues for current cycle
+/ttt:work-on next      # Pick highest priority task & start working
+/ttt:done              # Complete task with AI-generated summary
 ```
 
-That's it.
+Or using CLI directly:
+
+```bash
+ttt sync
+ttt work-on next
+ttt done -m "Completed the task"
+```
 
 ---
 
@@ -116,6 +128,20 @@ ttt status MP-123 --set done    # Mark as done
 ttt status MP-123 --set blocked # Set as blocked (waiting on dependency)
 ```
 
+### `ttt show`
+
+Show issue details or search issues from local cycle data.
+
+```bash
+ttt show                       # Show all issues in local cycle data
+ttt show MP-123                # Show specific issue from local data
+ttt show MP-123 --remote       # Fetch specific issue from Linear
+ttt show --label frontend      # Filter by label
+ttt show --status "In Progress" --user me   # My in-progress issues
+ttt show --priority 1          # Show urgent issues
+ttt show --export              # Export as markdown
+```
+
 ### `ttt config`
 
 Configure settings.
@@ -147,6 +173,29 @@ your-project/
 | `LINEAR_API_KEY` | **Required.** Your Linear API key |
 | `TOON_DIR` | Config directory (default: `.ttt`) |
 
+## Claude Code Plugin
+
+Install the plugin for Claude Code integration:
+
+```
+/plugin marketplace add wayne930242/team-toon-tack
+/plugin install team-toon-tack@wayne930242
+```
+
+### Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `/ttt:sync` | Sync Linear issues to local cycle data |
+| `/ttt:work-on` | Start working on a task |
+| `/ttt:done` | Mark current task as completed |
+| `/ttt:status` | Show or modify task status |
+| `/ttt:show` | Show issue details or search issues |
+
+### Auto-Activated Skill
+
+The plugin includes a `linear-task-manager` skill that automatically activates when working with Linear tasks, providing workflow guidance and best practices.
+
 ## License
 
 MIT

package/README.zh-TW.md

@@ -14,7 +14,7 @@
 - **QA 團隊支援** — 完成開發任務時自動將 QA 團隊的 parent issue 更新為「Testing」
 - **附件下載** — 自動下載 Linear 圖片和檔案到本地 `.ttt/output/`，供 AI 視覺分析
 - **阻塞狀態** — 等待外部依賴時可設定任務為 blocked
-- **自動安裝指令** — `ttt init` 可自動安裝 Claude Code commands，支援自訂前綴
+- **Claude Code Plugin** — 安裝 plugin 即可使用 `/ttt:*` 指令和自動啟用的技能
 - **Cycle 歷史保存** — 本地 `.toon` 檔案保留 cycle 資料，方便 AI 檢閱
 - **使用者過濾** — 只顯示指派給你或未指派的工作
 
@@ -36,7 +36,6 @@ ttt init
 - **QA 團隊**：跨團隊 parent issue 更新，各自設定 testing 狀態（可選）
 - **完成模式**：任務完成時的處理方式（見下方說明）
 - **狀態來源**：`remote`（即時更新 Linear）或 `local`（離線工作，用 `ttt sync --update` 同步）
-- **Claude Code commands**：自動安裝，可選前綴（如 `/ttt:work-on`）
 
 ### 完成模式
 
@@ -47,17 +46,30 @@ ttt init
 | `upstream_strict` | 任務標記為 Done，parent 移動到 Testing。若無 parent，fallback 到開發團隊的 testing 狀態。設定 QA 團隊時的預設值。 |
 | `upstream_not_strict` | 任務標記為 Done，parent 移動到 Testing。若無 parent 不做 fallback。 |
 
-### 2. 每日工作流
+### 2. 安裝 Claude Code Plugin（選擇性）
 
-在 Claude Code 中：
+```
+/plugin marketplace add wayne930242/team-toon-tack
+/plugin install team-toon-tack@wayne930242
+```
+
+### 3. 每日工作流
+
+在 Claude Code 中（安裝 plugin 後）：
 
 ```
-/sync              # 從 Linear 取得當前 cycle 所有 issue
-/work-on next      # 挑選最高優先級任務並開始工作
-/done-job          # 完成任務，附上 AI 生成的摘要
+/ttt:sync              # 從 Linear 取得當前 cycle 所有 issue
+/ttt:work-on next      # 挑選最高優先級任務並開始工作
+/ttt:done              # 完成任務，附上 AI 生成的摘要
 ```
 
-就這樣。
+或直接使用 CLI：
+
+```bash
+ttt sync
+ttt work-on next
+ttt done -m "完成任務"
+```
 
 ---
 
@@ -116,6 +128,20 @@ ttt status MP-123 --set done    # 標記為完成
 ttt status MP-123 --set blocked # 設為阻塞（等待外部依賴）
 ```
 
+### `ttt show`
+
+顯示 issue 詳情或搜尋 issue。
+
+```bash
+ttt show                       # 顯示本地 cycle 資料中的所有 issue
+ttt show MP-123                # 顯示特定 issue（從本地資料）
+ttt show MP-123 --remote       # 從 Linear 取得特定 issue
+ttt show --label frontend      # 依標籤過濾
+ttt show --status "In Progress" --user me   # 我進行中的 issue
+ttt show --priority 1          # 顯示緊急 issue
+ttt show --export              # 輸出為 markdown 格式
+```
+
 ### `ttt config`
 
 配置設定。
@@ -147,6 +173,29 @@ your-project/
 | `LINEAR_API_KEY` | **必填**。你的 Linear API 金鑰 |
 | `TOON_DIR` | 配置目錄（預設：`.ttt`） |
 
+## Claude Code Plugin
+
+安裝 plugin 以整合 Claude Code：
+
+```
+/plugin marketplace add wayne930242/team-toon-tack
+/plugin install team-toon-tack@wayne930242
+```
+
+### 可用指令
+
+| 指令 | 說明 |
+|------|------|
+| `/ttt:sync` | 同步 Linear issue 到本地 |
+| `/ttt:work-on` | 開始處理任務 |
+| `/ttt:done` | 標記當前任務完成 |
+| `/ttt:status` | 顯示或修改任務狀態 |
+| `/ttt:show` | 顯示 issue 詳情或搜尋 issue |
+
+### 自動啟用技能
+
+Plugin 包含 `linear-task-manager` 技能，在處理 Linear 任務時會自動啟用，提供工作流程指導和最佳實踐。
+
 ## 授權
 
 MIT

package/commands/ttt:done.md

@@ -0,0 +1,64 @@
+---
+name: ttt:done
+description: Mark current task as completed
+arguments:
+  - name: issue-id
+    description: Optional issue ID if multiple tasks in progress
+    required: false
+  - name: message
+    description: Completion message (use -m flag)
+    required: false
+---
+
+# TTT Done Command
+
+Mark the current in-progress task as completed.
+
+## Usage
+
+### Auto-Select (single in-progress task)
+```bash
+ttt done
+```
+
+### Specific Issue
+If `issue-id` is provided:
+```bash
+ttt done {{ issue-id }}
+```
+
+### With Completion Message
+If `message` is provided:
+```bash
+ttt done -m "{{ message }}"
+```
+
+### Combined
+```bash
+ttt done {{ issue-id }} -m "{{ message }}"
+```
+
+## What This Does
+
+Based on configured completion mode:
+
+| Mode | Behavior |
+|------|----------|
+| `simple` | Task → Done, Parent → Done |
+| `strict_review` | Task → Testing, Parent → QA Testing |
+| `upstream_strict` | Task → Done, Parent → Testing |
+| `upstream_not_strict` | Task → Done, Parent → Testing (no fallback) |
+
+Also:
+1. Gets latest git commit info
+2. Adds completion comment to Linear with commit details
+3. Syncs task back from Linear to update local status
+
+## Before Running
+
+Ensure you have:
+1. **Run project validation** - Use `/validate` command or validation skill if available
+2. Committed your changes with a meaningful message
+3. Pushed to remote branch (if applicable)
+
+**Important**: If validation fails, fix issues before marking as done.

package/commands/ttt:show.md

@@ -0,0 +1,126 @@
+---
+name: ttt:show
+description: Show issue details or search issues from local cycle data
+arguments:
+  - name: issue-id
+    description: Issue ID to show (e.g., MP-624)
+    required: false
+  - name: label
+    description: Filter by label (--label <label>)
+    required: false
+  - name: status
+    description: Filter by status (--status <status>)
+    required: false
+  - name: user
+    description: Filter by assignee (--user <email|me|unassigned>)
+    required: false
+  - name: priority
+    description: Filter by priority (--priority <0-4>)
+    required: false
+  - name: remote
+    description: Fetch from Linear instead of local data (--remote)
+    required: false
+  - name: export
+    description: Output as markdown format (--export)
+    required: false
+---
+
+# TTT Show Command
+
+Show issue details or search issues from local cycle data.
+
+## Usage
+
+### Show All Issues
+```bash
+ttt show
+```
+
+### Show Specific Issue
+```bash
+ttt show {{ issue-id }}
+```
+
+### Search by Filters
+```bash
+ttt show --label {{ label }}
+ttt show --status "{{ status }}"
+ttt show --user {{ user }}
+ttt show --priority {{ priority }}
+```
+
+### Fetch from Linear (Remote)
+```bash
+ttt show {{ issue-id }} --remote
+ttt show --remote --status todo
+```
+
+## What This Does
+
+1. By default, reads from local cycle.toon data (no API calls)
+2. Supports filtering by label, status, user, priority
+3. Use --remote to fetch fresh data from Linear API
+4. Displays comprehensive information:
+   - Title and description
+   - Status (both Linear and local)
+   - Priority level
+   - Labels
+   - Assignee
+   - Branch name
+   - Parent issue (if subtask)
+   - Attachments with local paths
+   - Comments with timestamps
+
+## Filter Options
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| `--label` | Filter by label name | `--label frontend` |
+| `--status` | Filter by Linear status | `--status "In Progress"` |
+| `--user` | Filter by assignee | `--user me`, `--user unassigned` |
+| `--priority` | Filter by priority (0-4) | `--priority 1` (Urgent) |
+| `--remote` | Fetch from Linear API | `--remote` |
+| `--export` | Output as markdown | `--export` |
+
+## Priority Values
+
+- 0: None
+- 1: Urgent
+- 2: High
+- 3: Medium
+- 4: Low
+
+## Use Cases
+
+- List all issues in current cycle
+- Search issues by label or status
+- Review issue details before starting work
+- Check requirements and acceptance criteria
+- View attachments and mockups
+- Read comment history and discussions
+
+## Examples
+
+```bash
+# Show all local issues
+ttt show
+
+# Show specific issue
+ttt show MP-624
+
+# My in-progress issues
+ttt show --status "In Progress" --user me
+
+# All urgent issues
+ttt show --priority 1
+
+# Frontend issues
+ttt show --label frontend
+
+# Fetch fresh data from Linear
+ttt show MP-624 --remote
+
+# Export as markdown
+ttt show --export
+ttt show MP-624 --export
+```

package/commands/ttt:status.md

@@ -0,0 +1,65 @@
+---
+name: ttt:status
+description: Show or modify task status
+arguments:
+  - name: issue-id
+    description: Issue ID to check/modify (omit for current in-progress task)
+    required: false
+  - name: set
+    description: New status to set (+1, -1, pending, in-progress, completed, blocked, done)
+    required: false
+---
+
+# TTT Status Command
+
+Show or modify the status of a task.
+
+## Usage
+
+### Show Current In-Progress Task
+```bash
+ttt status
+```
+
+### Show Specific Issue
+If `issue-id` is provided:
+```bash
+ttt status {{ issue-id }}
+```
+
+### Set Status
+If `set` is provided:
+```bash
+ttt status {{ issue-id }} --set {{ set }}
+```
+
+## Status Values
+
+| Value | Description |
+|-------|-------------|
+| `+1` | Move to next status (pending → in-progress → completed) |
+| `-1` | Move to previous status |
+| `+2` | Skip two statuses forward |
+| `-2` | Skip two statuses backward |
+| `pending` | Set to pending |
+| `in-progress` | Set to in-progress |
+| `completed` | Set to completed |
+| `blocked` | Set to blocked (waiting on dependency) |
+| `todo` | Set Linear to Todo status |
+| `done` | Set Linear to Done status |
+
+## Examples
+
+```bash
+ttt status MP-624 --set +1       # Move to next status
+ttt status MP-624 --set blocked  # Mark as blocked
+ttt status --set pending         # Reset current task
+```
+
+## Output
+
+Displays:
+- Task ID and title
+- Local status vs Linear status
+- Priority and labels
+- Assignee information

package/commands/ttt:sync.md

@@ -0,0 +1,51 @@
+---
+name: ttt:sync
+description: Sync Linear issues to local cycle data
+arguments:
+  - name: issue-id
+    description: Optional specific issue ID to sync (e.g., MP-624)
+    required: false
+  - name: update
+    description: Push local status changes to Linear (add --update flag)
+    required: false
+---
+
+# TTT Sync Command
+
+Sync issues from Linear to local `.ttt/cycle.toon` file.
+
+## Usage
+
+Run the sync command based on arguments provided:
+
+### Default Sync (all matching issues)
+```bash
+ttt sync
+```
+
+### Sync Specific Issue
+If `issue-id` is provided:
+```bash
+ttt sync {{ issue-id }}
+```
+
+### Push Local Changes
+If `update` is "true" or "--update":
+```bash
+ttt sync --update
+```
+
+## What This Does
+
+1. Fetches active cycle from Linear
+2. Downloads all issues matching configured filters (team, status, labels)
+3. Preserves local status for existing tasks
+4. Downloads Linear images to `.ttt/output/`
+5. Updates `cycle.toon` with fresh data
+
+## Output
+
+After running, report:
+- Number of tasks synced
+- Current cycle name
+- Any status updates pushed to Linear (if --update used)

package/commands/ttt:work-on.md

@@ -0,0 +1,79 @@
+---
+name: ttt:work-on
+description: Start working on a Linear task
+arguments:
+  - name: issue-id
+    description: Issue ID (e.g., MP-624), 'next' for auto-select, or omit for interactive
+    required: false
+---
+
+# TTT Work-On Command
+
+Start working on a task from the current cycle.
+
+## Usage
+
+### Interactive Selection
+```bash
+ttt work-on
+```
+
+### Specific Issue
+If `issue-id` is provided (e.g., MP-624):
+```bash
+ttt work-on {{ issue-id }}
+```
+
+### Auto-Select Highest Priority
+If `issue-id` is "next":
+```bash
+ttt work-on next
+```
+
+## What This Does
+
+1. Marks the task as `in-progress` locally
+2. Updates Linear status to "In Progress" (if status_source is remote)
+3. Displays full task details including:
+   - Title and description
+   - Priority and labels
+   - Attachments and comments
+   - Branch name for checkout
+
+## After Running
+
+1. Read the task description and requirements
+2. Check out the suggested branch: `git checkout -b <branch-name>`
+3. **Run project validation** (see below)
+4. Begin implementation
+
+## Project Validation
+
+Before starting work, check for validation tools:
+
+### 1. Check for Existing Validation
+
+Look for:
+- **Commands**: `/validate`, `/check`, `/lint` in available commands
+- **Skills**: `validate`, `check`, `verify` in available skills
+- **Scripts**: `lint`, `type-check`, `test` in `package.json` or `Makefile`
+
+### 2. If No Validation Found
+
+Ask user:
+```
+No validation command or skill found for this project.
+Would you like to create one? (y/n)
+```
+
+If yes, run:
+```
+/ttt:write-validate
+```
+
+### 3. Run Validation
+
+Once validation is available:
+- Use `/validate` command if exists
+- Or use validation skill if available
+- Or run detected scripts directly