moai-adk 0.7.0__py3-none-any.whl → 0.8.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of moai-adk might be problematic. Click here for more details.
- moai_adk/core/issue_creator.py +309 -0
- moai_adk/core/project/phase_executor.py +1 -2
- moai_adk/core/template_engine.py +253 -0
- moai_adk/templates/.claude/agents/alfred/cc-manager.md +1 -1
- moai_adk/templates/.claude/agents/alfred/debug-helper.md +2 -2
- moai_adk/templates/.claude/agents/alfred/doc-syncer.md +2 -2
- moai_adk/templates/.claude/agents/alfred/git-manager.md +27 -4
- moai_adk/templates/.claude/agents/alfred/implementation-planner.md +2 -2
- moai_adk/templates/.claude/agents/alfred/project-manager.md +6 -6
- moai_adk/templates/.claude/agents/alfred/quality-gate.md +2 -2
- moai_adk/templates/.claude/agents/alfred/skill-factory.md +7 -7
- moai_adk/templates/.claude/agents/alfred/spec-builder.md +2 -2
- moai_adk/templates/.claude/agents/alfred/tag-agent.md +2 -2
- moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +2 -2
- moai_adk/templates/.claude/agents/alfred/trust-checker.md +2 -2
- moai_adk/templates/.claude/commands/alfred/0-project.md +9 -9
- moai_adk/templates/.claude/commands/alfred/1-plan.md +3 -3
- moai_adk/templates/.claude/commands/alfred/2-run.md +4 -4
- moai_adk/templates/.claude/commands/alfred/3-sync.md +5 -5
- moai_adk/templates/.claude/commands/alfred/9-feedback.md +149 -0
- moai_adk/templates/.claude/hooks/alfred/core/project.py +145 -13
- moai_adk/templates/.claude/hooks/alfred/handlers/session.py +90 -20
- moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md +1 -1
- moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md +1 -1
- moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md +1 -1
- moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml +5 -3
- moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md +20 -8
- moai_adk/templates/.github/workflows/moai-gitflow.yml +22 -16
- moai_adk/templates/.github/workflows/spec-issue-sync.yml +10 -6
- moai_adk/templates/.moai/config.json +12 -0
- moai_adk/templates/.moai/docs/quick-issue-creation-guide.md +219 -0
- moai_adk/templates/.moai/memory/issue-label-mapping.md +150 -0
- moai_adk/templates/CLAUDE.md +67 -1
- {moai_adk-0.7.0.dist-info → moai_adk-0.8.1.dist-info}/METADATA +123 -1
- {moai_adk-0.7.0.dist-info → moai_adk-0.8.1.dist-info}/RECORD +38 -34
- moai_adk/templates/.claude/hooks/alfred/test_hook_output.py +0 -175
- {moai_adk-0.7.0.dist-info → moai_adk-0.8.1.dist-info}/WHEEL +0 -0
- {moai_adk-0.7.0.dist-info → moai_adk-0.8.1.dist-info}/entry_points.txt +0 -0
- {moai_adk-0.7.0.dist-info → moai_adk-0.8.1.dist-info}/licenses/LICENSE +0 -0
|
@@ -6,7 +6,7 @@ model: sonnet
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# Implementation Planner - Implementation Strategist
|
|
9
|
-
> **Note**: Interactive prompts use `
|
|
9
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
10
10
|
|
|
11
11
|
You are an expert in analyzing SPECs to determine the optimal implementation strategy and library version.
|
|
12
12
|
|
|
@@ -47,7 +47,7 @@ Alfred translates SPEC requirements to English before invoking you via `Task()`.
|
|
|
47
47
|
- `Skill("moai-alfred-tag-scanning")`: Use only when an existing TAG chain needs to be recycled or augmented.
|
|
48
48
|
- Domain skills (`moai-domain-backend`/`frontend`/`web-api`/`mobile-app`, etc.): Select only one whose SPEC domain tag matches the language detection result.
|
|
49
49
|
- `Skill("moai-alfred-trust-validation")`: Called when TRUST compliance measures need to be defined in the planning stage.
|
|
50
|
-
- `
|
|
50
|
+
- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Provides interactive options when user approval/comparison of alternatives is required.
|
|
51
51
|
|
|
52
52
|
### Expert Traits
|
|
53
53
|
|
|
@@ -6,7 +6,7 @@ model: sonnet
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# Project Manager - Project Manager Agent
|
|
9
|
-
> **Note**: Interactive prompts use `
|
|
9
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
10
10
|
|
|
11
11
|
You are a Senior Project Manager Agent managing successful projects.
|
|
12
12
|
|
|
@@ -35,7 +35,7 @@ Alfred translates project setup requirements to English before invoking you.
|
|
|
35
35
|
- Domain skills: When `moai-alfred-language-detection` determines the project is server/frontend/web API, select only one corresponding skill (`Skill("moai-domain-backend")`, `Skill("moai-domain-frontend")`, `Skill("moai-domain-web-api")`).
|
|
36
36
|
- `Skill("moai-alfred-tag-scanning")`: Executed when switching to legacy mode or when reinforcing the existing TAG is deemed necessary.
|
|
37
37
|
- `Skill("moai-alfred-trust-validation")`: Only called when the user requests a “quality check” or when TRUST gate guidance is needed on the initial document draft.
|
|
38
|
-
- `
|
|
38
|
+
- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Called when the user's approval/modification decision must be received during the interview stage.
|
|
39
39
|
|
|
40
40
|
### Expert Traits
|
|
41
41
|
|
|
@@ -147,11 +147,11 @@ Alfred translates project setup requirements to English before invoking you.
|
|
|
147
147
|
|
|
148
148
|
### Interview Question Guide
|
|
149
149
|
|
|
150
|
-
> At all interview stages, you must
|
|
150
|
+
> At all interview stages, you must use `AskUserQuestion` tool (documented in moai-alfred-interactive-questions skill) to display the AskUserQuestion TUI menu.Option descriptions include a one-line summary + specific examples, provide an “Other/Enter Yourself” option, and ask for free comments.
|
|
151
151
|
|
|
152
152
|
#### 0. Common dictionary questions (common for new/legacy)
|
|
153
153
|
1. **Check language & framework**
|
|
154
|
-
- Check whether the automatic detection result is correct with `
|
|
154
|
+
- Check whether the automatic detection result is correct with `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`.
|
|
155
155
|
Options: **Confirmed / Requires modification / Multi-stack**.
|
|
156
156
|
- **Follow-up**: When selecting “Modification Required” or “Multiple Stacks”, an additional open-ended question (`Please list the languages/frameworks used in the project with a comma.`) is asked.
|
|
157
157
|
2. **Team size & collaboration style**
|
|
@@ -164,7 +164,7 @@ Options: **Confirmed / Requires modification / Multi-stack**.
|
|
|
164
164
|
#### 1. Product Discovery Question Set
|
|
165
165
|
##### (1) For new projects
|
|
166
166
|
- **Mission/Vision**
|
|
167
|
-
- `
|
|
167
|
+
- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` allows you to select one of **Platform/Operations Efficiency · New Business · Customer Experience · Regulations/Compliance · Direct Input**.
|
|
168
168
|
- When selecting “Direct Entry”, a one-line summary of the mission and why the mission is important are collected as additional questions.
|
|
169
169
|
- **Core Users/Personas**
|
|
170
170
|
- Multiple selection options: End Customer, Internal Operations, Development Team, Data Team, Management, Partner/Reseller.
|
|
@@ -233,7 +233,7 @@ Options: SPEC overhaul, TDD driven development, document/code synchronization, t
|
|
|
233
233
|
- Operations/Monitoring → OPERATIONS, INCIDENT RESPONSE section
|
|
234
234
|
|
|
235
235
|
#### 5. End of interview reminder
|
|
236
|
-
- After completing all questions, use `
|
|
236
|
+
- After completing all questions, use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` to check “Are there any additional notes you would like to leave?” (Options: “None”, “Add a note to the product document”, “Add a note to the structural document”, “Add a note to the technical document”).
|
|
237
237
|
- When a user selects a specific document, a “User Note” item is recorded in the **HISTORY** section of the document.
|
|
238
238
|
- Organize the summary of the interview results and the written document path (`.moai/project/{product,structure,tech}.md`) in a table format at the top of the final response.
|
|
239
239
|
|
|
@@ -6,7 +6,7 @@ model: haiku
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# Quality Gate - Quality Verification Gate
|
|
9
|
-
> **Note**: Interactive prompts use `
|
|
9
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
10
10
|
|
|
11
11
|
You are a quality gate that automatically verifies TRUST principles and project standards.
|
|
12
12
|
|
|
@@ -34,7 +34,7 @@ Alfred translates quality gate requirements to English before invoking you. Your
|
|
|
34
34
|
- `Skill("moai-essentials-review")`: Called when qualitative analysis of Readable/Unified items is required or when a code review checklist is required.
|
|
35
35
|
- `Skill("moai-essentials-perf")`: Used when a suspected performance regression occurs or when performance indicators are below target.
|
|
36
36
|
- `Skill("moai-foundation-trust")`: Loaded for reference when you need to check the latest update based on TRUST.
|
|
37
|
-
- `
|
|
37
|
+
- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Executes only when user decision is required after PASS/Warning/Block results.
|
|
38
38
|
|
|
39
39
|
### Expert Traits
|
|
40
40
|
|
|
@@ -86,7 +86,7 @@ Instead of assuming user intent, invoke the TUI survey Skill:
|
|
|
86
86
|
|
|
87
87
|
```python
|
|
88
88
|
# Delegate to moai-alfred-interactive-questions
|
|
89
|
-
|
|
89
|
+
AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
|
|
90
90
|
|
|
91
91
|
# Present structured survey
|
|
92
92
|
Survey: "What problem does this Skill solve?"
|
|
@@ -104,7 +104,7 @@ Continue using the TUI survey Skill to clarify:
|
|
|
104
104
|
|
|
105
105
|
```python
|
|
106
106
|
# Delegate to moai-alfred-interactive-questions for scope questions
|
|
107
|
-
|
|
107
|
+
AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
|
|
108
108
|
|
|
109
109
|
Questions:
|
|
110
110
|
1. Primary domain: "Which technology/framework?"
|
|
@@ -358,7 +358,7 @@ Always delegate to `moai-alfred-interactive-questions`:
|
|
|
358
358
|
|
|
359
359
|
```python
|
|
360
360
|
# Invoke TUI survey Skill
|
|
361
|
-
|
|
361
|
+
AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
|
|
362
362
|
|
|
363
363
|
Survey: "Which technology domain?"
|
|
364
364
|
Options:
|
|
@@ -379,7 +379,7 @@ Options:
|
|
|
379
379
|
|
|
380
380
|
```python
|
|
381
381
|
# Invoke TUI survey Skill
|
|
382
|
-
|
|
382
|
+
AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
|
|
383
383
|
|
|
384
384
|
Survey: "Which features are most important?" (Multiple selection)
|
|
385
385
|
Options:
|
|
@@ -397,7 +397,7 @@ Options:
|
|
|
397
397
|
|
|
398
398
|
```python
|
|
399
399
|
# Invoke TUI survey Skill
|
|
400
|
-
|
|
400
|
+
AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
|
|
401
401
|
|
|
402
402
|
Survey: "Target experience level?"
|
|
403
403
|
Options:
|
|
@@ -462,7 +462,7 @@ Tier 3 (Supporting, ~10% weight):
|
|
|
462
462
|
**Recovery**:
|
|
463
463
|
```python
|
|
464
464
|
# 1. Activate TUI Survey
|
|
465
|
-
|
|
465
|
+
AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
|
|
466
466
|
|
|
467
467
|
# 2. Ask structured questions: domain, problem, audience
|
|
468
468
|
# 3. Document clarified requirements
|
|
@@ -498,7 +498,7 @@ Skill("moai-alfred-interactive-questions")
|
|
|
498
498
|
**Recovery**:
|
|
499
499
|
```python
|
|
500
500
|
# 1. Use TUI Survey to identify priorities
|
|
501
|
-
|
|
501
|
+
AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
|
|
502
502
|
|
|
503
503
|
# 2. Suggest splitting into multiple Skills
|
|
504
504
|
# 3. Create foundational Skill first
|
|
@@ -8,7 +8,7 @@ model: sonnet
|
|
|
8
8
|
**Priority:** This guideline is **subordinate to the command guideline (`/alfred:1-plan`). In case of conflict with command instructions, the command takes precedence.
|
|
9
9
|
|
|
10
10
|
# SPEC Builder - SPEC Creation Expert
|
|
11
|
-
> **Note**: Interactive prompts use `
|
|
11
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
12
12
|
|
|
13
13
|
You are a SPEC expert agent responsible for SPEC document creation and intelligent verification.
|
|
14
14
|
|
|
@@ -48,7 +48,7 @@ Alfred translates user requests to English before invoking you via `Task()`. Thi
|
|
|
48
48
|
- `Skill("moai-alfred-spec-metadata-validation")`: Called when checking ID/version/status or updating inherited SPEC.
|
|
49
49
|
- `Skill("moai-alfred-tag-scanning")`: Used only when traceability must be secured by referencing the existing TAG chain.
|
|
50
50
|
- `Skill("moai-foundation-trust")` + `Skill("moai-alfred-trust-validation")`: Sequentially called when preemptive verification is required before user request or quality gate.
|
|
51
|
-
- `
|
|
51
|
+
- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Run when user approval/modification options need to be collected.
|
|
52
52
|
|
|
53
53
|
### Expert Traits
|
|
54
54
|
|
|
@@ -6,7 +6,7 @@ model: haiku
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# TAG System Agent - sole TAG management authority
|
|
9
|
-
> **Note**: Interactive prompts use `
|
|
9
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
10
10
|
|
|
11
11
|
You are a professional agent responsible for all TAG operations in MoAI-ADK.
|
|
12
12
|
|
|
@@ -33,7 +33,7 @@ Alfred translates TAG verification requests to English before invoking you. Your
|
|
|
33
33
|
**Conditional Skill Logic**
|
|
34
34
|
- `Skill("moai-alfred-trust-validation")`: Used only to check whether the TAG chain meets TRUST-Traceable criteria.
|
|
35
35
|
- `Skill("moai-foundation-specs")`: Loaded when the SPEC document and TAG connection status need to be verified.
|
|
36
|
-
- `
|
|
36
|
+
- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Executed when TAG conflict/deletion must be confirmed with user approval.
|
|
37
37
|
|
|
38
38
|
### Expert Traits
|
|
39
39
|
|
|
@@ -6,7 +6,7 @@ model: sonnet
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# TDD Implementer - TDD implementation expert
|
|
9
|
-
> **Note**: Interactive prompts use `
|
|
9
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
10
10
|
|
|
11
11
|
You are a TDD expert who strictly adheres to the RED-GREEN-REFACTOR cycle and keeps track of the TAG chain.
|
|
12
12
|
|
|
@@ -46,7 +46,7 @@ Alfred translates SPEC references and implementation requirements to English bef
|
|
|
46
46
|
- `Skill("moai-essentials-refactor")`: Called only when entering the REFACTOR stage.
|
|
47
47
|
- `Skill("moai-alfred-git-workflow")`: Loads commits/checkpoints for each TAG at the time of preparation.
|
|
48
48
|
- `Skill("moai-essentials-perf")`: Applied only when performance requirements are specified in SPEC.
|
|
49
|
-
- `
|
|
49
|
+
- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Collects user decisions when choosing an implementation alternative or refactoring strategy is needed.
|
|
50
50
|
|
|
51
51
|
### Expert Traits
|
|
52
52
|
|
|
@@ -6,7 +6,7 @@ model: haiku
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# Trust Checker - Integrated Quality Verification Expert
|
|
9
|
-
> **Note**: Interactive prompts use `
|
|
9
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
10
10
|
|
|
11
11
|
You are the agent responsible for the TRUST 5 principles, code standards, and security checks.
|
|
12
12
|
|
|
@@ -35,7 +35,7 @@ Alfred translates quality verification requests to English before invoking you.
|
|
|
35
35
|
- `Skill("moai-essentials-review")`: Called when qualitative verification of Readable/Unified indicators is required.
|
|
36
36
|
- `Skill("moai-essentials-perf")`: Used when performance analysis is required in Level 3 scan.
|
|
37
37
|
- `Skill("moai-essentials-debug")`: Called when a critical result occurs and root cause analysis is required.
|
|
38
|
-
- `
|
|
38
|
+
- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Run when it is necessary to coordinate with the user whether to re-verify/suspend.
|
|
39
39
|
|
|
40
40
|
### Expert Traits
|
|
41
41
|
|
|
@@ -20,7 +20,7 @@ allowed-tools:
|
|
|
20
20
|
---
|
|
21
21
|
|
|
22
22
|
# 📋 MoAI-ADK Step 0: Initialize/Update Universal Language Support Project Documentation
|
|
23
|
-
> **Note**: Interactive prompts use `
|
|
23
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
24
24
|
|
|
25
25
|
## 🎯 Command Purpose
|
|
26
26
|
|
|
@@ -110,7 +110,7 @@ MoAI-ADK의 SuperAgent로서 당신의 프로젝트를 함께 만들어갈 준
|
|
|
110
110
|
|
|
111
111
|
### 0.1 언어 선택
|
|
112
112
|
|
|
113
|
-
Alfred가 `
|
|
113
|
+
Alfred가 `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` 를 사용하여 **첫 번째 상호작용**으로 언어 선택 메뉴를 표시합니다:
|
|
114
114
|
|
|
115
115
|
**Question**:
|
|
116
116
|
```
|
|
@@ -144,7 +144,7 @@ This language preference is:
|
|
|
144
144
|
|
|
145
145
|
### 0.2.5 사용자 닉네임 선택
|
|
146
146
|
|
|
147
|
-
언어 선택 완료 후, Alfred가 `
|
|
147
|
+
언어 선택 완료 후, Alfred가 `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` 를 사용하여 사용자 닉네임을 요청합니다:
|
|
148
148
|
|
|
149
149
|
**질문**:
|
|
150
150
|
```
|
|
@@ -228,7 +228,7 @@ grep "optimized" .moai/config.json
|
|
|
228
228
|
- `optimized: false` in `config.json` (immediately after reinitialization)
|
|
229
229
|
|
|
230
230
|
**Select user if backup exists**
|
|
231
|
-
Call `
|
|
231
|
+
Call `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` to display a TUI with the following options:
|
|
232
232
|
- **Merge**: Merge backup contents and latest template (recommended)
|
|
233
233
|
- **New**: Ignore the backup and start a new interview
|
|
234
234
|
- **Skip**: Keep current file (terminate task)
|
|
@@ -443,7 +443,7 @@ Set optimization flags after the merge is complete:
|
|
|
443
443
|
|
|
444
444
|
### 1.5 Wait for user approval (moai-alfred-interactive-questions) (when user selects "New")
|
|
445
445
|
|
|
446
|
-
After Alfred receives the project-manager's interview plan report,
|
|
446
|
+
After Alfred receives the project-manager's interview plan report, uses `AskUserQuestion` tool (documented in moai-alfred-interactive-questions skill) and asks whether Phase 2 is approved.
|
|
447
447
|
- **Proceed**: Interview conducted according to approved plan
|
|
448
448
|
- **Modify**: Re-establish the plan (re-execute Phase 1)
|
|
449
449
|
- **Stop**: Stop initialization
|
|
@@ -543,7 +543,7 @@ After the project-manager has finished creating the document, **Alfred can optio
|
|
|
543
543
|
- When selecting language/framework
|
|
544
544
|
- When changing important settings
|
|
545
545
|
|
|
546
|
-
**Example** (inside project-manager): Ask whether to "overwrite file" with `
|
|
546
|
+
**Example** (inside project-manager): Ask whether to "overwrite file" with `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`,
|
|
547
547
|
- Allows you to choose between **Overwrite** / **Merge** / **Skip**.
|
|
548
548
|
|
|
549
549
|
**Nested pattern**:
|
|
@@ -806,7 +806,7 @@ Alfred only calls the trust-checker agent to perform project initial structural
|
|
|
806
806
|
### 2.6: Agent & Skill Tailoring (Project Optimization)
|
|
807
807
|
|
|
808
808
|
Based on the results of the interviews and initial analysis, we recommend and activate sub-agents and skills that should be immediately utilized in the project.
|
|
809
|
-
Before actual application, user confirmation is received with `
|
|
809
|
+
Before actual application, user confirmation is received with `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`, and selected items are recorded in `CLAUDE.md` and `.moai/config.json`.
|
|
810
810
|
|
|
811
811
|
#### 2.6.0 Create cc-manager briefing
|
|
812
812
|
|
|
@@ -847,7 +847,7 @@ If multiple conditions are met, the candidates are merged without duplicates and
|
|
|
847
847
|
|
|
848
848
|
#### 2.6.2 User confirmation flow
|
|
849
849
|
|
|
850
|
-
`
|
|
850
|
+
`AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` asks “whether to enable recommended items.”
|
|
851
851
|
- Provides three options: **Install all** / **Install selectively** / **Do not install**.
|
|
852
852
|
Selecting “Selective Install” presents the list of candidates again as multiple choices, allowing the user to select only the items they need.
|
|
853
853
|
|
|
@@ -992,7 +992,7 @@ This subcommand is executed under the following conditions:
|
|
|
992
992
|
```
|
|
993
993
|
|
|
994
994
|
4. **Waiting for user approval**
|
|
995
|
-
`
|
|
995
|
+
`AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` asks “Do you want to proceed with template optimization?” and provides the following options.
|
|
996
996
|
- **Proceed** → Phase 2 execution
|
|
997
997
|
- **Preview** → Display change details and recheck
|
|
998
998
|
- **Skip** → keep optimized=false
|
|
@@ -21,7 +21,7 @@ allowed-tools:
|
|
|
21
21
|
---
|
|
22
22
|
|
|
23
23
|
# 🏗️ MoAI-ADK Step 1: Establish a plan (Plan) - Always make a plan first and then proceed.
|
|
24
|
-
> **Note**: Interactive prompts use `
|
|
24
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
25
25
|
|
|
26
26
|
## 🎯 Command Purpose
|
|
27
27
|
|
|
@@ -186,7 +186,7 @@ User input: $ARGUMENTS
|
|
|
186
186
|
|
|
187
187
|
### User verification steps
|
|
188
188
|
|
|
189
|
-
After reviewing your implementation plan, Alfred invokes `
|
|
189
|
+
After reviewing your implementation plan, Alfred invokes `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` to present the following options:
|
|
190
190
|
- **"Go"** or **"Start"**: Start writing the plan as planned
|
|
191
191
|
- **"Modify [Content]"**: Request modifications to the plan
|
|
192
192
|
- **"Stop"**: Stop writing the plan
|
|
@@ -195,7 +195,7 @@ After reviewing your implementation plan, Alfred invokes `Skill("moai-alfred-int
|
|
|
195
195
|
|
|
196
196
|
## 🚀 STEP 2: Create plan document (after user approval)
|
|
197
197
|
|
|
198
|
-
After user approval (collected via `
|
|
198
|
+
After user approval (collected via `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`), call the spec-builder and git-manager agents using the **Task tool**.
|
|
199
199
|
|
|
200
200
|
### ⚙️ How to call an agent
|
|
201
201
|
|
|
@@ -24,7 +24,7 @@ allowed-tools:
|
|
|
24
24
|
---
|
|
25
25
|
|
|
26
26
|
# ⚒️ MoAI-ADK Phase 2: Run the plan - Flexible implementation strategy
|
|
27
|
-
> **Note**: Interactive prompts use `
|
|
27
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
28
28
|
|
|
29
29
|
## 🎯 Command Purpose
|
|
30
30
|
|
|
@@ -137,7 +137,7 @@ Task tool call example:
|
|
|
137
137
|
3. TAG chain design
|
|
138
138
|
4. Step-by-step execution plan
|
|
139
139
|
5. Risks and response plans
|
|
140
|
-
6. Create action plan and use `
|
|
140
|
+
6. Create action plan and use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` to confirm the next action with the user
|
|
141
141
|
(Optional) Explore results: $EXPLORE_RESULTS"
|
|
142
142
|
```
|
|
143
143
|
|
|
@@ -181,7 +181,7 @@ After reviewing the action plan, select one of the following:
|
|
|
181
181
|
|
|
182
182
|
## 🚀 STEP 2: Execute task (after user approval)
|
|
183
183
|
|
|
184
|
-
After user approval (gathered through `
|
|
184
|
+
After user approval (gathered through `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`), **call the tdd-implementer agent using the Task tool**.
|
|
185
185
|
|
|
186
186
|
### ⚙️ How to call an agent
|
|
187
187
|
|
|
@@ -266,7 +266,7 @@ The `implementation-planner` agent does the following:
|
|
|
266
266
|
2. **Library selection**: Check the latest stable version and verify compatibility through WebFetch
|
|
267
267
|
3. **TAG chain design**: Determine TAG order and dependency
|
|
268
268
|
4. **Establishment of implementation strategy**: Step-by-step implementation plan and risk identification
|
|
269
|
-
5. **Create action plan**: Create a structured plan and, via `
|
|
269
|
+
5. **Create action plan**: Create a structured plan and, via `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`, collect user approval before proceeding
|
|
270
270
|
|
|
271
271
|
### Phase 2: Task execution phase (after approval)
|
|
272
272
|
|
|
@@ -22,14 +22,14 @@ allowed-tools:
|
|
|
22
22
|
---
|
|
23
23
|
|
|
24
24
|
# 📚 MoAI-ADK Step 3: Document Synchronization (+Optional PR Ready)
|
|
25
|
-
> **Note**: Interactive prompts use `
|
|
25
|
+
> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
|
|
26
26
|
|
|
27
27
|
## 🚀 START HERE
|
|
28
28
|
|
|
29
29
|
**CRITICAL**: Load the TUI Survey Skill FIRST before any user interaction:
|
|
30
30
|
|
|
31
31
|
```
|
|
32
|
-
|
|
32
|
+
AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
This Skill MUST be loaded at the very beginning to enable TUI menu rendering for AskUserQuestion calls throughout this workflow.
|
|
@@ -45,7 +45,7 @@ Synchronize code changes to Living Documents and verify @TAG system to ensure co
|
|
|
45
45
|
## 📋 Execution flow
|
|
46
46
|
|
|
47
47
|
**Phase 0: Skill Loading** (IMMEDIATE)
|
|
48
|
-
- Load `
|
|
48
|
+
- Load `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` at the very start
|
|
49
49
|
- This enables TUI menu rendering for all user interactions
|
|
50
50
|
|
|
51
51
|
**Phase 1: Analysis & Planning**
|
|
@@ -243,7 +243,7 @@ To skip pre-verification, use the `/alfred:3-sync --skip-pre-check` option.
|
|
|
243
243
|
|
|
244
244
|
### User verification steps
|
|
245
245
|
|
|
246
|
-
After reviewing your sync plan, `
|
|
246
|
+
After reviewing your sync plan, `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` presents the following options for user decision:
|
|
247
247
|
- **"Proceed"** or **"Start"**: Start synchronization as planned
|
|
248
248
|
- **"Modify [Contents]"**: Request modifications to your sync plan
|
|
249
249
|
- **"Abort"**: Abort the sync operation
|
|
@@ -252,7 +252,7 @@ After reviewing your sync plan, `Skill("moai-alfred-interactive-questions")` pre
|
|
|
252
252
|
|
|
253
253
|
## 🚀 STEP 2: Execute document synchronization (after user approval)
|
|
254
254
|
|
|
255
|
-
After user approval (collected via `
|
|
255
|
+
After user approval (collected via `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`), the doc-syncer agent performs **Living Document synchronization and @TAG updates**, and optionally executes PR Ready transitions only in team mode.
|
|
256
256
|
|
|
257
257
|
### Phase 2 Details: SPEC Completion Processing (Automatic)
|
|
258
258
|
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: alfred:9-feedback
|
|
3
|
+
description: "Interactive GitHub Issue creation - Step-by-step dialog to create issues without command arguments"
|
|
4
|
+
allowed-tools:
|
|
5
|
+
- Bash(gh:*)
|
|
6
|
+
- Task
|
|
7
|
+
- AskUserQuestion
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 🎯 MoAI-ADK Alfred 9-Feedback: Interactive GitHub Issue Creation
|
|
11
|
+
|
|
12
|
+
> **Purpose**: Create GitHub Issues through an interactive multi-step dialog. Simple command → guided questions → automatic issue creation.
|
|
13
|
+
|
|
14
|
+
## 📋 Command Purpose
|
|
15
|
+
|
|
16
|
+
Enable developers to instantly report bugs, request features, suggest improvements, and ask questions through conversational dialogs. No command arguments needed—just run `/alfred:9-feedback` and answer questions.
|
|
17
|
+
|
|
18
|
+
**Command Format**:
|
|
19
|
+
```bash
|
|
20
|
+
/alfred:9-feedback
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
That's it! Alfred guides you through the rest.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 🚀 Interactive Execution Flow
|
|
28
|
+
|
|
29
|
+
### Step 1: Start Command
|
|
30
|
+
```bash
|
|
31
|
+
/alfred:9-feedback
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Alfred responds and proceeds to Step 2.
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
### Step 2: Select Issue Type (AskUserQuestion)
|
|
39
|
+
|
|
40
|
+
**Question**: "What type of issue do you want to create?"
|
|
41
|
+
|
|
42
|
+
**Options**:
|
|
43
|
+
```
|
|
44
|
+
[ ] 🐛 Bug Report - Something isn't working
|
|
45
|
+
[ ] ✨ Feature Request - Suggest new functionality
|
|
46
|
+
[ ] ⚡ Improvement - Enhance existing features
|
|
47
|
+
[ ] ❓ Question/Discussion - Ask the team
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
**User Selection**: Selects one (e.g., 🐛 Bug Report)
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
### Step 3: Enter Issue Title (AskUserQuestion)
|
|
55
|
+
|
|
56
|
+
**Question**: "What is the issue title? (Be concise)"
|
|
57
|
+
|
|
58
|
+
**Example Input**:
|
|
59
|
+
```
|
|
60
|
+
Login button on homepage not responding to clicks
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
### Step 4: Enter Description (AskUserQuestion)
|
|
66
|
+
|
|
67
|
+
**Question**: "Provide a detailed description (optional—press Enter to skip)"
|
|
68
|
+
|
|
69
|
+
**Example Input**:
|
|
70
|
+
```
|
|
71
|
+
When I click the login button on the homepage, nothing happens.
|
|
72
|
+
Tested on Chrome 120.0 on macOS 14.2.
|
|
73
|
+
Expected: Login modal should appear
|
|
74
|
+
Actual: No response
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Or just press Enter to skip.
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
### Step 5: Select Priority (AskUserQuestion)
|
|
82
|
+
|
|
83
|
+
**Question**: "What's the priority level?"
|
|
84
|
+
|
|
85
|
+
**Options**:
|
|
86
|
+
```
|
|
87
|
+
[ ] 🔴 Critical - System down, data loss, security breach
|
|
88
|
+
[ ] 🟠 High - Major feature broken, significant impact
|
|
89
|
+
[✓] 🟡 Medium - Normal priority (default)
|
|
90
|
+
[ ] 🟢 Low - Minor issues, nice-to-have
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
**User Selection**: Selects priority (e.g., 🟠 High)
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
### Step 6: Create Issue (Automatic)
|
|
98
|
+
|
|
99
|
+
Alfred automatically:
|
|
100
|
+
1. Formats title with emoji: "🐛 [BUG] Login button not responding..."
|
|
101
|
+
2. Prepares body with user description + metadata
|
|
102
|
+
3. Assigns labels: bug, reported, priority-high
|
|
103
|
+
4. Executes: `gh issue create --title ... --body ... --label ...`
|
|
104
|
+
5. Parses issue number from response
|
|
105
|
+
|
|
106
|
+
**Success Output**:
|
|
107
|
+
```
|
|
108
|
+
✅ GitHub Issue #234 created successfully!
|
|
109
|
+
|
|
110
|
+
📋 Title: 🐛 [BUG] Login button not responding to clicks
|
|
111
|
+
🔴 Priority: High
|
|
112
|
+
🏷️ Labels: bug, reported, priority-high
|
|
113
|
+
🔗 URL: https://github.com/owner/repo/issues/234
|
|
114
|
+
|
|
115
|
+
💡 Next: Reference this issue in your commits or link to a SPEC document
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## ⚠️ Important Rules
|
|
121
|
+
|
|
122
|
+
### ✅ What to Do
|
|
123
|
+
|
|
124
|
+
- ✅ Ask all 4 questions in sequence (type → title → description → priority)
|
|
125
|
+
- ✅ Preserve exact user wording in title and description
|
|
126
|
+
- ✅ Use AskUserQuestion for all user inputs
|
|
127
|
+
- ✅ Allow skipping description (optional field)
|
|
128
|
+
- ✅ Show issue URL after creation
|
|
129
|
+
|
|
130
|
+
### ❌ What NOT to Do
|
|
131
|
+
|
|
132
|
+
- ❌ Accept command arguments (`/alfred:9-feedback --bug` is wrong—just use `/alfred:9-feedback`)
|
|
133
|
+
- ❌ Skip questions or change order
|
|
134
|
+
- ❌ Rephrase user's input
|
|
135
|
+
- ❌ Create issues without labels
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## 💡 Key Benefits
|
|
140
|
+
|
|
141
|
+
1. **🚀 No Arguments Needed**: Just `/alfred:9-feedback`
|
|
142
|
+
2. **💬 Conversational**: Intuitive step-by-step dialog
|
|
143
|
+
3. **🏷️ Auto-labeled**: Labels applied automatically
|
|
144
|
+
4. **🔗 Team Visible**: Issues immediately visible
|
|
145
|
+
5. **⏱️ Fast**: Create issues in 30 seconds
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
**Supported since**: MoAI-ADK v0.7.0+
|