docs(skills): add tq api reference and streamline CLI skill

[version-1]

tasq-cli skillのAPIリファレンス追加と全体整理

Summary

tasq-cli skillに、allowlist型raw API commandであるtq apiのオンデマンドリファレンスを追加します。あわせてskill全体を見直し、resourceをコマンド仕様、use caseを実行手順として整理し、重複記述を削減します。

主な変更点:

• tq apiの構文、allowlist、入力制約、raw出力、exit code、安全境界を追加
• SKILL.mdを小さな索引へ再構成し、必要なreferenceだけをロードできるよう整理
• resourceとuse case間の重複を削減し、local operationsやproject操作の仕様を集約
• migration rollback手順をCLIのstartup pre-flightと整合する内容へ修正

やったこと

• references/resources/api.mdを追加
• skill frontmatterのdescriptionへraw APIとlocal operationsを反映
• project、service、workflow、issue、comment、global behaviorの記述を簡潔化
• use caseから重複するcommand semanticsを削除し、仕様正本へのリンクへ置換
• project removalとraw API mutationに明示的な安全境界を追加
• fresh agentによるapi利用とproject bootstrap利用のforward testを実施

動作確認

• quick_validate.py .agents/skills/tasq-cli
• go test ./internal/cli/tq
• go run ./cmd/tq --help
• go run ./cmd/tq api --help
• 全Markdown相対リンク検査
• git diff --check

レビュー & 動作確認 チェックリスト

• API仕様 - allowlist、path/query/header/body制約がCLI実装と一致しているか
• 安全境界 - raw API mutationとproject removalが明示的な許可を要求しているか
• 参照責務 - resourceが仕様、use caseが手順として分離されているか
• Migration - forwardとrollbackの手順がservice startup pre-flightと整合しているか
• Progressive disclosure - SKILL.mdから必要最小限のreferenceを選択できるか

推奨テスト計画:

1. tasq-cli skillからapi.mdを選び、read/write requestの構文と注意点を回答させる
2. project bootstrap要求でproject、workflow、service referenceだけが選ばれることを確認する
3. migration rollback要求で、同じversionのserviceを即再起動しない案内になることを確認する

その他気になることや相談ごと

インストール済みtqが古い環境でも検証できるよう、CLI helpはリポジトリの現行ソースから実行しています。