AgentSkillsCN

apd-status

当用户提出“展示 APD 状态”“查看项目进度”“我现在处于哪个阶段”“APDの状態を見せて”，或希望了解 APD 项目的当前状态时，应使用此技能。

SKILL.md
--- frontmatter
name: apd-status
description: >
  This skill should be used when the user asks to "show APD status",
  "check project progress", "what phase am I in", "APDの状態を見せて",
  or wants to know the current state of an APD project.
tools: ["Read", "Glob", "Grep", "Bash"]

APD Status — プロジェクト進行状況の表示

APDフレームワークのプロジェクト状態を成果物の有無から判定し、次のアクションを提案する。

手順

1. 成果物のスキャン

以下のディレクトリをGlobでスキャンし、存在するファイルを一覧化する:

  • •cycles/*.yaml — サイクル定義
  • •design/*.yaml — Design文書
  • •specs/*.yaml — Spec文書
  • •contract/*.yaml — Contract文書
  • •decisions/*.yaml — Decision Records
  • •src/ — 実装コード
  • •tests/ — テストコード

2. フェーズ状態の判定

成果物の有無から現在のフェーズを推定する:

状態判定基準
未開始cycles/ が空、design/ が空
Phase 0 進行中cycles/ にサイクルあり、design/ が空
Phase 0 完了design/product-design.yaml が存在
Phase 1 完了specs/ にファイルが存在
Phase 2 完了contract/ にファイルが存在
Phase 3 完了src/ と tests/ にファイルが存在し、テストがパス

3. アクティブサイクルの確認

cycles/ の最新ファイルを読み込み、トリガー種別と対象フェーズを確認する。

4. 状態レポートの出力

以下の形式でレポートを出力する:

code
## APD プロジェクト状態

### アクティブサイクル
- サイクルID: C-XXX
- トリガー: feature_addition
- タイトル: ...

### 成果物インベントリ
- Design: 1ファイル
- Specs: 5ファイル
- Contract: 1ファイル
- Decisions: 2ファイル

### 現在のフェーズ
Phase 2 完了 — Contract生成済み

### 次のアクション
→ `/apd-execute` を実行してPhase 3（実装）を開始してください

5. 次のアクション提案

フェーズ状態に応じて、適切なスキルを提案する:

  • •未開始 → /apd-cycle でサイクルを開始
  • •Phase 0 未完了 → /apd-design でDesign文書を作成
  • •Phase 0 完了 → /apd-spec full でSpecを生成
  • •Phase 1 完了 → /apd-contract でContractを生成
  • •Phase 2 完了 → /apd-execute で実装を開始
  • •Phase 3 完了 → サイクル完了