feat: add category and scope to specs for enhanced filtering and organization

- Introduced SpecCategory and SpecScope types to categorize specs by workflow stage and scope (global/project). - Updated Spec interface to include category and scope properties. - Enhanced SpecCard component to display category and scope badges. - Implemented category and scope filtering in SpecsSettingsPage. - Updated localization files to support new category and scope labels. - Modified spec loading commands to utilize category instead of keywords. - Adjusted spec index builder to handle category and scope during spec parsing. - Updated seed documents to include category information.
2026-02-28 09:23:08 +08:00 · 2026-02-26 23:43:55 +08:00
parent 052e25dddb
commit dfa8e0d9f5
47 changed files with 619 additions and 179 deletions
--- a/.codex/skills/analyze-with-file/SKILL.md
+++ b/.codex/skills/analyze-with-file/SKILL.md
@@ -85,7 +85,7 @@ Step 1: Topic Understanding

 Step 2: Exploration (Inline, No Agents)
   ├─ Detect codebase → search relevant modules, patterns
-   │   ├─ Run `ccw spec load --keywords exploration` (if spec system available)
+   │   ├─ Run `ccw spec load --category exploration` (if spec system available)
   │   └─ Use Grep, Glob, Read, mcp__ace-tool__search_context
   ├─ Multi-perspective analysis (if selected, serial)
   │   ├─ Single: Comprehensive analysis
