claude-code-workflow 7.2.13 → 7.2.15

package/.codex/skills/session-sync/SKILL.md

@@ -1,212 +1,222 @@
----
-name: session-sync
-description: Quick-sync session work to specs/*.md and project-tech.json
-argument-hint: "[-y|--yes] [\"what was done\"]"
-allowed-tools: AskUserQuestion, Read, Write, Edit, Bash, Glob, Grep
----
-
-# Session Sync
-
-One-shot update `specs/*.md` + `project-tech.json` from current session context.
-
-**Design**: Scan context -> extract -> write. No interactive wizards.
-
-## Usage
-
-```bash
-$session-sync                        # Sync with preview + confirmation
-$session-sync -y                     # Auto-sync, skip confirmation
-$session-sync "Added JWT auth flow"  # Sync with explicit summary
-$session-sync -y "Fixed N+1 query"   # Auto-sync with summary
-```
-
-## Process
-
-```
-Step 1: Gather Context
-   |- git diff --stat HEAD~3..HEAD (recent changes)
-   |- Active session folder (.workflow/.lite-plan/*) if exists
-   +- User summary ($ARGUMENTS or auto-generate from git log)
-
-Step 2: Extract Updates
-   |- Guidelines: conventions / constraints / learnings
-   +- Tech: development_index entry
-
-Step 3: Preview & Confirm (skip if --yes)
-
-Step 4: Write both files
-
-Step 5: One-line confirmation
-```
-
-## Implementation
-
-### Step 1: Gather Context
-
-```javascript
-const AUTO_YES = "$ARGUMENTS".includes('--yes') || "$ARGUMENTS".includes('-y')
-const userSummary = "$ARGUMENTS".replace(/--yes|-y/g, '').trim()
-
-// Recent changes
-const gitStat = Bash('git diff --stat HEAD~3..HEAD 2>/dev/null || git diff --stat HEAD 2>/dev/null')
-const gitLog = Bash('git log --oneline -5')
-
-// Active session (optional)
-const sessionFolders = Glob('.workflow/.lite-plan/*/plan.json')
-let sessionContext = null
-if (sessionFolders.length > 0) {
-  const latest = sessionFolders[sessionFolders.length - 1]
-  sessionContext = JSON.parse(Read(latest))
-}
-
-// Build summary
-const summary = userSummary
-  || sessionContext?.summary
-  || gitLog.split('\n')[0].replace(/^[a-f0-9]+ /, '')
-```
-
-### Step 2: Extract Updates
-
-Analyze context and produce two update payloads. Use LLM reasoning (current agent) -- no CLI calls.
-
-```javascript
-// -- Guidelines extraction --
-// Scan git diff + session for:
-//   - New patterns adopted -> convention
-//   - Restrictions discovered -> constraint
-//   - Surprises / gotchas -> learning
-//
-// Output: array of { type, category, text }
-// RULE: Only extract genuinely reusable insights. Skip trivial/obvious items.
-// RULE: Deduplicate against existing guidelines before adding.
-
-// Load existing specs via ccw spec load
-const existingSpecs = Bash('ccw spec load --dimension specs 2>/dev/null || echo ""')
-const guidelineUpdates = [] // populated by agent analysis
-
-// -- Tech extraction --
-// Build one development_index entry from session work
-
-function detectCategory(text) {
-  text = text.toLowerCase()
-  if (/\b(fix|bug|error|crash)\b/.test(text)) return 'bugfix'
-  if (/\b(refactor|cleanup|reorganize)\b/.test(text)) return 'refactor'
-  if (/\b(doc|readme|comment)\b/.test(text)) return 'docs'
-  if (/\b(add|new|create|implement)\b/.test(text)) return 'feature'
-  return 'enhancement'
-}
-
-function detectSubFeature(gitStat) {
-  // Most-changed directory from git diff --stat
-  const dirs = gitStat.match(/\S+\//g) || []
-  const counts = {}
-  dirs.forEach(d => {
-    const seg = d.split('/').filter(Boolean).slice(-2, -1)[0] || 'general'
-    counts[seg] = (counts[seg] || 0) + 1
-  })
-  return Object.entries(counts).sort((a, b) => b[1] - a[1])[0]?.[0] || 'general'
-}
-
-const techEntry = {
-  title: summary.slice(0, 60),
-  sub_feature: detectSubFeature(gitStat),
-  date: new Date().toISOString().split('T')[0],
-  description: summary.slice(0, 100),
-  status: 'completed',
-  session_id: sessionContext ? sessionFolders[sessionFolders.length - 1].match(/lite-plan\/([^/]+)/)?.[1] : null
-}
-```
-
-### Step 3: Preview & Confirm
-
-```javascript
-// Show preview
-console.log(`
--- Sync Preview --
-
-Guidelines (${guidelineUpdates.length} items):
-${guidelineUpdates.map(g => `  [${g.type}/${g.category}] ${g.text}`).join('\n') || '  (none)'}
-
-Tech [${detectCategory(summary)}]:
-  ${techEntry.title}
-
-Target files:
-  .ccw/specs/*.md
-  .workflow/project-tech.json
-`)
-
-if (!AUTO_YES) {
-  const approved = CONFIRM("Apply these updates? (modify/skip items if needed)")  // BLOCKS (wait for user response)
-  if (!approved) {
-    console.log('Sync cancelled.')
-    return
-  }
-}
-```
-
-### Step 4: Write
-
-```javascript
-// -- Update specs/*.md --
-// Uses .ccw/specs/ directory (same as frontend/backend spec-index-builder)
-if (guidelineUpdates.length > 0) {
-  // Map guideline types to spec files
-  const specFileMap = {
-    convention: '.ccw/specs/coding-conventions.md',
-    constraint: '.ccw/specs/architecture-constraints.md',
-    learning: '.ccw/specs/coding-conventions.md' // learnings appended to conventions
-  }
-
-  for (const g of guidelineUpdates) {
-    const targetFile = specFileMap[g.type]
-    const existing = Read(targetFile)
-    const ruleText = g.type === 'learning'
-      ? `- [${g.category}] ${g.text} (learned: ${new Date().toISOString().split('T')[0]})`
-      : `- [${g.category}] ${g.text}`
-
-    // Deduplicate: skip if text already in file
-    if (!existing.includes(g.text)) {
-      const newContent = existing.trimEnd() + '\n' + ruleText + '\n'
-      Write(targetFile, newContent)
-    }
-  }
-
-  // Rebuild spec index after writing
-  Bash('ccw spec rebuild')
-}
-
-// -- Update project-tech.json --
-const techPath = '.workflow/project-tech.json'
-const tech = JSON.parse(Read(techPath))
-
-if (!tech.development_index) {
-  tech.development_index = { feature: [], enhancement: [], bugfix: [], refactor: [], docs: [] }
-}
-
-const category = detectCategory(summary)
-tech.development_index[category].push(techEntry)
-tech._metadata.last_updated = new Date().toISOString()
-
-Write(techPath, JSON.stringify(tech, null, 2))
-```
-
-### Step 5: Confirm
-
-```
-Synced: ${guidelineUpdates.length} guidelines + 1 tech entry [${category}]
-```
-
-## Error Handling
-
-| Error | Resolution |
-|-------|------------|
-| File missing | Create scaffold (same as $spec-setup Step 4) |
-| No git history | Use user summary or session context only |
-| No meaningful updates | Skip guidelines, still add tech entry |
-| Duplicate entry | Skip silently (dedup check in Step 4) |
-
-## Related Commands
-
-- `$spec-setup` - Initialize project with specs scaffold
-- `$spec-add` - Interactive wizard to create individual specs with scope selection
-- `$workflow-plan` - Start planning with initialized project context
+---
+name: session-sync
+description: Quick-sync session work to specs/*.md and project-tech.json
+argument-hint: "[-y|--yes] [\"what was done\"]"
+allowed-tools: request_user_input, Read, Write, Edit, Bash, Glob, Grep
+---
+
+# Session Sync
+
+One-shot update `specs/*.md` + `project-tech.json` from current session context.
+
+**Design**: Scan context -> extract -> write. No interactive wizards.
+
+## Usage
+
+```bash
+$session-sync                        # Sync with preview + confirmation
+$session-sync -y                     # Auto-sync, skip confirmation
+$session-sync "Added JWT auth flow"  # Sync with explicit summary
+$session-sync -y "Fixed N+1 query"   # Auto-sync with summary
+```
+
+## Process
+
+```
+Step 1: Gather Context
+   |- git diff --stat HEAD~3..HEAD (recent changes)
+   |- Active session folder (.workflow/.lite-plan/*) if exists
+   +- User summary ($ARGUMENTS or auto-generate from git log)
+
+Step 2: Extract Updates
+   |- Guidelines: conventions / constraints / learnings
+   +- Tech: development_index entry
+
+Step 3: Preview & Confirm (skip if --yes)
+
+Step 4: Write both files
+
+Step 5: One-line confirmation
+```
+
+## Implementation
+
+### Step 1: Gather Context
+
+```javascript
+const AUTO_YES = "$ARGUMENTS".includes('--yes') || "$ARGUMENTS".includes('-y')
+const userSummary = "$ARGUMENTS".replace(/--yes|-y/g, '').trim()
+
+// Recent changes
+const gitStat = Bash('git diff --stat HEAD~3..HEAD 2>/dev/null || git diff --stat HEAD 2>/dev/null')
+const gitLog = Bash('git log --oneline -5')
+
+// Active session (optional)
+const sessionFolders = Glob('.workflow/.lite-plan/*/plan.json')
+let sessionContext = null
+if (sessionFolders.length > 0) {
+  const latest = sessionFolders[sessionFolders.length - 1]
+  sessionContext = JSON.parse(Read(latest))
+}
+
+// Build summary
+const summary = userSummary
+  || sessionContext?.summary
+  || gitLog.split('\n')[0].replace(/^[a-f0-9]+ /, '')
+```
+
+### Step 2: Extract Updates
+
+Analyze context and produce two update payloads. Use LLM reasoning (current agent) -- no CLI calls.
+
+```javascript
+// -- Guidelines extraction --
+// Scan git diff + session for:
+//   - New patterns adopted -> convention
+//   - Restrictions discovered -> constraint
+//   - Surprises / gotchas -> learning
+//
+// Output: array of { type, category, text }
+// RULE: Only extract genuinely reusable insights. Skip trivial/obvious items.
+// RULE: Deduplicate against existing guidelines before adding.
+
+// Load existing specs via ccw spec load
+const existingSpecs = Bash('ccw spec load --dimension specs 2>/dev/null || echo ""')
+const guidelineUpdates = [] // populated by agent analysis
+
+// -- Tech extraction --
+// Build one development_index entry from session work
+
+function detectCategory(text) {
+  text = text.toLowerCase()
+  if (/\b(fix|bug|error|crash)\b/.test(text)) return 'bugfix'
+  if (/\b(refactor|cleanup|reorganize)\b/.test(text)) return 'refactor'
+  if (/\b(doc|readme|comment)\b/.test(text)) return 'docs'
+  if (/\b(add|new|create|implement)\b/.test(text)) return 'feature'
+  return 'enhancement'
+}
+
+function detectSubFeature(gitStat) {
+  // Most-changed directory from git diff --stat
+  const dirs = gitStat.match(/\S+\//g) || []
+  const counts = {}
+  dirs.forEach(d => {
+    const seg = d.split('/').filter(Boolean).slice(-2, -1)[0] || 'general'
+    counts[seg] = (counts[seg] || 0) + 1
+  })
+  return Object.entries(counts).sort((a, b) => b[1] - a[1])[0]?.[0] || 'general'
+}
+
+const techEntry = {
+  title: summary.slice(0, 60),
+  sub_feature: detectSubFeature(gitStat),
+  date: new Date().toISOString().split('T')[0],
+  description: summary.slice(0, 100),
+  status: 'completed',
+  session_id: sessionContext ? sessionFolders[sessionFolders.length - 1].match(/lite-plan\/([^/]+)/)?.[1] : null
+}
+```
+
+### Step 3: Preview & Confirm
+
+```javascript
+// Show preview
+console.log(`
+-- Sync Preview --
+
+Guidelines (${guidelineUpdates.length} items):
+${guidelineUpdates.map(g => `  [${g.type}/${g.category}] ${g.text}`).join('\n') || '  (none)'}
+
+Tech [${detectCategory(summary)}]:
+  ${techEntry.title}
+
+Target files:
+  .ccw/specs/*.md
+  .workflow/project-tech.json
+`)
+
+if (!AUTO_YES) {
+  const answer = request_user_input({
+    questions: [{
+      header: "确认同步",
+      id: "confirm_sync",
+      question: "Apply these updates? (modify/skip items if needed)",
+      options: [
+        { label: "Apply(Recommended)", description: "Apply all extracted updates to specs and project-tech.json" },
+        { label: "Cancel", description: "Abort sync, no changes made" }
+      ]
+    }]
+  })  // BLOCKS (wait for user response)
+  if (answer.answers.confirm_sync.answers[0] !== "Apply(Recommended)") {
+    console.log('Sync cancelled.')
+    return
+  }
+}
+```
+
+### Step 4: Write
+
+```javascript
+// -- Update specs/*.md --
+// Uses .ccw/specs/ directory (same as frontend/backend spec-index-builder)
+if (guidelineUpdates.length > 0) {
+  // Map guideline types to spec files
+  const specFileMap = {
+    convention: '.ccw/specs/coding-conventions.md',
+    constraint: '.ccw/specs/architecture-constraints.md',
+    learning: '.ccw/specs/coding-conventions.md' // learnings appended to conventions
+  }
+
+  for (const g of guidelineUpdates) {
+    const targetFile = specFileMap[g.type]
+    const existing = Read(targetFile)
+    const ruleText = g.type === 'learning'
+      ? `- [${g.category}] ${g.text} (learned: ${new Date().toISOString().split('T')[0]})`
+      : `- [${g.category}] ${g.text}`
+
+    // Deduplicate: skip if text already in file
+    if (!existing.includes(g.text)) {
+      const newContent = existing.trimEnd() + '\n' + ruleText + '\n'
+      Write(targetFile, newContent)
+    }
+  }
+
+  // Rebuild spec index after writing
+  Bash('ccw spec rebuild')
+}
+
+// -- Update project-tech.json --
+const techPath = '.workflow/project-tech.json'
+const tech = JSON.parse(Read(techPath))
+
+if (!tech.development_index) {
+  tech.development_index = { feature: [], enhancement: [], bugfix: [], refactor: [], docs: [] }
+}
+
+const category = detectCategory(summary)
+tech.development_index[category].push(techEntry)
+tech._metadata.last_updated = new Date().toISOString()
+
+Write(techPath, JSON.stringify(tech, null, 2))
+```
+
+### Step 5: Confirm
+
+```
+Synced: ${guidelineUpdates.length} guidelines + 1 tech entry [${category}]
+```
+
+## Error Handling
+
+| Error | Resolution |
+|-------|------------|
+| File missing | Create scaffold (same as $spec-setup Step 4) |
+| No git history | Use user summary or session context only |
+| No meaningful updates | Skip guidelines, still add tech entry |
+| Duplicate entry | Skip silently (dedup check in Step 4) |
+
+## Related Commands
+
+- `$spec-setup` - Initialize project with specs scaffold
+- `$spec-add` - Interactive wizard to create individual specs with scope selection
+- `$workflow-plan` - Start planning with initialized project context