mspec-proposal
proposal step of mspec workflow — clarify intent and write proposal.md
Файлы1
Открыть в GitHubSKILL.md.claude/skills/mspec-proposal/SKILL.md
GitHub<!-- @mspec-delta 2026-05-15-063805-fix-command-name-consistency/specs/claude-integration/spec.md -->
<!-- Requirements implemented: FR-017 -->
<!-- Change: fix-command-name-consistency -->
<!-- @mspec-delta 2026-05-15-040857-step-checkbox-update/specs/claude-integration/spec.md -->
<!-- Requirements implemented: FR-015 -->
<!-- Change: step-checkbox-update -->
<!-- @mspec-delta 2026-05-16-170347-lightweight-change-mode/specs/claude-integration/spec.md -->
<!-- Requirements implemented: FR-019 -->
<!-- Change: lightweight-change-mode -->
<!-- @mspec-delta 2026-05-25-051411-security-as-default/specs/mspec-proposal/spec.md -->
<!-- Requirements implemented: FR-001, FR-002 -->
<!-- Change: security-as-default -->
Procedure
- モードスキップ判定:
readme.mdの> Mode:フィールドを読む。ワークフローのmodes.<mode>.skipにこのステップ(proposal)が含まれる場合は成果物を生成せず終了する(mspec continueがスキップ済みとして扱う)。 - Run
mspec status --change <change-dir> --jsonfirst. - Read
readme.md. - Run
mspec questions --phase proposal --jsonto load the question bank.<!-- @mspec-delta 2026-05-27-070619-dynamic-security-questions/specs/mspec-proposal/spec.md --> <!-- Requirements implemented: FR-001, FR-002, FR-003, FR-004 --> <!-- Change: dynamic-security-questions --> - Ask 3–5 clarifying questions via AskUserQuestion (1 per call, multi-select preferred), covering functional scope, NFR, completion criteria, terminology.
4a. セキュリティ分析フェーズ: Agent tool を使用して
mspec-security-analyzerサブエージェントをインライン起動する。分析スコープはspecs/とchanges/<current>/readme.mdおよびchanges/<current>/proposal.md(読み取り専用)。サブエージェントは変更コンテキストを分析し、3〜5 問の変更固有セキュリティ質問を返す(各質問: テキスト・選択肢 2〜4 個・multi_select フラグ)。 4b. サブエージェントが返した 3〜5 問の動的セキュリティ質問を AskUserQuestion で 1 問 1 答(1 per call)で提示する。固定のセキュリティ質問 ID は使用しない。回答内容を## Open Questionsに記録すること(エージェント権限付与など重要事項がある場合)。 - Write
proposal.mdfrom the artifact template (Why / Goals / Non-Goals / Capabilities / Open Questions).## Capabilities (touched)の各 capability 名は kebab-case で記述する。後続の delta ステップでこのリストを元にmspec delta initが実行され、各 Requirement は EARS 形式(SHALL / MUST / SHOULD)+ Scenario(GIVEN/WHEN/THEN)で記述される。## Decisionsテーブルに動的生成セキュリティ質問と回答のペアを記録すること。
- Fill the
## Constitution Checktable (Phase 0 column only; Phase 1 stays—). 6a.readme.mdの## Artifacts節の- [ ] proposal.mdを- [x] proposal.mdに更新する。 - Run
mspec validate --change <change-dir>. validate が失敗した場合は- [x] proposal.mdを- [ ] proposal.mdにロールバックする。 block: true— stop and ask the user to run/mspec:continue.
Verification (C2)
mspec validate --change <change>— アーティファクト整合性チェックmspec anchor check --change <change>— アンカー解決確認mspec validate --change <change> --strict— Constitution Check確認
Learning (C3)
このスキルの実行で発生した学習候補を記録する:
<!-- LEARNING: <パターン説明> | source: <FR-ID> | confidence: low|medium|high -->
mspec learn コマンドが archive 済み changes からこれらを収集してpost-condition候補をproposeする。