@@ -297,7 +297,7 @@ const hasCodebase = Bash(`

 if (hasCodebase !== 'none') {
  // 1. Read project metadata (if exists)
-  //    - Run `ccw spec load --keywords exploration` (load project specs)
+  //    - Run `ccw spec load --category exploration` (load project specs)
  //    - .workflow/specs/*.md (project conventions)

  // 2. Search codebase for relevant content
--- a/.codex/skills/brainstorm-with-file/SKILL.md
+++ b/.codex/skills/brainstorm-with-file/SKILL.md
@@ -282,7 +282,7 @@ Use built-in tools to understand the codebase structure before spawning perspect
 **Context Gathering Activities**:
 1. **Get project structure** - Execute `ccw tool exec get_modules_by_depth '{}'`
 2. **Search for related code** - Use Grep/Glob to find files matching topic keywords
-3. **Read project tech context** - Run `ccw spec load --keywords "exploration planning"` if spec system available
+3. **Read project tech context** - Run `ccw spec load --category "exploration planning"` if spec system available
 4. **Analyze patterns** - Identify common code patterns and architecture decisions

 **exploration-codebase.json Structure**:
@@ -358,7 +358,7 @@ const agentIds = perspectives.map(perspective => {

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
-2. Run: `ccw spec load --keywords "exploration planning"`
+2. Run: `ccw spec load --category "exploration planning"`
 3. Read project tech context from loaded specs

 ---
@@ -566,7 +566,7 @@ const deepDiveAgent = spawn_agent({
 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
 2. Read: ${sessionFolder}/perspectives.json (prior findings)
-3. Run: `ccw spec load --keywords "exploration planning"`
+3. Run: `ccw spec load --category "exploration planning"`

 ---

--- a/.codex/skills/collaborative-plan-with-file/SKILL.md
+++ b/.codex/skills/collaborative-plan-with-file/SKILL.md
@@ -194,7 +194,7 @@ Use built-in tools directly to understand the task scope and identify sub-domain
 **Analysis Activities**:
 1. **Search for references** — Find related documentation, README files, and architecture guides
   - Use: `mcp__ace-tool__search_context`, Grep, Glob, Read
-   - Run: `ccw spec load --keywords planning` (if spec system available)
+   - Run: `ccw spec load --category planning` (if spec system available)
 2. **Extract task keywords** — Identify key terms and concepts from the task description
 3. **Identify ambiguities** — List any unclear points or multiple possible interpretations
 4. **Clarify with user** — If ambiguities found, use AskUserQuestion for clarification
--- a/.codex/skills/issue-discover/SKILL.md
+++ b/.codex/skills/issue-discover/SKILL.md
@@ -231,7 +231,7 @@ const agentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/{agent-type}.md (MUST read first)
-2. Execute: ccw spec load --keywords exploration
+2. Execute: ccw spec load --category exploration

 ## TASK CONTEXT
 ${taskContext}
--- a/.codex/skills/req-plan-with-file/SKILL.md
+++ b/.codex/skills/req-plan-with-file/SKILL.md
@@ -268,7 +268,7 @@ const hasCodebase = bash(`
 // 2. Codebase Exploration (only when hasCodebase !== 'none')
 if (hasCodebase !== 'none') {
  // Read project metadata (if exists)
-  //   Run `ccw spec load --keywords planning`
+  //   Run `ccw spec load --category planning`

  // Search codebase for requirement-relevant context
  //   Use: mcp__ace-tool__search_context, Grep, Glob, Read
--- a/.codex/skills/review-cycle/SKILL.md
+++ b/.codex/skills/review-cycle/SKILL.md
@@ -303,7 +303,7 @@ const agentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/{agent-type}.md (MUST read first)
-2. Execute: ccw spec load --keywords "exploration execution"
+2. Execute: ccw spec load --category "exploration execution"

 ---

--- a/.codex/skills/review-cycle/phases/02-parallel-review.md
+++ b/.codex/skills/review-cycle/phases/02-parallel-review.md
@@ -94,7 +94,7 @@ dimensions.forEach(dimension => {
 3. Get target files: Read resolved_files from review-state.json
 4. Validate file access: bash(ls -la ${targetFiles.join(' ')})
 5. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-dimension-results-schema.json (get output schema reference)
-6. Execute: ccw spec load --keywords "exploration execution" (technology stack and constraints)
+6. Execute: ccw spec load --category "exploration execution" (technology stack and constraints)

 ---

@@ -216,7 +216,7 @@ dimensions.forEach(dimension => {
 4. Get changed files: bash(cd ${workflowDir} && git log --since="${sessionCreatedAt}" --name-only --pretty=format: | sort -u)
 5. Read review state: ${reviewStateJsonPath}
 6. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-dimension-results-schema.json (get output schema reference)
-7. Execute: ccw spec load --keywords "exploration execution" (technology stack and constraints)
+7. Execute: ccw spec load --category "exploration execution" (technology stack and constraints)

 ---

@@ -334,7 +334,7 @@ const deepDiveAgentId = spawn_agent({
 4. Identify related code: bash(grep -r "import.*${basename(file)}" ${projectDir}/src --include="*.ts")
 5. Read test files: bash(find ${projectDir}/tests -name "*${basename(file, '.ts')}*" -type f)
 6. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-deep-dive-results-schema.json (get output schema reference)
-7. Execute: ccw spec load --keywords "exploration execution" (technology stack and constraints for remediation)
+7. Execute: ccw spec load --category "exploration execution" (technology stack and constraints for remediation)

 ---

--- a/.codex/skills/review-cycle/phases/07-fix-parallel-planning.md
+++ b/.codex/skills/review-cycle/phases/07-fix-parallel-planning.md
@@ -105,7 +105,7 @@ const agentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/cli-planning-agent.md (MUST read first)
-2. Execute: ccw spec load --keywords planning
+2. Execute: ccw spec load --category planning

 ---

--- a/.codex/skills/review-cycle/phases/08-fix-execution.md
+++ b/.codex/skills/review-cycle/phases/08-fix-execution.md
@@ -60,7 +60,7 @@ const execAgentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/cli-execution-agent.md (MUST read first)
-2. Execute: ccw spec load --keywords execution
+2. Execute: ccw spec load --category execution

 ---

--- a/.codex/skills/team-planex/agents/executor.md
+++ b/.codex/skills/team-planex/agents/executor.md
@@ -38,7 +38,7 @@ completion report.
 ### Step 1: Load Context

 After reading role definition:
- Run: `ccw spec load --keywords execution`
+- Run: `ccw spec load --category execution`
 - Extract issue ID, solution file path, session dir from task message

 ### Step 2: Load Solution
--- a/.codex/skills/team-planex/agents/planner.md
+++ b/.codex/skills/team-planex/agents/planner.md
@@ -48,7 +48,7 @@ Outputs `ISSUE_READY:{issueId}` after each solution and waits for orchestrator t
 ### Step 1: Load Context

 After reading role definition, load project context:
- Run: `ccw spec load --keywords planning`
+- Run: `ccw spec load --category planning`
 - Extract session directory and artifacts directory from task message

 ### Step 2: Parse Input
@@ -81,7 +81,7 @@ spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/issue-plan-agent.md (MUST read first)
-2. Run: `ccw spec load --keywords planning`
+2. Run: `ccw spec load --category planning`

 ---

--- a/.codex/skills/team-planex/orchestrator.md
+++ b/.codex/skills/team-planex/orchestrator.md
@@ -85,7 +85,7 @@ const plannerAgent = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/planex-planner.md (MUST read first)
-2. Run: `ccw spec load --keywords "planning execution"`
+2. Run: `ccw spec load --category "planning execution"`

 ---

@@ -155,7 +155,7 @@ while (true) {

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/planex-executor.md (MUST read first)
-2. Run: `ccw spec load --keywords "planning execution"`
+2. Run: `ccw spec load --category "planning execution"`

 ---

--- a/.codex/skills/workflow-test-fix-cycle/SKILL.md
+++ b/.codex/skills/workflow-test-fix-cycle/SKILL.md
@@ -88,7 +88,7 @@ const agentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/{agent-type}.md (MUST read first)
-2. Run: `ccw spec load --keywords "planning execution"`
+2. Run: `ccw spec load --category "planning execution"`

 ## TASK CONTEXT
 ${taskContext}
--- a/.codex/skills/workflow-test-fix-cycle/phases/01-test-fix-gen.md
+++ b/.codex/skills/workflow-test-fix-cycle/phases/01-test-fix-gen.md
@@ -75,7 +75,7 @@ const contextAgentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/test-context-search-agent.md (MUST read first)
-2. Run: `ccw spec load --keywords planning`
+2. Run: `ccw spec load --category planning`

 ---

@@ -101,7 +101,7 @@ const contextAgentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/context-search-agent.md (MUST read first)
-2. Run: `ccw spec load --keywords planning`
+2. Run: `ccw spec load --category planning`

 ---

@@ -174,7 +174,7 @@ const analysisAgentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/cli-execution-agent.md (MUST read first)
-2. Run: `ccw spec load --keywords planning`
+2. Run: `ccw spec load --category planning`

 ---

@@ -242,7 +242,7 @@ const taskGenAgentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/action-planning-agent.md (MUST read first)
-2. Run: `ccw spec load --keywords planning`
+2. Run: `ccw spec load --category planning`

 ---

--- a/.codex/skills/workflow-test-fix-cycle/phases/02-test-cycle-execute.md
+++ b/.codex/skills/workflow-test-fix-cycle/phases/02-test-cycle-execute.md
@@ -90,7 +90,7 @@ const analysisAgentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/cli-planning-agent.md (MUST read first)
-2. Run: `ccw spec load --keywords planning`
+2. Run: `ccw spec load --category planning`

 ---

@@ -156,7 +156,7 @@ const fixAgentId = spawn_agent({

 ### MANDATORY FIRST STEPS (Agent Execute)
 1. **Read role definition**: ~/.codex/agents/test-fix-agent.md (MUST read first)
-2. Run: `ccw spec load --keywords execution`
+2. Run: `ccw spec load --category execution`

 ---