@liangjie559567/ultrapower 5.6.5 → 5.6.7

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.
Files changed (1355) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/.mcp.json +2 -2
  4. package/LICENSE +21 -21
  5. package/README.es.md +81 -40
  6. package/README.ja.md +82 -41
  7. package/README.ko.md +81 -40
  8. package/README.md +98 -56
  9. package/README.pt.md +74 -39
  10. package/README.vi.md +74 -39
  11. package/README.zh.md +82 -41
  12. package/agents/AGENTS.md +24 -12
  13. package/agents/analyst.md +15 -7
  14. package/agents/architect.md +37 -18
  15. package/agents/axiom-context-manager.md +1 -1
  16. package/agents/axiom-critic.md +27 -13
  17. package/agents/axiom-domain-expert.md +25 -12
  18. package/agents/axiom-evolution-engine.md +2 -2
  19. package/agents/axiom-product-director.md +31 -15
  20. package/agents/axiom-sub-prd-writer.md +37 -16
  21. package/agents/axiom-tech-lead.md +35 -17
  22. package/agents/axiom-ux-director.md +27 -13
  23. package/agents/code-reviewer.md +5 -5
  24. package/agents/critic.md +17 -8
  25. package/agents/dependency-expert.md +2 -2
  26. package/agents/document-specialist.md +1 -1
  27. package/agents/information-architect.md +129 -60
  28. package/agents/planner.md +1 -1
  29. package/agents/product-analyst.md +137 -66
  30. package/agents/product-manager.md +180 -80
  31. package/agents/quality-strategist.md +123 -56
  32. package/agents/ux-researcher.md +151 -66
  33. package/agents/writer.md +10 -2
  34. package/bridge/AGENTS.md +26 -13
  35. package/bridge/codex-server.cjs +2 -2
  36. package/bridge/gemini-server.cjs +1 -1
  37. package/bridge/gyoshu_bridge.py +846 -846
  38. package/commands/AGENTS.md +16 -8
  39. package/commands/ccg-workflow.md +8 -4
  40. package/dist/features/token-tracker/index.js +1 -1
  41. package/dist/features/token-tracker/index.js.map +1 -1
  42. package/dist/hooks/persistent-mode/event-bus.d.ts +2 -2
  43. package/dist/hooks/persistent-mode/event-bus.d.ts.map +1 -1
  44. package/dist/hooks/persistent-mode/event-bus.js.map +1 -1
  45. package/dist/hooks/processors/agentExecutionComplete.d.ts +1 -1
  46. package/dist/hooks/processors/agentExecutionComplete.d.ts.map +1 -1
  47. package/dist/hooks/processors/agentExecutionComplete.js +1 -1
  48. package/dist/hooks/processors/agentExecutionComplete.js.map +1 -1
  49. package/dist/hooks/processors/fileSave.d.ts +1 -1
  50. package/dist/hooks/processors/fileSave.d.ts.map +1 -1
  51. package/dist/hooks/processors/fileSave.js +1 -1
  52. package/dist/hooks/processors/fileSave.js.map +1 -1
  53. package/dist/hooks/processors/permissionRequest.d.ts +1 -1
  54. package/dist/hooks/processors/permissionRequest.d.ts.map +1 -1
  55. package/dist/hooks/processors/permissionRequest.js +1 -1
  56. package/dist/hooks/processors/permissionRequest.js.map +1 -1
  57. package/dist/hooks/processors/sessionEnd.d.ts +1 -1
  58. package/dist/hooks/processors/sessionEnd.d.ts.map +1 -1
  59. package/dist/hooks/processors/sessionEnd.js +1 -1
  60. package/dist/hooks/processors/sessionEnd.js.map +1 -1
  61. package/dist/hooks/processors/sessionStart.d.ts +1 -1
  62. package/dist/hooks/processors/sessionStart.d.ts.map +1 -1
  63. package/dist/hooks/processors/sessionStart.js +1 -1
  64. package/dist/hooks/processors/sessionStart.js.map +1 -1
  65. package/dist/hooks/processors/setup.d.ts +1 -1
  66. package/dist/hooks/processors/setup.d.ts.map +1 -1
  67. package/dist/hooks/processors/setup.js +1 -1
  68. package/dist/hooks/processors/setup.js.map +1 -1
  69. package/dist/hooks/processors/userPromptSubmit.d.ts +1 -1
  70. package/dist/hooks/processors/userPromptSubmit.d.ts.map +1 -1
  71. package/dist/hooks/processors/userPromptSubmit.js +1 -1
  72. package/dist/hooks/processors/userPromptSubmit.js.map +1 -1
  73. package/dist/hooks/ralph/loop.js +2 -2
  74. package/dist/hooks/ralph/loop.js.map +1 -1
  75. package/dist/hooks/state/StateReader.d.ts +1 -1
  76. package/dist/hooks/state/StateReader.d.ts.map +1 -1
  77. package/dist/hooks/state/StateReader.js.map +1 -1
  78. package/dist/hooks/timeout-wrapper.js +1 -1
  79. package/dist/hooks/timeout-wrapper.js.map +1 -1
  80. package/dist/lib/file-lock.d.ts.map +1 -1
  81. package/dist/lib/file-lock.js.map +1 -1
  82. package/dist/mcp/adapters/memory-adapter.d.ts +1 -1
  83. package/dist/mcp/adapters/state-adapter.d.ts +6 -6
  84. package/dist/mcp/adapters/trace-adapter.d.ts +2 -2
  85. package/dist/mcp/config/schema.d.ts +3 -3
  86. package/dist/mcp/config-schema.d.ts +3 -3
  87. package/docs/AGENTS.md +19 -10
  88. package/docs/ANALYTICS-SYSTEM.md +57 -26
  89. package/docs/ARCHITECTURE.md +42 -29
  90. package/docs/AXIOM.md +117 -32
  91. package/docs/CJK-IME-KNOWN-ISSUES.md +67 -32
  92. package/docs/CLAUDE.md +289 -145
  93. package/docs/COMPATIBILITY.md +142 -81
  94. package/docs/DELEGATION-ENFORCER.md +27 -16
  95. package/docs/DOCUMENTATION_UPDATE_SUMMARY.md +25 -16
  96. package/docs/EVOLUTION.md +132 -62
  97. package/docs/FAQ.md +104 -45
  98. package/docs/FEATURES.md +122 -71
  99. package/docs/INSTALL.md +107 -37
  100. package/docs/INSTALL_FIX_SUMMARY.md +45 -23
  101. package/docs/INSTALL_FIX_VERIFICATION.md +7 -1
  102. package/docs/INSTALL_VERIFICATION_REPORT.md +31 -16
  103. package/docs/KNOWN_ISSUES.md +24 -7
  104. package/docs/LOCAL_INSTALL_VERIFICATION.md +44 -15
  105. package/docs/LOCAL_PLUGIN_INSTALL.md +27 -6
  106. package/docs/LOCAL_TEST_INSTALL_REPORT.md +10 -4
  107. package/docs/MAIN_DOCS_UPDATE_REPORT.md +26 -13
  108. package/docs/MIGRATION.md +340 -168
  109. package/docs/MIGRATION_GUIDE_v5.5.18.md +26 -10
  110. package/docs/NEXUS.md +79 -43
  111. package/docs/OMC-CLAUDE.md +274 -137
  112. package/docs/PERFORMANCE-MONITORING.md +73 -35
  113. package/docs/PLUGIN_MARKETPLACE_VERIFICATION.md +23 -8
  114. package/docs/QUICKSTART.md +10 -7
  115. package/docs/README.codex.md +17 -12
  116. package/docs/README.md +63 -29
  117. package/docs/README.opencode.md +66 -24
  118. package/docs/REFERENCE.md +183 -105
  119. package/docs/RELEASE.md +21 -11
  120. package/docs/RELEASE_GUIDE.md +71 -23
  121. package/docs/RELEASE_NOTES_v5.5.14.md +47 -24
  122. package/docs/RELEASE_RECOVERY.md +24 -8
  123. package/docs/RELEASE_SUMMARY_v5.5.18.md +44 -24
  124. package/docs/SYNC-SYSTEM.md +74 -35
  125. package/docs/TIERED_AGENTS_V2.md +203 -106
  126. package/docs/TUTORIAL.md +49 -18
  127. package/docs/UPGRADE_VERIFICATION.md +73 -17
  128. package/docs/UPGRADE_VERIFICATION_REPORT.md +25 -9
  129. package/docs/USER_GUIDE.md +337 -107
  130. package/docs/VALIDATION_REPORT.md +138 -68
  131. package/docs/VERIFICATION_SUMMARY.md +46 -25
  132. package/docs/adr/001-worker-state-adapter.md +96 -50
  133. package/docs/adr/002-caching-strategy.md +46 -25
  134. package/docs/adr/003-gradual-migration.md +113 -56
  135. package/docs/adr/template.md +47 -23
  136. package/docs/agent-templates/AGENTS.md +10 -5
  137. package/docs/agent-templates/README.md +54 -29
  138. package/docs/agent-templates/base-agent.md +49 -23
  139. package/docs/agent-templates/tier-instructions.md +51 -25
  140. package/docs/api/assets/highlight.css +85 -85
  141. package/docs/api/assets/style.css +1633 -1633
  142. package/docs/api/classes/ContextCollector.html +21 -21
  143. package/docs/api/functions/activateUltrawork.html +2 -2
  144. package/docs/api/functions/addCustomNote.html +5 -5
  145. package/docs/api/functions/addDirective.html +2 -2
  146. package/docs/api/functions/addManualEntry.html +2 -2
  147. package/docs/api/functions/addPattern.html +3 -3
  148. package/docs/api/functions/addWorker.html +2 -2
  149. package/docs/api/functions/addWorkingMemoryEntry.html +2 -2
  150. package/docs/api/functions/analyzeContextUsage.html +2 -2
  151. package/docs/api/functions/appendProgress.html +2 -2
  152. package/docs/api/functions/appendSessionId.html +2 -2
  153. package/docs/api/functions/applyCommentFilters.html +3 -3
  154. package/docs/api/functions/assignFileToWorker.html +2 -2
  155. package/docs/api/functions/backgroundUpdateCheck.html +2 -2
  156. package/docs/api/functions/buildAxiomBootContext.html +1 -1
  157. package/docs/api/functions/buildBoulderContinuation.html +2 -2
  158. package/docs/api/functions/buildDelegationTable.html +2 -2
  159. package/docs/api/functions/buildKeyTriggersSection.html +2 -2
  160. package/docs/api/functions/buildOrchestratorReminder.html +2 -2
  161. package/docs/api/functions/buildUseAvoidSection.html +2 -2
  162. package/docs/api/functions/buildVerificationReminder.html +2 -2
  163. package/docs/api/functions/canResumeAutopilot.html +10 -10
  164. package/docs/api/functions/canStartMode.html +5 -5
  165. package/docs/api/functions/cancelAutopilot.html +3 -3
  166. package/docs/api/functions/cancelUltraQA.html +2 -2
  167. package/docs/api/functions/checkBackgroundNotifications.html +2 -2
  168. package/docs/api/functions/checkBoulderContinuation.html +2 -2
  169. package/docs/api/functions/checkDuplicateTriggers.html +2 -2
  170. package/docs/api/functions/checkExpertGate.html +1 -1
  171. package/docs/api/functions/checkForComments.html +2 -2
  172. package/docs/api/functions/checkForUpdates.html +2 -2
  173. package/docs/api/functions/checkIncompleteTodos.html +13 -13
  174. package/docs/api/functions/checkPersistentModes.html +3 -3
  175. package/docs/api/functions/cleanupOrphanedState.html +2 -2
  176. package/docs/api/functions/cleanupStaleAgents.html +2 -2
  177. package/docs/api/functions/cleanupTransientState.html +2 -2
  178. package/docs/api/functions/clearAgentUsageState.html +1 -1
  179. package/docs/api/functions/clearAllModeStates.html +2 -2
  180. package/docs/api/functions/clearAutopilot.html +2 -2
  181. package/docs/api/functions/clearAutopilotState.html +2 -2
  182. package/docs/api/functions/clearBeadsContext.html +2 -2
  183. package/docs/api/functions/clearBoulderState.html +2 -2
  184. package/docs/api/functions/clearDetectionState.html +2 -2
  185. package/docs/api/functions/clearInjectedPaths.html +2 -2
  186. package/docs/api/functions/clearInjectedRules.html +2 -2
  187. package/docs/api/functions/clearLinkedUltraworkState.html +2 -2
  188. package/docs/api/functions/clearModeState.html +10 -10
  189. package/docs/api/functions/clearProjectMemorySession.html +4 -4
  190. package/docs/api/functions/clearRalphState.html +2 -2
  191. package/docs/api/functions/clearRapidFireDebounce.html +2 -2
  192. package/docs/api/functions/clearSkillSession.html +2 -2
  193. package/docs/api/functions/clearThinkModeState.html +2 -2
  194. package/docs/api/functions/clearTrackingState.html +2 -2
  195. package/docs/api/functions/clearUltraQAState.html +2 -2
  196. package/docs/api/functions/clearVerificationState.html +3 -3
  197. package/docs/api/functions/commandExists.html +2 -2
  198. package/docs/api/functions/compareVersions.html +3 -3
  199. package/docs/api/functions/completeUltraQA.html +2 -2
  200. package/docs/api/functions/completeUltrapilot.html +2 -2
  201. package/docs/api/functions/completeWorker.html +2 -2
  202. package/docs/api/functions/containsTokenLimitError.html +2 -2
  203. package/docs/api/functions/createAgentToolRestrictions.html +3 -3
  204. package/docs/api/functions/createAgentUsageReminderHook.html +1 -1
  205. package/docs/api/functions/createAutoSlashCommandHook.html +7 -7
  206. package/docs/api/functions/createBackgroundNotificationHook.html +7 -7
  207. package/docs/api/functions/createBackgroundTaskManager.html +2 -2
  208. package/docs/api/functions/createBoulderState.html +2 -2
  209. package/docs/api/functions/createCommentCheckerHook.html +6 -6
  210. package/docs/api/functions/createCompactCheckpoint.html +2 -2
  211. package/docs/api/functions/createContentHash.html +2 -2
  212. package/docs/api/functions/createContextInjectorHook.html +7 -7
  213. package/docs/api/functions/createDirectoryReadmeInjectorHook.html +9 -9
  214. package/docs/api/functions/createEmptyMessageSanitizerHook.html +6 -6
  215. package/docs/api/functions/createEnvContext.html +2 -2
  216. package/docs/api/functions/createHookOutput.html +4 -4
  217. package/docs/api/functions/createLearnedSkillsHook.html +6 -6
  218. package/docs/api/functions/createMagicKeywordProcessor.html +2 -2
  219. package/docs/api/functions/createModeMarker.html +6 -6
  220. package/docs/api/functions/createPrd.html +2 -2
  221. package/docs/api/functions/createPreemptiveCompactionHook.html +6 -6
  222. package/docs/api/functions/createRalphLoopHook.html +2 -2
  223. package/docs/api/functions/createRecoveryHook.html +7 -7
  224. package/docs/api/functions/createRulesInjectorHook.html +8 -8
  225. package/docs/api/functions/createSimplePrd.html +2 -2
  226. package/docs/api/functions/createSisyphusOrchestratorHook.html +7 -7
  227. package/docs/api/functions/createSisyphusSession.html +7 -7
  228. package/docs/api/functions/createThinkModeHook.html +7 -7
  229. package/docs/api/functions/createThinkingBlockValidatorHook.html +1 -1
  230. package/docs/api/functions/createTodoContinuationHook.html +2 -2
  231. package/docs/api/functions/createUltraworkStateHook.html +2 -2
  232. package/docs/api/functions/deactivateUltrawork.html +8 -8
  233. package/docs/api/functions/decayHotPaths.html +2 -2
  234. package/docs/api/functions/decomposeTask.html +11 -11
  235. package/docs/api/functions/deepMerge.html +2 -2
  236. package/docs/api/functions/detectArchitectApproval.html +2 -2
  237. package/docs/api/functions/detectArchitectRejection.html +2 -2
  238. package/docs/api/functions/detectContextLimitError.html +2 -2
  239. package/docs/api/functions/detectContextLimitErrorInText.html +2 -2
  240. package/docs/api/functions/detectDirectivesFromMessage.html +2 -2
  241. package/docs/api/functions/detectEditError.html +2 -2
  242. package/docs/api/functions/detectEditErrorInOutput.html +2 -2
  243. package/docs/api/functions/detectEditErrorInText.html +2 -2
  244. package/docs/api/functions/detectExtractableMoment.html +2 -2
  245. package/docs/api/functions/detectKeywordsWithType.html +11 -11
  246. package/docs/api/functions/detectMagicKeywords.html +2 -2
  247. package/docs/api/functions/detectProjectEnvironment.html +2 -2
  248. package/docs/api/functions/detectRecoverableError.html +3 -3
  249. package/docs/api/functions/detectSessionErrorType.html +2 -2
  250. package/docs/api/functions/detectSlashCommand.html +3 -3
  251. package/docs/api/functions/detectThinkKeyword.html +2 -2
  252. package/docs/api/functions/detectUltrathinkKeyword.html +2 -2
  253. package/docs/api/functions/discoverAllCommands.html +2 -2
  254. package/docs/api/functions/enablePrdMode.html +2 -2
  255. package/docs/api/functions/enhancePrompt.html +2 -2
  256. package/docs/api/functions/ensureAutopilotDir.html +2 -2
  257. package/docs/api/functions/ensureDirectoryStructure.html +2 -2
  258. package/docs/api/functions/ensureModeStateDir.html +2 -2
  259. package/docs/api/functions/ensureSkillsDir.html +2 -2
  260. package/docs/api/functions/estimateTokens.html +2 -2
  261. package/docs/api/functions/executeSlashCommand.html +2 -2
  262. package/docs/api/functions/expandCommand.html +8 -8
  263. package/docs/api/functions/expandCommandPrompt.html +6 -6
  264. package/docs/api/functions/expandCommands.html +2 -2
  265. package/docs/api/functions/exportSessionSummary.html +2 -2
  266. package/docs/api/functions/exportWisdomToNotepad.html +2 -2
  267. package/docs/api/functions/extractPromptText.html +11 -11
  268. package/docs/api/functions/extractSlashPromptText.html +2 -2
  269. package/docs/api/functions/extractThinkPromptText.html +2 -2
  270. package/docs/api/functions/failWorker.html +2 -2
  271. package/docs/api/functions/findCommand.html +2 -2
  272. package/docs/api/functions/findMatchingSkills.html +2 -2
  273. package/docs/api/functions/findPlannerPlans.html +3 -3
  274. package/docs/api/functions/findPrdPath.html +2 -2
  275. package/docs/api/functions/findPreviousThinkingContent.html +1 -1
  276. package/docs/api/functions/findProgressPath.html +2 -2
  277. package/docs/api/functions/findProjectRoot.html +3 -3
  278. package/docs/api/functions/findRecoveryEmptyMessages.html +2 -2
  279. package/docs/api/functions/findRecoveryOrphanThinking.html +2 -2
  280. package/docs/api/functions/findRecoveryThinkingBlocks.html +2 -2
  281. package/docs/api/functions/findRuleFiles.html +4 -4
  282. package/docs/api/functions/findSkillFiles.html +3 -3
  283. package/docs/api/functions/formatCancelMessage.html +2 -2
  284. package/docs/api/functions/formatCompactSummary.html +2 -2
  285. package/docs/api/functions/formatContextSummary.html +3 -3
  286. package/docs/api/functions/formatDirectivesForContext.html +2 -2
  287. package/docs/api/functions/formatFailureSummary.html +2 -2
  288. package/docs/api/functions/formatFile.html +2 -2
  289. package/docs/api/functions/formatFileChanges.html +2 -2
  290. package/docs/api/functions/formatFileList.html +2 -2
  291. package/docs/api/functions/formatFullContext.html +2 -2
  292. package/docs/api/functions/formatFullNotepad.html +2 -2
  293. package/docs/api/functions/formatLearningsForContext.html +2 -2
  294. package/docs/api/functions/formatNextStoryPrompt.html +2 -2
  295. package/docs/api/functions/formatNotepadContext.html +2 -2
  296. package/docs/api/functions/formatPatternsForContext.html +2 -2
  297. package/docs/api/functions/formatPrd.html +2 -2
  298. package/docs/api/functions/formatPrdStatus.html +2 -2
  299. package/docs/api/functions/formatPreCompactSummary.html +2 -2
  300. package/docs/api/functions/formatProgressForContext.html +2 -2
  301. package/docs/api/functions/formatProgressMessage.html +2 -2
  302. package/docs/api/functions/formatStory.html +2 -2
  303. package/docs/api/functions/formatSummary.html +2 -2
  304. package/docs/api/functions/formatUpdateNotification.html +2 -2
  305. package/docs/api/functions/formatValidationResults.html +2 -2
  306. package/docs/api/functions/generateExtractionPrompt.html +2 -2
  307. package/docs/api/functions/generateSkillFrontmatter.html +2 -2
  308. package/docs/api/functions/generateSummary.html +2 -2
  309. package/docs/api/functions/getActiveAgentCount.html +2 -2
  310. package/docs/api/functions/getActiveExclusiveMode.html +4 -4
  311. package/docs/api/functions/getActiveModes.html +2 -2
  312. package/docs/api/functions/getActivePlanPath.html +2 -2
  313. package/docs/api/functions/getAgentDefinitions.html +2 -2
  314. package/docs/api/functions/getAgentsByType.html +2 -2
  315. package/docs/api/functions/getAllCommands.html +2 -2
  316. package/docs/api/functions/getAllModeStatuses.html +5 -5
  317. package/docs/api/functions/getAllSkills.html +2 -2
  318. package/docs/api/functions/getArchitectRejectionContinuationPrompt.html +2 -2
  319. package/docs/api/functions/getArchitectVerificationPrompt.html +2 -2
  320. package/docs/api/functions/getAutoFormatMessage.html +2 -2
  321. package/docs/api/functions/getAutopilotStateAge.html +3 -3
  322. package/docs/api/functions/getAvailableAgents.html +2 -2
  323. package/docs/api/functions/getAxiomDir.html +1 -1
  324. package/docs/api/functions/getBackgroundTaskGuidance.html +4 -4
  325. package/docs/api/functions/getBeadsContextConfig.html +2 -2
  326. package/docs/api/functions/getBeadsInstructions.html +2 -2
  327. package/docs/api/functions/getBoulderFilePath.html +2 -2
  328. package/docs/api/functions/getCheckpointPath.html +2 -2
  329. package/docs/api/functions/getClaudeThinkingConfig.html +3 -3
  330. package/docs/api/functions/getCommand.html +2 -2
  331. package/docs/api/functions/getCommandsDir.html +2 -2
  332. package/docs/api/functions/getCompactionQueueDepth.html +3 -3
  333. package/docs/api/functions/getCompletedWorkers.html +2 -2
  334. package/docs/api/functions/getDefaultMcpServers.html +1 -1
  335. package/docs/api/functions/getDefaultModelForCategory.html +2 -2
  336. package/docs/api/functions/getDetectionStats.html +2 -2
  337. package/docs/api/functions/getDirectPlanningPrompt.html +3 -3
  338. package/docs/api/functions/getExecutionPrompt.html +2 -2
  339. package/docs/api/functions/getExpansionPrompt.html +3 -3
  340. package/docs/api/functions/getExpertGateMessage.html +1 -1
  341. package/docs/api/functions/getFailedWorkers.html +2 -2
  342. package/docs/api/functions/getFormatter.html +2 -2
  343. package/docs/api/functions/getGitDiffStats.html +2 -2
  344. package/docs/api/functions/getGlobalStateFilePath.html +4 -4
  345. package/docs/api/functions/getGoalCommand.html +2 -2
  346. package/docs/api/functions/getHighVariant.html +3 -3
  347. package/docs/api/functions/getInstallInfo.html +2 -2
  348. package/docs/api/functions/getInstalledVersion.html +2 -2
  349. package/docs/api/functions/getIssuesToFix.html +2 -2
  350. package/docs/api/functions/getLastDetection.html +2 -2
  351. package/docs/api/functions/getLearnerConfigValue.html +2 -2
  352. package/docs/api/functions/getLinter.html +2 -2
  353. package/docs/api/functions/getManualSection.html +2 -2
  354. package/docs/api/functions/getMemoryFilePaths.html +1 -1
  355. package/docs/api/functions/getModeMarkerFilePath.html +2 -2
  356. package/docs/api/functions/getModeStateFilePath.html +2 -2
  357. package/docs/api/functions/getNextStory.html +2 -2
  358. package/docs/api/functions/getNotepadPath.html +2 -2
  359. package/docs/api/functions/getNotepadStats.html +2 -2
  360. package/docs/api/functions/getOmcPrdPath.html +2 -2
  361. package/docs/api/functions/getOmcProgressPath.html +2 -2
  362. package/docs/api/functions/getOmcSystemPrompt.html +2 -2
  363. package/docs/api/functions/getOmcToolNames.html +3 -3
  364. package/docs/api/functions/getPatterns.html +2 -2
  365. package/docs/api/functions/getPhasePrompt.html +2 -2
  366. package/docs/api/functions/getPlanName.html +2 -2
  367. package/docs/api/functions/getPlanPath.html +2 -2
  368. package/docs/api/functions/getPlanProgress.html +2 -2
  369. package/docs/api/functions/getPlanSummaries.html +2 -2
  370. package/docs/api/functions/getPrdCompletionStatus.html +2 -2
  371. package/docs/api/functions/getPrdPath.html +2 -2
  372. package/docs/api/functions/getPrdStatus.html +2 -2
  373. package/docs/api/functions/getPreCommitReminderMessage.html +2 -2
  374. package/docs/api/functions/getPriorityContext.html +2 -2
  375. package/docs/api/functions/getProgressContext.html +2 -2
  376. package/docs/api/functions/getProgressPath.html +2 -2
  377. package/docs/api/functions/getPromotionCandidates.html +2 -2
  378. package/docs/api/functions/getQAPrompt.html +2 -2
  379. package/docs/api/functions/getRalphContext.html +3 -3
  380. package/docs/api/functions/getReadmesForPath.html +2 -2
  381. package/docs/api/functions/getRecentLearnings.html +2 -2
  382. package/docs/api/functions/getRulesForPath.html +2 -2
  383. package/docs/api/functions/getRunningAgents.html +2 -2
  384. package/docs/api/functions/getRunningWorkers.html +2 -2
  385. package/docs/api/functions/getSessionTokenEstimate.html +2 -2
  386. package/docs/api/functions/getSkillsDir.html +2 -2
  387. package/docs/api/functions/getSpecPath.html +2 -2
  388. package/docs/api/functions/getStaleAgents.html +2 -2
  389. package/docs/api/functions/getStateDir.html +2 -2
  390. package/docs/api/functions/getStory.html +2 -2
  391. package/docs/api/functions/getSubagentStateFilePath.html +2 -2
  392. package/docs/api/functions/getThinkModeState.html +2 -2
  393. package/docs/api/functions/getThinkingConfig.html +3 -3
  394. package/docs/api/functions/getTopHotPaths.html +2 -2
  395. package/docs/api/functions/getTrackingStats.html +2 -2
  396. package/docs/api/functions/getTransitionPrompt.html +2 -2
  397. package/docs/api/functions/getUltraworkPersistenceMessage.html +2 -2
  398. package/docs/api/functions/getValidationPrompt.html +2 -2
  399. package/docs/api/functions/getValidationSpawnPrompt.html +2 -2
  400. package/docs/api/functions/getValidationStats.html +1 -1
  401. package/docs/api/functions/getValidationStatus.html +2 -2
  402. package/docs/api/functions/getWorkingMemory.html +2 -2
  403. package/docs/api/functions/handleBackgroundEvent.html +3 -3
  404. package/docs/api/functions/handleContextWindowRecovery.html +2 -2
  405. package/docs/api/functions/handleEditErrorRecovery.html +2 -2
  406. package/docs/api/functions/handlePermissionRequest.html +2 -2
  407. package/docs/api/functions/handleRecovery.html +10 -10
  408. package/docs/api/functions/handleSessionEnd.html +2 -2
  409. package/docs/api/functions/handleSessionRecovery.html +2 -2
  410. package/docs/api/functions/handleSharedFiles.html +7 -7
  411. package/docs/api/functions/handleSubagentStart.html +2 -2
  412. package/docs/api/functions/handleSubagentStop.html +2 -2
  413. package/docs/api/functions/hasBoulder.html +2 -2
  414. package/docs/api/functions/hasContentParts.html +1 -1
  415. package/docs/api/functions/hasModeState.html +3 -3
  416. package/docs/api/functions/hasPrd.html +2 -2
  417. package/docs/api/functions/hasTextContent.html +2 -2
  418. package/docs/api/functions/hasValidContent.html +3 -3
  419. package/docs/api/functions/incrementAgentCount.html +2 -2
  420. package/docs/api/functions/incrementRalphIteration.html +2 -2
  421. package/docs/api/functions/incrementReinforcement.html +2 -2
  422. package/docs/api/functions/initAutopilot.html +2 -2
  423. package/docs/api/functions/initNotepad.html +2 -2
  424. package/docs/api/functions/initPrd.html +2 -2
  425. package/docs/api/functions/initProgress.html +2 -2
  426. package/docs/api/functions/initUltrapilot.html +2 -2
  427. package/docs/api/functions/injectContextIntoText.html +2 -2
  428. package/docs/api/functions/injectPendingContext.html +3 -3
  429. package/docs/api/functions/injectRecoveryTextPart.html +2 -2
  430. package/docs/api/functions/install.html +2 -2
  431. package/docs/api/functions/integrateResults.html +5 -5
  432. package/docs/api/functions/isActiveModeRunning.html +2 -2
  433. package/docs/api/functions/isAllowedPath.html +2 -2
  434. package/docs/api/functions/isAlreadyHighVariant.html +2 -2
  435. package/docs/api/functions/isAutopilotActive.html +2 -2
  436. package/docs/api/functions/isAxiomEnabled.html +1 -1
  437. package/docs/api/functions/isClaudeInstalled.html +3 -3
  438. package/docs/api/functions/isClaudeModel.html +2 -2
  439. package/docs/api/functions/isCompactionInProgress.html +3 -3
  440. package/docs/api/functions/isDuplicateByContentHash.html +2 -2
  441. package/docs/api/functions/isDuplicateByRealPath.html +2 -2
  442. package/docs/api/functions/isExcludedCommand.html +2 -2
  443. package/docs/api/functions/isExtendedThinkingModel.html +1 -1
  444. package/docs/api/functions/isFileOwnedByWorker.html +2 -2
  445. package/docs/api/functions/isFormatterAvailable.html +2 -2
  446. package/docs/api/functions/isGptModel.html +2 -2
  447. package/docs/api/functions/isInstalled.html +2 -2
  448. package/docs/api/functions/isLearnerEnabled.html +2 -2
  449. package/docs/api/functions/isModeActive.html +6 -6
  450. package/docs/api/functions/isNonInteractive.html +1 -1
  451. package/docs/api/functions/isRecoverableError.html +2 -2
  452. package/docs/api/functions/isSafeCommand.html +2 -2
  453. package/docs/api/functions/isSessionRecoverable.html +2 -2
  454. package/docs/api/functions/isSharedFile.html +2 -2
  455. package/docs/api/functions/isThinkModeActive.html +2 -2
  456. package/docs/api/functions/isToolPart.html +2 -2
  457. package/docs/api/functions/isUltraQAActive.html +1 -1
  458. package/docs/api/functions/isWriteEditTool.html +2 -2
  459. package/docs/api/functions/learnFromToolOutput.html +7 -7
  460. package/docs/api/functions/lintFile.html +2 -2
  461. package/docs/api/functions/listAvailableCommands.html +2 -2
  462. package/docs/api/functions/listCommands.html +2 -2
  463. package/docs/api/functions/listPromotableLearnings.html +2 -2
  464. package/docs/api/functions/loadAgentPrompt.html +7 -7
  465. package/docs/api/functions/loadAgentUsageState.html +1 -1
  466. package/docs/api/functions/loadAllSkills.html +3 -3
  467. package/docs/api/functions/loadConfig.html +2 -2
  468. package/docs/api/functions/loadInjectedPaths.html +2 -2
  469. package/docs/api/functions/loadInjectedRules.html +2 -2
  470. package/docs/api/functions/loadLearnerConfig.html +2 -2
  471. package/docs/api/functions/loadProjectMemory.html +3 -3
  472. package/docs/api/functions/loadSkillById.html +2 -2
  473. package/docs/api/functions/mapDirectoryStructure.html +2 -2
  474. package/docs/api/functions/markStoryComplete.html +2 -2
  475. package/docs/api/functions/markStoryIncomplete.html +2 -2
  476. package/docs/api/functions/mergeAgentConfig.html +2 -2
  477. package/docs/api/functions/parseAxiomState.html +1 -1
  478. package/docs/api/functions/parseContextLimitError.html +2 -2
  479. package/docs/api/functions/parseProgress.html +2 -2
  480. package/docs/api/functions/parseRuleFrontmatter.html +10 -10
  481. package/docs/api/functions/parseSkillFile.html +2 -2
  482. package/docs/api/functions/parseSlashCommand.html +2 -2
  483. package/docs/api/functions/parseTokenLimitError.html +2 -2
  484. package/docs/api/functions/performUpdate.html +2 -2
  485. package/docs/api/functions/prependRecoveryThinkingPart.html +2 -2
  486. package/docs/api/functions/prependThinkingBlock.html +1 -1
  487. package/docs/api/functions/processAxiomBoot.html +1 -1
  488. package/docs/api/functions/processAxiomGuards.html +1 -1
  489. package/docs/api/functions/processBackgroundNotification.html +2 -2
  490. package/docs/api/functions/processBackgroundNotificationHook.html +2 -2
  491. package/docs/api/functions/processEditOutput.html +2 -2
  492. package/docs/api/functions/processHook.html +3 -3
  493. package/docs/api/functions/processMessageForSkills.html +2 -2
  494. package/docs/api/functions/processOrchestratorPostTool.html +3 -3
  495. package/docs/api/functions/processOrchestratorPreTool.html +3 -3
  496. package/docs/api/functions/processPermissionRequest.html +2 -2
  497. package/docs/api/functions/processPreCompact.html +6 -6
  498. package/docs/api/functions/processProjectMemoryPreCompact.html +3 -3
  499. package/docs/api/functions/processResponseForDetection.html +3 -3
  500. package/docs/api/functions/processSessionEnd.html +2 -2
  501. package/docs/api/functions/processSetup.html +2 -2
  502. package/docs/api/functions/processSetupInit.html +2 -2
  503. package/docs/api/functions/processSetupMaintenance.html +2 -2
  504. package/docs/api/functions/processSlashCommand.html +2 -2
  505. package/docs/api/functions/processSubagentStart.html +2 -2
  506. package/docs/api/functions/processSubagentStop.html +2 -2
  507. package/docs/api/functions/processThinkMode.html +3 -3
  508. package/docs/api/functions/promoteLearning.html +2 -2
  509. package/docs/api/functions/pruneOldEntries.html +2 -2
  510. package/docs/api/functions/pruneOldStateFiles.html +2 -2
  511. package/docs/api/functions/readActiveContext.html +1 -1
  512. package/docs/api/functions/readAutopilotState.html +2 -2
  513. package/docs/api/functions/readBoulderState.html +2 -2
  514. package/docs/api/functions/readModeMarker.html +4 -4
  515. package/docs/api/functions/readNotepad.html +2 -2
  516. package/docs/api/functions/readPrd.html +2 -2
  517. package/docs/api/functions/readProgress.html +2 -2
  518. package/docs/api/functions/readProgressRaw.html +2 -2
  519. package/docs/api/functions/readProjectDecisions.html +1 -1
  520. package/docs/api/functions/readRalphState.html +2 -2
  521. package/docs/api/functions/readRecoveryMessages.html +2 -2
  522. package/docs/api/functions/readRecoveryParts.html +2 -2
  523. package/docs/api/functions/readTrackingState.html +3 -3
  524. package/docs/api/functions/readUltraQAState.html +2 -2
  525. package/docs/api/functions/readUltrapilotState.html +2 -2
  526. package/docs/api/functions/readUltraworkState.html +4 -4
  527. package/docs/api/functions/readUserPreferences.html +1 -1
  528. package/docs/api/functions/readVerificationState.html +3 -3
  529. package/docs/api/functions/recordArchitectFeedback.html +2 -2
  530. package/docs/api/functions/recordConflict.html +2 -2
  531. package/docs/api/functions/recordFailure.html +2 -2
  532. package/docs/api/functions/recordHookFire.html +2 -2
  533. package/docs/api/functions/recordHookResult.html +2 -2
  534. package/docs/api/functions/recordKeywordDetected.html +2 -2
  535. package/docs/api/functions/recordModeChange.html +2 -2
  536. package/docs/api/functions/recordPattern.html +2 -2
  537. package/docs/api/functions/recordSessionMetrics.html +2 -2
  538. package/docs/api/functions/recordSkillActivated.html +2 -2
  539. package/docs/api/functions/recordSkillInvoked.html +2 -2
  540. package/docs/api/functions/recordStoryProgress.html +2 -2
  541. package/docs/api/functions/recordValidationVerdict.html +2 -2
  542. package/docs/api/functions/registerBeadsContext.html +3 -3
  543. package/docs/api/functions/registerProjectMemoryContext.html +6 -6
  544. package/docs/api/functions/removeCodeBlocks.html +12 -12
  545. package/docs/api/functions/removeModeMarker.html +5 -5
  546. package/docs/api/functions/removeSlashCodeBlocks.html +2 -2
  547. package/docs/api/functions/removeThinkCodeBlocks.html +2 -2
  548. package/docs/api/functions/replaceRecoveryEmptyTextParts.html +2 -2
  549. package/docs/api/functions/rescanProjectEnvironment.html +4 -4
  550. package/docs/api/functions/resetSessionTokenEstimate.html +2 -2
  551. package/docs/api/functions/resumeAutopilot.html +2 -2
  552. package/docs/api/functions/runPreCommitChecks.html +2 -2
  553. package/docs/api/functions/runTests.html +2 -2
  554. package/docs/api/functions/runTypeCheck.html +2 -2
  555. package/docs/api/functions/sanitizeMessage.html +2 -2
  556. package/docs/api/functions/sanitizeMessages.html +2 -2
  557. package/docs/api/functions/saveAgentUsageState.html +1 -1
  558. package/docs/api/functions/saveInjectedPaths.html +2 -2
  559. package/docs/api/functions/saveInjectedRules.html +2 -2
  560. package/docs/api/functions/saveLearnerConfig.html +2 -2
  561. package/docs/api/functions/saveModeSummary.html +2 -2
  562. package/docs/api/functions/saveProjectMemory.html +3 -3
  563. package/docs/api/functions/saveVersionMetadata.html +2 -2
  564. package/docs/api/functions/setCurrentStory.html +2 -2
  565. package/docs/api/functions/setEnvironmentVariables.html +2 -2
  566. package/docs/api/functions/setLearnerConfigValue.html +2 -2
  567. package/docs/api/functions/setPriorityContext.html +2 -2
  568. package/docs/api/functions/shouldActivateThinkMode.html +3 -3
  569. package/docs/api/functions/shouldActivateUltrathink.html +2 -2
  570. package/docs/api/functions/shouldApplyRule.html +2 -2
  571. package/docs/api/functions/shouldCheckForUpdates.html +2 -2
  572. package/docs/api/functions/shouldCompleteByPrd.html +2 -2
  573. package/docs/api/functions/shouldPromptExtraction.html +2 -2
  574. package/docs/api/functions/shouldReinforceUltrawork.html +2 -2
  575. package/docs/api/functions/shouldRetryValidation.html +2 -2
  576. package/docs/api/functions/shouldRunInBackground.html +8 -8
  577. package/docs/api/functions/spawnWorkers.html +7 -7
  578. package/docs/api/functions/startUltraQA.html +3 -3
  579. package/docs/api/functions/startUltrapilot.html +7 -7
  580. package/docs/api/functions/startValidationRound.html +2 -2
  581. package/docs/api/functions/startVerification.html +2 -2
  582. package/docs/api/functions/startsWithThinkingBlock.html +1 -1
  583. package/docs/api/functions/stopUltraQA.html +2 -2
  584. package/docs/api/functions/stripRecoveryThinkingParts.html +2 -2
  585. package/docs/api/functions/toSdkMcpFormat.html +2 -2
  586. package/docs/api/functions/trackAccess.html +2 -2
  587. package/docs/api/functions/trackProgress.html +5 -5
  588. package/docs/api/functions/transitionPhase.html +2 -2
  589. package/docs/api/functions/transitionRalphToUltraQA.html +9 -9
  590. package/docs/api/functions/transitionToComplete.html +2 -2
  591. package/docs/api/functions/transitionToFailed.html +2 -2
  592. package/docs/api/functions/transitionUltraQAToValidation.html +2 -2
  593. package/docs/api/functions/updateDirectoryAccess.html +2 -2
  594. package/docs/api/functions/updateExecution.html +2 -2
  595. package/docs/api/functions/updateExpansion.html +2 -2
  596. package/docs/api/functions/updatePlanning.html +2 -2
  597. package/docs/api/functions/updateQA.html +2 -2
  598. package/docs/api/functions/updateValidation.html +2 -2
  599. package/docs/api/functions/updateWorkerState.html +2 -2
  600. package/docs/api/functions/validateAgentConfig.html +2 -2
  601. package/docs/api/functions/validateCommitMessage.html +2 -2
  602. package/docs/api/functions/validateConfigFiles.html +2 -2
  603. package/docs/api/functions/validateExtractionRequest.html +2 -2
  604. package/docs/api/functions/validateMessage.html +1 -1
  605. package/docs/api/functions/validateMessages.html +1 -1
  606. package/docs/api/functions/validateSkillMetadata.html +2 -2
  607. package/docs/api/functions/writeAutopilotState.html +2 -2
  608. package/docs/api/functions/writeBoulderState.html +2 -2
  609. package/docs/api/functions/writePrd.html +2 -2
  610. package/docs/api/functions/writeRalphState.html +2 -2
  611. package/docs/api/functions/writeSkill.html +2 -2
  612. package/docs/api/functions/writeTrackingState.html +5 -5
  613. package/docs/api/functions/writeUltraQAState.html +2 -2
  614. package/docs/api/functions/writeUltrapilotState.html +2 -2
  615. package/docs/api/functions/writeUltraworkState.html +2 -2
  616. package/docs/api/functions/writeVerificationState.html +2 -2
  617. package/docs/api/hierarchy.html +1 -1
  618. package/docs/api/index.html +843 -843
  619. package/docs/api/interfaces/AgentConfig.html +18 -18
  620. package/docs/api/interfaces/AgentOverrideConfig.html +10 -10
  621. package/docs/api/interfaces/AgentPromptMetadata.html +19 -19
  622. package/docs/api/interfaces/AgentState.html +5 -5
  623. package/docs/api/interfaces/AgentUsageState.html +8 -8
  624. package/docs/api/interfaces/AutoSlashCommandHookInput.html +5 -5
  625. package/docs/api/interfaces/AutoSlashCommandHookOutput.html +3 -3
  626. package/docs/api/interfaces/AutoSlashCommandResult.html +5 -5
  627. package/docs/api/interfaces/AutopilotConfig.html +26 -26
  628. package/docs/api/interfaces/AutopilotExecution.html +16 -16
  629. package/docs/api/interfaces/AutopilotExpansion.html +12 -12
  630. package/docs/api/interfaces/AutopilotPlanning.html +8 -8
  631. package/docs/api/interfaces/AutopilotQA.html +12 -12
  632. package/docs/api/interfaces/AutopilotResult.html +10 -10
  633. package/docs/api/interfaces/AutopilotState.html +36 -36
  634. package/docs/api/interfaces/AutopilotSummary.html +16 -16
  635. package/docs/api/interfaces/AutopilotValidation.html +10 -10
  636. package/docs/api/interfaces/AutopilotValidationResult.html +8 -8
  637. package/docs/api/interfaces/AvailableAgent.html +5 -5
  638. package/docs/api/interfaces/AxiomBootInput.html +3 -3
  639. package/docs/api/interfaces/AxiomBootOutput.html +4 -4
  640. package/docs/api/interfaces/AxiomGuardsInput.html +4 -4
  641. package/docs/api/interfaces/AxiomGuardsOutput.html +4 -4
  642. package/docs/api/interfaces/AxiomMemoryFiles.html +5 -5
  643. package/docs/api/interfaces/AxiomState.html +8 -8
  644. package/docs/api/interfaces/BackgroundNotificationHookConfig.html +11 -11
  645. package/docs/api/interfaces/BackgroundNotificationHookInput.html +8 -8
  646. package/docs/api/interfaces/BackgroundNotificationHookOutput.html +8 -8
  647. package/docs/api/interfaces/BackgroundTask.html +7 -7
  648. package/docs/api/interfaces/BackgroundTaskManager.html +26 -26
  649. package/docs/api/interfaces/BeadsContextConfig.html +4 -4
  650. package/docs/api/interfaces/BoulderState.html +12 -12
  651. package/docs/api/interfaces/BuildInfo.html +6 -6
  652. package/docs/api/interfaces/CanStartResult.html +4 -4
  653. package/docs/api/interfaces/CancelResult.html +4 -4
  654. package/docs/api/interfaces/ClaudeThinkingConfig.html +4 -4
  655. package/docs/api/interfaces/CodeConventions.html +5 -5
  656. package/docs/api/interfaces/CodebasePattern.html +5 -5
  657. package/docs/api/interfaces/CommandInfo.html +5 -5
  658. package/docs/api/interfaces/CommandMetadata.html +7 -7
  659. package/docs/api/interfaces/CommentCheckResult.html +10 -10
  660. package/docs/api/interfaces/CommentCheckerConfig.html +6 -6
  661. package/docs/api/interfaces/CommentInfo.html +14 -14
  662. package/docs/api/interfaces/CommentPendingCall.html +18 -18
  663. package/docs/api/interfaces/CommitConfig.html +9 -9
  664. package/docs/api/interfaces/CompactCheckpoint.html +7 -7
  665. package/docs/api/interfaces/ContextEntry.html +14 -14
  666. package/docs/api/interfaces/ContextUsageResult.html +12 -12
  667. package/docs/api/interfaces/CustomNote.html +5 -5
  668. package/docs/api/interfaces/DelegationDecision.html +7 -7
  669. package/docs/api/interfaces/DelegationRoute.html +7 -7
  670. package/docs/api/interfaces/DelegationRoutingConfig.html +5 -5
  671. package/docs/api/interfaces/DelegationTrigger.html +6 -6
  672. package/docs/api/interfaces/DetectedKeyword.html +13 -13
  673. package/docs/api/interfaces/DetectionConfig.html +8 -8
  674. package/docs/api/interfaces/DetectionResult.html +13 -13
  675. package/docs/api/interfaces/DirectoryInfo.html +7 -7
  676. package/docs/api/interfaces/EmptyMessageSanitizerConfig.html +6 -6
  677. package/docs/api/interfaces/EmptyMessageSanitizerInput.html +6 -6
  678. package/docs/api/interfaces/EmptyMessageSanitizerOutput.html +8 -8
  679. package/docs/api/interfaces/ExecuteResult.html +5 -5
  680. package/docs/api/interfaces/ExpandedCommand.html +4 -4
  681. package/docs/api/interfaces/ExternalModelPreference.html +4 -4
  682. package/docs/api/interfaces/ExternalModelsConfig.html +6 -6
  683. package/docs/api/interfaces/ExternalModelsDefaults.html +5 -5
  684. package/docs/api/interfaces/ExternalModelsFallbackPolicy.html +5 -5
  685. package/docs/api/interfaces/FileOwnership.html +8 -8
  686. package/docs/api/interfaces/FormatConfig.html +7 -7
  687. package/docs/api/interfaces/FrameworkDetection.html +4 -4
  688. package/docs/api/interfaces/FullAgentConfig.html +26 -26
  689. package/docs/api/interfaces/GateCheckResult.html +5 -5
  690. package/docs/api/interfaces/GitBranchPattern.html +3 -3
  691. package/docs/api/interfaces/HookContext.html +5 -5
  692. package/docs/api/interfaces/HookDefinition.html +5 -5
  693. package/docs/api/interfaces/HookInput.html +18 -18
  694. package/docs/api/interfaces/HookOutput.html +10 -10
  695. package/docs/api/interfaces/HookResult.html +4 -4
  696. package/docs/api/interfaces/HotPath.html +6 -6
  697. package/docs/api/interfaces/InjectedPathsData.html +9 -9
  698. package/docs/api/interfaces/InjectedRulesData.html +10 -10
  699. package/docs/api/interfaces/InjectedSkillsData.html +8 -8
  700. package/docs/api/interfaces/InjectionResult.html +8 -8
  701. package/docs/api/interfaces/InstallOptions.html +9 -9
  702. package/docs/api/interfaces/InstallResult.html +10 -10
  703. package/docs/api/interfaces/IntegrationResult.html +14 -14
  704. package/docs/api/interfaces/LanguageDetection.html +5 -5
  705. package/docs/api/interfaces/LearnedSkill.html +16 -16
  706. package/docs/api/interfaces/LearnerConfig.html +18 -18
  707. package/docs/api/interfaces/LintConfig.html +7 -7
  708. package/docs/api/interfaces/MagicKeyword.html +4 -4
  709. package/docs/api/interfaces/MatchResult.html +6 -6
  710. package/docs/api/interfaces/MessageContext.html +8 -8
  711. package/docs/api/interfaces/MessageInfo.html +9 -9
  712. package/docs/api/interfaces/MessagePart.html +15 -15
  713. package/docs/api/interfaces/MessageWithModel.html +3 -3
  714. package/docs/api/interfaces/MessageWithParts.html +6 -6
  715. package/docs/api/interfaces/MessagesTransformHook.html +3 -3
  716. package/docs/api/interfaces/MessagesTransformInput.html +3 -3
  717. package/docs/api/interfaces/MessagesTransformOutput.html +3 -3
  718. package/docs/api/interfaces/ModeConfig.html +13 -13
  719. package/docs/api/interfaces/ModeStatus.html +4 -4
  720. package/docs/api/interfaces/ModelRef.html +4 -4
  721. package/docs/api/interfaces/NonInteractiveEnvConfig.html +2 -2
  722. package/docs/api/interfaces/NotepadConfig.html +7 -7
  723. package/docs/api/interfaces/NotepadStats.html +11 -11
  724. package/docs/api/interfaces/NotificationCheckResult.html +8 -8
  725. package/docs/api/interfaces/OrchestratorToolInput.html +6 -6
  726. package/docs/api/interfaces/OrchestratorToolOutput.html +6 -6
  727. package/docs/api/interfaces/OutputPart.html +4 -4
  728. package/docs/api/interfaces/PRD.html +9 -9
  729. package/docs/api/interfaces/PRDStatus.html +13 -13
  730. package/docs/api/interfaces/ParsedSlashCommand.html +8 -8
  731. package/docs/api/interfaces/ParsedTokenLimitError.html +16 -16
  732. package/docs/api/interfaces/PendingContext.html +8 -8
  733. package/docs/api/interfaces/PermissionHookOutput.html +4 -4
  734. package/docs/api/interfaces/PermissionRequestInput.html +9 -9
  735. package/docs/api/interfaces/PersistentModeResult.html +9 -9
  736. package/docs/api/interfaces/PlanProgress.html +8 -8
  737. package/docs/api/interfaces/PlanSummary.html +10 -10
  738. package/docs/api/interfaces/PluginConfig.html +17 -17
  739. package/docs/api/interfaces/PreCommitResult.html +3 -3
  740. package/docs/api/interfaces/PreCompactHookOutput.html +4 -4
  741. package/docs/api/interfaces/PreCompactInput.html +8 -8
  742. package/docs/api/interfaces/PreemptiveCompactionConfig.html +14 -14
  743. package/docs/api/interfaces/PriorityContextResult.html +5 -5
  744. package/docs/api/interfaces/ProgressEntry.html +11 -11
  745. package/docs/api/interfaces/ProgressLog.html +7 -7
  746. package/docs/api/interfaces/ProjectMemory.html +14 -14
  747. package/docs/api/interfaces/ProjectStructure.html +5 -5
  748. package/docs/api/interfaces/PromotionCandidate.html +9 -9
  749. package/docs/api/interfaces/PruneResult.html +5 -5
  750. package/docs/api/interfaces/QualityValidation.html +10 -10
  751. package/docs/api/interfaces/RalphLoopHook.html +4 -4
  752. package/docs/api/interfaces/RalphLoopOptions.html +5 -5
  753. package/docs/api/interfaces/RalphLoopState.html +21 -21
  754. package/docs/api/interfaces/RecoveryConfig.html +16 -16
  755. package/docs/api/interfaces/RecoveryMessageData.html +4 -4
  756. package/docs/api/interfaces/RecoveryResult.html +10 -10
  757. package/docs/api/interfaces/RecoveryStoredMessageMeta.html +8 -8
  758. package/docs/api/interfaces/RecoveryStoredReasoningPart.html +7 -7
  759. package/docs/api/interfaces/RecoveryStoredTextPart.html +9 -9
  760. package/docs/api/interfaces/RecoveryStoredToolPart.html +9 -9
  761. package/docs/api/interfaces/RegisterContextOptions.html +12 -12
  762. package/docs/api/interfaces/ReleaseInfo.html +9 -9
  763. package/docs/api/interfaces/ResolveDelegationOptions.html +7 -7
  764. package/docs/api/interfaces/ResolveOptions.html +6 -6
  765. package/docs/api/interfaces/ResolvedModel.html +5 -5
  766. package/docs/api/interfaces/RetryState.html +6 -6
  767. package/docs/api/interfaces/RuleFileCandidate.html +12 -12
  768. package/docs/api/interfaces/RuleFrontmatterResult.html +6 -6
  769. package/docs/api/interfaces/RuleInfo.html +18 -18
  770. package/docs/api/interfaces/RuleMetadata.html +9 -9
  771. package/docs/api/interfaces/RuleToInject.html +10 -10
  772. package/docs/api/interfaces/SessionEndHookOutput.html +2 -2
  773. package/docs/api/interfaces/SessionEndInput.html +9 -9
  774. package/docs/api/interfaces/SessionMetrics.html +9 -9
  775. package/docs/api/interfaces/SessionState.html +5 -5
  776. package/docs/api/interfaces/SetupHookOutput.html +3 -3
  777. package/docs/api/interfaces/SetupInput.html +7 -7
  778. package/docs/api/interfaces/SetupResult.html +5 -5
  779. package/docs/api/interfaces/ShellHook.html +4 -4
  780. package/docs/api/interfaces/SisyphusOptions.html +14 -14
  781. package/docs/api/interfaces/SisyphusSession.html +16 -16
  782. package/docs/api/interfaces/SkillExtractionRequest.html +12 -12
  783. package/docs/api/interfaces/SkillFileCandidate.html +10 -10
  784. package/docs/api/interfaces/SkillHookContext.html +5 -5
  785. package/docs/api/interfaces/SkillMetadata.html +22 -22
  786. package/docs/api/interfaces/SkillParseResult.html +5 -5
  787. package/docs/api/interfaces/SubagentHookOutput.html +3 -3
  788. package/docs/api/interfaces/SubagentInfo.html +14 -14
  789. package/docs/api/interfaces/SubagentStartInput.html +10 -10
  790. package/docs/api/interfaces/SubagentStopInput.html +11 -11
  791. package/docs/api/interfaces/SubagentTrackingState.html +6 -6
  792. package/docs/api/interfaces/TaskExecutionDecision.html +10 -10
  793. package/docs/api/interfaces/TechStack.html +5 -5
  794. package/docs/api/interfaces/ThinkModeInput.html +4 -4
  795. package/docs/api/interfaces/ThinkModeState.html +12 -12
  796. package/docs/api/interfaces/ThinkingValidatorMessageInfo.html +6 -6
  797. package/docs/api/interfaces/ThinkingValidatorMessagePart.html +9 -9
  798. package/docs/api/interfaces/ThinkingValidatorMessageWithParts.html +4 -4
  799. package/docs/api/interfaces/TodoContinuationHook.html +2 -2
  800. package/docs/api/interfaces/TransitionResult.html +4 -4
  801. package/docs/api/interfaces/TruncateState.html +6 -6
  802. package/docs/api/interfaces/UltraQAOptions.html +5 -5
  803. package/docs/api/interfaces/UltraQAResult.html +9 -9
  804. package/docs/api/interfaces/UltraQAState.html +19 -19
  805. package/docs/api/interfaces/UltrapilotConfig.html +14 -14
  806. package/docs/api/interfaces/UltrapilotState.html +26 -26
  807. package/docs/api/interfaces/UltraworkState.html +17 -17
  808. package/docs/api/interfaces/UpdateCheckResult.html +7 -7
  809. package/docs/api/interfaces/UpdateResult.html +7 -7
  810. package/docs/api/interfaces/UserDirective.html +7 -7
  811. package/docs/api/interfaces/UserStory.html +15 -15
  812. package/docs/api/interfaces/ValidationCoordinatorResult.html +6 -6
  813. package/docs/api/interfaces/ValidationResult.html +10 -10
  814. package/docs/api/interfaces/VerificationState.html +17 -17
  815. package/docs/api/interfaces/VersionMetadata.html +12 -12
  816. package/docs/api/interfaces/WorkerState.html +24 -24
  817. package/docs/api/interfaces/WriteSkillResult.html +6 -6
  818. package/docs/api/media/EVOLUTION.md +132 -62
  819. package/docs/api/media/INSTALL.md +105 -35
  820. package/docs/api/media/MIGRATION.md +340 -168
  821. package/docs/api/media/NEXUS.md +79 -43
  822. package/docs/api/media/REFERENCE.md +182 -104
  823. package/docs/api/media/mcp-server-usage.md +24 -11
  824. package/docs/api/modules.html +1 -1
  825. package/docs/api/types/AgentCategory.html +2 -2
  826. package/docs/api/types/AgentCost.html +3 -3
  827. package/docs/api/types/AgentFactory.html +2 -2
  828. package/docs/api/types/AgentOverrides.html +2 -2
  829. package/docs/api/types/AutopilotPhase.html +2 -2
  830. package/docs/api/types/AutopilotSignal.html +2 -2
  831. package/docs/api/types/CommandScope.html +2 -2
  832. package/docs/api/types/ContextPriority.html +3 -3
  833. package/docs/api/types/ContextSourceType.html +3 -3
  834. package/docs/api/types/DelegationProvider.html +2 -2
  835. package/docs/api/types/DelegationTool.html +2 -2
  836. package/docs/api/types/ExecutionMode.html +3 -3
  837. package/docs/api/types/ExternalModelProvider.html +2 -2
  838. package/docs/api/types/GateType.html +3 -3
  839. package/docs/api/types/InjectionStrategy.html +2 -2
  840. package/docs/api/types/KeywordType.html +10 -10
  841. package/docs/api/types/ModelType.html +2 -2
  842. package/docs/api/types/QAStatus.html +2 -2
  843. package/docs/api/types/RecoveryErrorType.html +2 -2
  844. package/docs/api/types/RecoveryStoredPart.html +2 -2
  845. package/docs/api/types/TaskTool.html +1 -1
  846. package/docs/api/types/ThinkingConfig.html +2 -2
  847. package/docs/api/types/UltraQAGoalType.html +1 -1
  848. package/docs/api/types/UserStoryInput.html +2 -2
  849. package/docs/api/types/ValidationVerdict.html +2 -2
  850. package/docs/api/types/ValidationVerdictType.html +2 -2
  851. package/docs/api/variables/AGENTS_DIR.html +1 -1
  852. package/docs/api/variables/AGENTS_FILENAME.html +2 -2
  853. package/docs/api/variables/AGENT_TOOLS.html +2 -2
  854. package/docs/api/variables/ALLOWED_PATH_PREFIX.html +2 -2
  855. package/docs/api/variables/ANALYST_PROMPT_METADATA.html +1 -1
  856. package/docs/api/variables/ARCHITECT_PROMPT_METADATA.html +1 -1
  857. package/docs/api/variables/AUTO_SLASH_COMMAND_HOOK_NAME.html +4 -4
  858. package/docs/api/variables/AUTO_SLASH_COMMAND_TAG_CLOSE.html +1 -1
  859. package/docs/api/variables/AUTO_SLASH_COMMAND_TAG_OPEN.html +2 -2
  860. package/docs/api/variables/BACKGROUND_NOTIFICATION_HOOK_NAME.html +2 -2
  861. package/docs/api/variables/BDD_KEYWORDS.html +2 -2
  862. package/docs/api/variables/BEADS_INSTRUCTIONS.html +1 -1
  863. package/docs/api/variables/BEADS_RUST_INSTRUCTIONS.html +1 -1
  864. package/docs/api/variables/BLOCKING_PATTERNS.html +3 -3
  865. package/docs/api/variables/BOULDER_CONTINUATION_PROMPT.html +2 -2
  866. package/docs/api/variables/BOULDER_DIR.html +2 -2
  867. package/docs/api/variables/BOULDER_FILE.html +2 -2
  868. package/docs/api/variables/BOULDER_STATE_PATH.html +2 -2
  869. package/docs/api/variables/CHARS_PER_TOKEN.html +2 -2
  870. package/docs/api/variables/CI_COMMANDS.html +2 -2
  871. package/docs/api/variables/CI_GATE_MESSAGE.html +1 -1
  872. package/docs/api/variables/CLAUDE_CONFIG_DIR.html +2 -2
  873. package/docs/api/variables/CLAUDE_DEFAULT_CONTEXT_LIMIT.html +2 -2
  874. package/docs/api/variables/COMMANDS_DIR.html +1 -1
  875. package/docs/api/variables/COMMENT_CHECKER_MESSAGE_HEADER.html +2 -2
  876. package/docs/api/variables/COMPACTION_COOLDOWN_MS.html +2 -2
  877. package/docs/api/variables/CONTENT_PART_TYPES.html +2 -2
  878. package/docs/api/variables/CONTEXT_CRITICAL_MESSAGE.html +2 -2
  879. package/docs/api/variables/CONTEXT_FILENAMES.html +2 -2
  880. package/docs/api/variables/CONTEXT_LIMIT_RECOVERY_MESSAGE.html +2 -2
  881. package/docs/api/variables/CONTEXT_LIMIT_SHORT_MESSAGE.html +2 -2
  882. package/docs/api/variables/CONTEXT_WARNING_MESSAGE.html +2 -2
  883. package/docs/api/variables/CRITICAL_THRESHOLD.html +2 -2
  884. package/docs/api/variables/CRITIC_PROMPT_METADATA.html +1 -1
  885. package/docs/api/variables/DEFAULT_CONFIG.html +2 -2
  886. package/docs/api/variables/DEFAULT_MAX_BACKGROUND_TASKS.html +2 -2
  887. package/docs/api/variables/DEFAULT_THINKING_CONTENT.html +2 -2
  888. package/docs/api/variables/DIRECT_WORK_REMINDER.html +2 -2
  889. package/docs/api/variables/DOCUMENT_SPECIALIST_PROMPT_METADATA.html +1 -1
  890. package/docs/api/variables/DOCUMENT_WRITER_PROMPT_METADATA.html +1 -1
  891. package/docs/api/variables/EDIT_ERROR_PATTERNS.html +2 -2
  892. package/docs/api/variables/EDIT_ERROR_REMINDER.html +3 -3
  893. package/docs/api/variables/EMPTY_MESSAGE_SANITIZER_DEBUG_PREFIX.html +2 -2
  894. package/docs/api/variables/EMPTY_MESSAGE_SANITIZER_ERROR_PATTERNS.html +2 -2
  895. package/docs/api/variables/EMPTY_MESSAGE_SANITIZER_HOOK_NAME.html +2 -2
  896. package/docs/api/variables/ENTRY_SEPARATOR.html +1 -1
  897. package/docs/api/variables/EXCLUDED_COMMANDS.html +3 -3
  898. package/docs/api/variables/EXPERT_GATE_MESSAGE.html +1 -1
  899. package/docs/api/variables/EXPLORE_PROMPT_METADATA.html +1 -1
  900. package/docs/api/variables/EXTENSION_TO_LANGUAGE.html +2 -2
  901. package/docs/api/variables/FEATURE_FLAG_KEY.html +2 -2
  902. package/docs/api/variables/FRONTEND_ENGINEER_PROMPT_METADATA.html +1 -1
  903. package/docs/api/variables/GITHUB_API_URL.html +1 -1
  904. package/docs/api/variables/INSTALLER_CLAUDE_CONFIG_DIR.html +2 -2
  905. package/docs/api/variables/INSTALLER_VERSION.html +2 -2
  906. package/docs/api/variables/LINE_COMMENT_PATTERNS.html +2 -2
  907. package/docs/api/variables/LONG_RUNNING_PATTERNS.html +3 -3
  908. package/docs/api/variables/MANUAL_HEADER.html +1 -1
  909. package/docs/api/variables/MAX_SKILLS_PER_SESSION.html +2 -2
  910. package/docs/api/variables/MAX_SKILL_CONTENT_LENGTH.html +2 -2
  911. package/docs/api/variables/MAX_WARNINGS.html +2 -2
  912. package/docs/api/variables/MIN_QUALITY_SCORE.html +2 -2
  913. package/docs/api/variables/MODE_CONFIGS.html +4 -4
  914. package/docs/api/variables/MULTIMODAL_LOOKER_PROMPT_METADATA.html +1 -1
  915. package/docs/api/variables/NON_EMPTY_CONTENT_RECOVERY_MESSAGE.html +2 -2
  916. package/docs/api/variables/NON_INTERACTIVE_ENV.html +1 -1
  917. package/docs/api/variables/NON_INTERACTIVE_ENV_HOOK_NAME.html +1 -1
  918. package/docs/api/variables/NOTEPAD_BASE_PATH.html +2 -2
  919. package/docs/api/variables/NOTEPAD_DEFAULT_CONFIG.html +1 -1
  920. package/docs/api/variables/NOTEPAD_DIR.html +2 -2
  921. package/docs/api/variables/NOTEPAD_FILENAME.html +1 -1
  922. package/docs/api/variables/OMC_ORCHESTRATOR_HOOK_NAME.html +4 -4
  923. package/docs/api/variables/ORCHESTRATOR_DELEGATION_REQUIRED.html +2 -2
  924. package/docs/api/variables/PATTERNS_HEADER.html +1 -1
  925. package/docs/api/variables/PLACEHOLDER_TEXT.html +3 -3
  926. package/docs/api/variables/PLANNER_PLANS_DIR.html +2 -2
  927. package/docs/api/variables/PLANNER_PROMPT_METADATA.html +1 -1
  928. package/docs/api/variables/PLAN_EXTENSION.html +2 -2
  929. package/docs/api/variables/PRD_EXAMPLE_FILENAME.html +1 -1
  930. package/docs/api/variables/PRD_FILENAME.html +1 -1
  931. package/docs/api/variables/PREEMPTIVE_DEFAULT_THRESHOLD.html +2 -2
  932. package/docs/api/variables/PREVENTED_ERROR.html +2 -2
  933. package/docs/api/variables/PRIORITY_HEADER.html +1 -1
  934. package/docs/api/variables/PROGRESS_FILENAME.html +1 -1
  935. package/docs/api/variables/PROJECT_MARKERS.html +2 -2
  936. package/docs/api/variables/PROJECT_RULE_FILES.html +2 -2
  937. package/docs/api/variables/PROJECT_RULE_SUBDIRS.html +2 -2
  938. package/docs/api/variables/PROJECT_SKILLS_SUBDIR.html +2 -2
  939. package/docs/api/variables/RAPID_FIRE_DEBOUNCE_MS.html +7 -7
  940. package/docs/api/variables/README_FILENAME.html +2 -2
  941. package/docs/api/variables/README_INJECTOR_STORAGE.html +1 -1
  942. package/docs/api/variables/README_TRACKED_TOOLS.html +2 -2
  943. package/docs/api/variables/RECOVERY_FAILED_MESSAGE.html +2 -2
  944. package/docs/api/variables/RECOVERY_MESSAGES.html +2 -2
  945. package/docs/api/variables/RECOVERY_PLACEHOLDER_TEXT.html +2 -2
  946. package/docs/api/variables/REMINDER_MESSAGE.html +2 -2
  947. package/docs/api/variables/REPO_NAME.html +1 -1
  948. package/docs/api/variables/REPO_OWNER.html +2 -2
  949. package/docs/api/variables/RETRY_CONFIG.html +6 -6
  950. package/docs/api/variables/RULES_INJECTOR_STORAGE.html +1 -1
  951. package/docs/api/variables/RULE_EXTENSIONS.html +2 -2
  952. package/docs/api/variables/SHELL_COMMAND_PATTERNS.html +3 -3
  953. package/docs/api/variables/SINGLE_TASK_DIRECTIVE.html +2 -2
  954. package/docs/api/variables/SISYPHUS_JUNIOR_PROMPT_METADATA.html +1 -1
  955. package/docs/api/variables/SKILL_EXTENSION.html +2 -2
  956. package/docs/api/variables/SLASH_COMMAND_PATTERN.html +2 -2
  957. package/docs/api/variables/STALE_STATE_MAX_AGE_MS.html +2 -2
  958. package/docs/api/variables/SYNTHETIC_THINKING_ID_PREFIX.html +2 -2
  959. package/docs/api/variables/TARGET_TOOLS.html +2 -2
  960. package/docs/api/variables/THINKING_BLOCK_VALIDATOR_HOOK_NAME.html +2 -2
  961. package/docs/api/variables/THINKING_CONFIGS.html +2 -2
  962. package/docs/api/variables/THINKING_MODEL_PATTERNS.html +3 -3
  963. package/docs/api/variables/THINKING_PART_TYPES.html +2 -2
  964. package/docs/api/variables/TOKEN_LIMIT_KEYWORDS.html +2 -2
  965. package/docs/api/variables/TOKEN_LIMIT_PATTERNS.html +2 -2
  966. package/docs/api/variables/TOOL_PART_TYPES.html +2 -2
  967. package/docs/api/variables/TRACKED_TOOLS.html +2 -2
  968. package/docs/api/variables/TRUNCATE_CONFIG.html +6 -6
  969. package/docs/api/variables/TRUNCATION_APPLIED_MESSAGE.html +2 -2
  970. package/docs/api/variables/TYPE_CHECKER_PREFIXES.html +2 -2
  971. package/docs/api/variables/ULTRAPILOT_DEFAULT_CONFIG.html +2 -2
  972. package/docs/api/variables/USER_GATE_MESSAGE.html +1 -1
  973. package/docs/api/variables/USER_RULE_DIR.html +2 -2
  974. package/docs/api/variables/USER_SKILLS_DIR.html +2 -2
  975. package/docs/api/variables/VERIFICATION_REMINDER.html +2 -2
  976. package/docs/api/variables/VERSION_FILE.html +1 -1
  977. package/docs/api/variables/WORKING_MEMORY_HEADER.html +1 -1
  978. package/docs/api/variables/WRITE_EDIT_TOOLS.html +2 -2
  979. package/docs/api/variables/allCustomTools.html +3 -3
  980. package/docs/api/variables/analystAgent.html +1 -1
  981. package/docs/api/variables/architectAgent.html +1 -1
  982. package/docs/api/variables/astTools.html +2 -2
  983. package/docs/api/variables/contextCollector.html +2 -2
  984. package/docs/api/variables/criticAgent.html +1 -1
  985. package/docs/api/variables/designerAgent.html +1 -1
  986. package/docs/api/variables/executorAgent.html +1 -1
  987. package/docs/api/variables/exploreAgent.html +1 -1
  988. package/docs/api/variables/lspTools.html +2 -2
  989. package/docs/api/variables/nonInteractiveEnvHook.html +8 -8
  990. package/docs/api/variables/omcSystemPrompt.html +2 -2
  991. package/docs/api/variables/omcToolNames.html +3 -3
  992. package/docs/api/variables/omcToolsServer.html +4 -4
  993. package/docs/api/variables/plannerAgent.html +1 -1
  994. package/docs/api/variables/researcherAgent.html +1 -1
  995. package/docs/api/variables/visionAgent.html +1 -1
  996. package/docs/api/variables/writerAgent.html +1 -1
  997. package/docs/ccg-workflow/API.md +290 -130
  998. package/docs/ccg-workflow/BEST_PRACTICES.md +265 -124
  999. package/docs/ccg-workflow/README.md +29 -17
  1000. package/docs/ccg-workflow/TROUBLESHOOTING.md +120 -63
  1001. package/docs/ccg-workflow/VALIDATION_GUIDE.md +104 -46
  1002. package/docs/design/AGENTS.md +8 -4
  1003. package/docs/design/delegation-enforcer-integration.md +10 -8
  1004. package/docs/design/project-session-manager.md +82 -29
  1005. package/docs/dev-standards/context-collection.md +9 -2
  1006. package/docs/dev-standards/context-summary-template.md +48 -24
  1007. package/docs/dev-standards/dev-standards.md +28 -14
  1008. package/docs/dev-standards/quality-review.md +24 -13
  1009. package/docs/dev-standards/sufficiency-checklist.md +35 -14
  1010. package/docs/dev-standards/tools-integration.md +34 -15
  1011. package/docs/dev-standards/workflow.md +9 -3
  1012. package/docs/getting-started/concepts.md +27 -14
  1013. package/docs/getting-started/installation.md +25 -8
  1014. package/docs/getting-started/quickstart.md +17 -8
  1015. package/docs/guides/mcp-server-usage.md +24 -11
  1016. package/docs/guides/task-templates-guide.md +50 -25
  1017. package/docs/guides/tool-name-migration.md +67 -34
  1018. package/docs/guides/troubleshooting-guide.md +66 -32
  1019. package/docs/guides/v5.5.13-new-features.md +66 -31
  1020. package/docs/guides/wizard-user-guide.md +27 -15
  1021. package/docs/guides/workflow-recommendation-guide.md +22 -11
  1022. package/docs/issues/AGENTS.md +4 -2
  1023. package/docs/mcp/README.md +31 -18
  1024. package/docs/mcp/client-guide.md +37 -19
  1025. package/docs/mcp/configuration.md +27 -11
  1026. package/docs/mcp/overview.md +70 -36
  1027. package/docs/mcp/performance.md +23 -14
  1028. package/docs/mcp/server-guide.md +9 -4
  1029. package/docs/mcp-compatibility-matrix.md +36 -18
  1030. package/docs/partials/AGENTS.md +4 -2
  1031. package/docs/partials/agent-tiers.md +27 -17
  1032. package/docs/partials/features.md +37 -21
  1033. package/docs/partials/mode-hierarchy.md +19 -10
  1034. package/docs/partials/mode-selection-guide.md +20 -10
  1035. package/docs/partials/verification-tiers.md +36 -20
  1036. package/docs/plans/2025-11-22-opencode-support-design.md +37 -25
  1037. package/docs/plans/2025-11-22-opencode-support-implementation.md +93 -49
  1038. package/docs/plans/2025-11-28-skills-improvements-from-user-feedback.md +195 -104
  1039. package/docs/plans/2026-01-17-visual-brainstorming.md +48 -32
  1040. package/docs/plans/2026-02-24-axiom-integration-design.md +121 -67
  1041. package/docs/plans/2026-02-24-axiom-integration-plan.md +383 -191
  1042. package/docs/plans/2026-02-24-superpowers-ultrapower-integration-design.md +210 -98
  1043. package/docs/plans/2026-02-24-superpowers-ultrapower-integration-plan.md +251 -124
  1044. package/docs/plans/2026-02-24-ultrapower-integration-design.md +9 -6
  1045. package/docs/plans/2026-02-26-nexus-design.md +64 -38
  1046. package/docs/plans/2026-02-26-nexus-implementation-plan.md +171 -98
  1047. package/docs/plans/2026-02-26-phase2-active-learning-design.md +83 -44
  1048. package/docs/plans/2026-02-27-release-cicd-pipeline-design.md +30 -19
  1049. package/docs/plans/2026-02-27-release-cicd-pipeline-impl.md +27 -16
  1050. package/docs/plans/2026-02-28-nexus-self-evolution.md +30 -17
  1051. package/docs/plans/2026-03-02-docs-comprehensive-update-design.md +106 -34
  1052. package/docs/plans/2026-03-02-docs-comprehensive-update.md +265 -133
  1053. package/docs/plans/2026-03-05-mcp-adoption-atomic-tasks.md +409 -180
  1054. package/docs/plans/2026-03-05-mcp-adoption-plan.md +278 -130
  1055. package/docs/plans/AGENTS.md +6 -3
  1056. package/docs/plans/axiom-migration-plan.md +127 -62
  1057. package/docs/prd/AGENTS.md +6 -3
  1058. package/docs/prd/documentation-system-draft.md +141 -71
  1059. package/docs/prd/documentation-system-rough.md +330 -171
  1060. package/docs/prd/memory-evolution-optimize-rough.md +199 -124
  1061. package/docs/prd/user_guide-rough.md +403 -200
  1062. package/docs/reviews/AGENTS.md +4 -2
  1063. package/docs/reviews/documentation-system/review_critic.md +129 -58
  1064. package/docs/reviews/documentation-system/review_domain.md +222 -104
  1065. package/docs/reviews/documentation-system/review_product.md +61 -27
  1066. package/docs/reviews/documentation-system/review_tech.md +86 -38
  1067. package/docs/reviews/documentation-system/review_ux.md +70 -35
  1068. package/docs/reviews/documentation-system/summary.md +94 -47
  1069. package/docs/reviews/draft-prd-agent-observability/review_critic.md +21 -17
  1070. package/docs/reviews/draft-prd-agent-observability/review_domain.md +61 -33
  1071. package/docs/reviews/draft-prd-agent-observability/review_product.md +19 -12
  1072. package/docs/reviews/draft-prd-agent-observability/review_tech.md +26 -15
  1073. package/docs/reviews/draft-prd-agent-observability/review_ux.md +16 -12
  1074. package/docs/reviews/draft-prd-agent-observability/rough_prd.md +64 -34
  1075. package/docs/reviews/draft-prd-memory-evolution-optimize/review_critic.md +72 -43
  1076. package/docs/reviews/draft-prd-memory-evolution-optimize/review_domain.md +45 -25
  1077. package/docs/reviews/draft-prd-memory-evolution-optimize/review_product.md +5 -3
  1078. package/docs/reviews/draft-prd-memory-evolution-optimize/review_tech.md +112 -61
  1079. package/docs/reviews/draft-prd-memory-evolution-optimize/review_ux.md +1 -1
  1080. package/docs/reviews/draft-prd-three-directions/review_product.md +49 -26
  1081. package/docs/reviews/draft-prd-three-directions/review_tech.md +58 -34
  1082. package/docs/reviews/draft-prd-three-directions/review_ux.md +83 -42
  1083. package/docs/reviews/memory-evolution-optimize/summary.md +37 -22
  1084. package/docs/reviews/ultrapower-pain-points/review_critic.md +95 -48
  1085. package/docs/reviews/ultrapower-pain-points/review_ux.md +8 -7
  1086. package/docs/reviews/ultrapower-security/review_critic.md +187 -91
  1087. package/docs/reviews/ultrapower-standards/AGENTS.md +8 -4
  1088. package/docs/reviews/ultrapower-standards/review_critic.md +62 -39
  1089. package/docs/reviews/ultrapower-standards/review_domain.md +23 -14
  1090. package/docs/reviews/ultrapower-standards/review_product.md +16 -9
  1091. package/docs/reviews/ultrapower-standards/review_tech.md +47 -27
  1092. package/docs/reviews/ultrapower-standards/review_ux.md +45 -26
  1093. package/docs/reviews/ultrapower-standards/summary.md +54 -30
  1094. package/docs/reviews/ultrapower-tech-review/review_tech.md +61 -34
  1095. package/docs/reviews/user_guide/summary.md +44 -24
  1096. package/docs/shared/AGENTS.md +4 -2
  1097. package/docs/shared/agent-tiers.md +27 -17
  1098. package/docs/shared/features.md +37 -21
  1099. package/docs/shared/mode-hierarchy.md +19 -10
  1100. package/docs/shared/mode-selection-guide.md +20 -10
  1101. package/docs/shared/verification-tiers.md +36 -20
  1102. package/docs/standards/AGENTS.md +9 -5
  1103. package/docs/standards/README.md +17 -13
  1104. package/docs/standards/agent-lifecycle.md +46 -32
  1105. package/docs/standards/anti-patterns.md +2 -2
  1106. package/docs/standards/audit-report.md +75 -42
  1107. package/docs/standards/contribution-guide.md +74 -36
  1108. package/docs/standards/hook-execution-order.md +26 -16
  1109. package/docs/standards/release-process.md +9 -5
  1110. package/docs/standards/runtime-protection.md +57 -36
  1111. package/docs/standards/state-machine.md +15 -15
  1112. package/docs/standards/templates/AGENTS.md +8 -4
  1113. package/docs/standards/templates/agent-template.md +6 -4
  1114. package/docs/standards/templates/hook-template.md +7 -5
  1115. package/docs/standards/templates/skill-template.md +1 -1
  1116. package/docs/standards/testing-guide.md +6 -4
  1117. package/docs/standards/user-guide.md +27 -19
  1118. package/docs/superpowers/AGENTS.md +6 -3
  1119. package/docs/superpowers/plans/2026-01-22-document-review-system.md +46 -34
  1120. package/docs/superpowers/plans/2026-02-19-visual-brainstorming-refactor.md +71 -59
  1121. package/docs/superpowers/plans/AGENTS.md +8 -4
  1122. package/docs/superpowers/specs/2026-01-22-document-review-system-design.md +36 -19
  1123. package/docs/superpowers/specs/2026-02-19-visual-brainstorming-refactor-design.md +95 -49
  1124. package/docs/superpowers/specs/AGENTS.md +8 -4
  1125. package/docs/tasks/AGENTS.md +4 -2
  1126. package/docs/tasks/documentation-system/implementation-plan.md +86 -38
  1127. package/docs/tasks/documentation-system/manifest.md +328 -172
  1128. package/docs/tasks/memory-evolution-optimize/manifest.md +148 -84
  1129. package/docs/tasks/ultrapower-standards/AGENTS.md +10 -5
  1130. package/docs/tasks/ultrapower-standards/manifest.md +137 -71
  1131. package/docs/tasks/user_guide/manifest.md +185 -94
  1132. package/docs/testing.md +29 -11
  1133. package/docs/troubleshooting/agent-timeouts.md +14 -6
  1134. package/docs/troubleshooting/common-errors.md +4 -0
  1135. package/docs/troubleshooting/hook-failures.md +12 -6
  1136. package/docs/troubleshooting/performance-issues.md +24 -12
  1137. package/docs/troubleshooting/tool-name-length-error.md +1 -1
  1138. package/docs/troubleshooting.md +215 -47
  1139. package/docs/windows/AGENTS.md +6 -3
  1140. package/docs/windows/polyglot-hooks.md +43 -19
  1141. package/hooks/AGENTS.md +9 -5
  1142. package/hooks/run-hook.cmd +0 -0
  1143. package/hooks/session-start +0 -0
  1144. package/package.json +1 -1
  1145. package/scripts/AGENTS.md +28 -14
  1146. package/scripts/fix-agent-headers.py +58 -0
  1147. package/scripts/fix-blank-lines.py +19 -0
  1148. package/scripts/fix-long-lines.py +41 -0
  1149. package/scripts/fix-markdown-lint.mjs +48 -0
  1150. package/scripts/hooks/AGENTS.md +8 -4
  1151. package/scripts/lib/AGENTS.md +6 -3
  1152. package/scripts/persistent-mode.cjs +605 -605
  1153. package/skills/AGENTS.md +23 -17
  1154. package/skills/analyze/AGENTS.md +12 -6
  1155. package/skills/analyze/SKILL.md +53 -27
  1156. package/skills/autopilot/AGENTS.md +12 -6
  1157. package/skills/autopilot/SKILL.md +66 -35
  1158. package/skills/ax-analyze-error/AGENTS.md +12 -6
  1159. package/skills/ax-analyze-error/SKILL.md +9 -6
  1160. package/skills/ax-context/AGENTS.md +12 -6
  1161. package/skills/ax-context/SKILL.md +8 -2
  1162. package/skills/ax-decompose/AGENTS.md +12 -6
  1163. package/skills/ax-decompose/SKILL.md +19 -11
  1164. package/skills/ax-draft/AGENTS.md +12 -6
  1165. package/skills/ax-draft/SKILL.md +14 -8
  1166. package/skills/ax-evolution/AGENTS.md +12 -6
  1167. package/skills/ax-evolution/SKILL.md +16 -5
  1168. package/skills/ax-evolve/AGENTS.md +12 -6
  1169. package/skills/ax-evolve/SKILL.md +19 -10
  1170. package/skills/ax-export/AGENTS.md +12 -6
  1171. package/skills/ax-export/SKILL.md +50 -18
  1172. package/skills/ax-implement/AGENTS.md +12 -6
  1173. package/skills/ax-implement/SKILL.md +8 -5
  1174. package/skills/ax-knowledge/AGENTS.md +17 -10
  1175. package/skills/ax-knowledge/SKILL.md +54 -27
  1176. package/skills/ax-reflect/AGENTS.md +12 -6
  1177. package/skills/ax-reflect/SKILL.md +28 -14
  1178. package/skills/ax-review/AGENTS.md +12 -6
  1179. package/skills/ax-review/SKILL.md +14 -7
  1180. package/skills/ax-rollback/AGENTS.md +12 -6
  1181. package/skills/ax-rollback/SKILL.md +12 -5
  1182. package/skills/ax-status/AGENTS.md +12 -6
  1183. package/skills/ax-status/SKILL.md +55 -26
  1184. package/skills/ax-suspend/AGENTS.md +12 -6
  1185. package/skills/ax-suspend/SKILL.md +15 -7
  1186. package/skills/brainstorming/AGENTS.md +12 -6
  1187. package/skills/brainstorming/SKILL.md +66 -36
  1188. package/skills/brainstorming/spec-document-reviewer-prompt.md +1 -1
  1189. package/skills/brainstorming/visual-companion.md +57 -32
  1190. package/skills/build-fix/AGENTS.md +12 -6
  1191. package/skills/build-fix/SKILL.md +40 -22
  1192. package/skills/cancel/AGENTS.md +12 -6
  1193. package/skills/cancel/SKILL.md +102 -51
  1194. package/skills/ccg/AGENTS.md +12 -6
  1195. package/skills/ccg/SKILL.md +44 -24
  1196. package/skills/ccg-workflow/SKILL.md +8 -3
  1197. package/skills/code-review/AGENTS.md +12 -6
  1198. package/skills/code-review/SKILL.md +100 -52
  1199. package/skills/configure-discord/AGENTS.md +12 -6
  1200. package/skills/configure-discord/SKILL.md +11 -5
  1201. package/skills/configure-telegram/AGENTS.md +12 -6
  1202. package/skills/configure-telegram/SKILL.md +23 -11
  1203. package/skills/deepinit/AGENTS.md +12 -6
  1204. package/skills/deepinit/SKILL.md +118 -55
  1205. package/skills/deepsearch/AGENTS.md +12 -6
  1206. package/skills/deepsearch/SKILL.md +9 -6
  1207. package/skills/dispatching-parallel-agents/AGENTS.md +12 -6
  1208. package/skills/dispatching-parallel-agents/SKILL.md +64 -32
  1209. package/skills/executing-plans/AGENTS.md +12 -6
  1210. package/skills/executing-plans/SKILL.md +78 -37
  1211. package/skills/external-context/AGENTS.md +12 -6
  1212. package/skills/external-context/SKILL.md +25 -10
  1213. package/skills/finishing-a-development-branch/AGENTS.md +12 -6
  1214. package/skills/finishing-a-development-branch/SKILL.md +69 -28
  1215. package/skills/frontend-ui-ux/AGENTS.md +12 -6
  1216. package/skills/frontend-ui-ux/SKILL.md +16 -7
  1217. package/skills/git-master/AGENTS.md +12 -6
  1218. package/skills/git-master/SKILL.md +10 -5
  1219. package/skills/hud/AGENTS.md +12 -6
  1220. package/skills/hud/SKILL.md +32 -21
  1221. package/skills/learn-about-omc/AGENTS.md +12 -6
  1222. package/skills/learn-about-omc/SKILL.md +2 -2
  1223. package/skills/learner/AGENTS.md +12 -6
  1224. package/skills/learner/SKILL.md +77 -39
  1225. package/skills/mcp-setup/AGENTS.md +12 -6
  1226. package/skills/mcp-setup/SKILL.md +120 -49
  1227. package/skills/next-step-router/AGENTS.md +12 -6
  1228. package/skills/next-step-router/SKILL.md +61 -36
  1229. package/skills/nexus/AGENTS.md +11 -6
  1230. package/skills/nexus/SKILL.md +8 -5
  1231. package/skills/nexus/nexus-evolve/AGENTS.md +12 -6
  1232. package/skills/nexus/nexus-review/AGENTS.md +12 -6
  1233. package/skills/nexus/nexus-review/SKILL.md +1 -1
  1234. package/skills/nexus/nexus-status/AGENTS.md +12 -6
  1235. package/skills/note/AGENTS.md +12 -6
  1236. package/skills/note/SKILL.md +23 -12
  1237. package/skills/omc-doctor/AGENTS.md +12 -6
  1238. package/skills/omc-doctor/SKILL.md +86 -32
  1239. package/skills/omc-help/AGENTS.md +12 -6
  1240. package/skills/omc-help/SKILL.md +39 -20
  1241. package/skills/omc-setup/AGENTS.md +12 -6
  1242. package/skills/omc-setup/SKILL.md +169 -91
  1243. package/skills/pipeline/AGENTS.md +12 -6
  1244. package/skills/pipeline/SKILL.md +36 -14
  1245. package/skills/plan/AGENTS.md +12 -6
  1246. package/skills/plan/SKILL.md +95 -51
  1247. package/skills/project-session-manager/AGENTS.md +12 -6
  1248. package/skills/project-session-manager/SKILL.md +76 -50
  1249. package/skills/project-session-manager/lib/AGENTS.md +11 -6
  1250. package/skills/project-session-manager/lib/providers/AGENTS.md +8 -4
  1251. package/skills/project-session-manager/templates/AGENTS.md +8 -4
  1252. package/skills/project-session-manager/templates/feature.md +21 -11
  1253. package/skills/project-session-manager/templates/issue-fix.md +23 -12
  1254. package/skills/project-session-manager/templates/pr-review.md +22 -12
  1255. package/skills/psm/AGENTS.md +12 -6
  1256. package/skills/ralph/AGENTS.md +12 -6
  1257. package/skills/ralph/SKILL.md +86 -45
  1258. package/skills/ralph-init/AGENTS.md +12 -6
  1259. package/skills/ralph-init/SKILL.md +1 -1
  1260. package/skills/ralplan/AGENTS.md +12 -6
  1261. package/skills/receiving-code-review/AGENTS.md +12 -6
  1262. package/skills/receiving-code-review/SKILL.md +50 -25
  1263. package/skills/release/AGENTS.md +12 -6
  1264. package/skills/release/SKILL.md +95 -30
  1265. package/skills/requesting-code-review/AGENTS.md +12 -6
  1266. package/skills/requesting-code-review/SKILL.md +64 -32
  1267. package/skills/requesting-code-review/code-reviewer.md +89 -41
  1268. package/skills/review/AGENTS.md +12 -6
  1269. package/skills/sciomc/AGENTS.md +12 -6
  1270. package/skills/sciomc/SKILL.md +86 -46
  1271. package/skills/security-review/AGENTS.md +12 -6
  1272. package/skills/security-review/SKILL.md +115 -61
  1273. package/skills/skill/AGENTS.md +12 -6
  1274. package/skills/skill/SKILL.md +93 -49
  1275. package/skills/subagent-driven-development/AGENTS.md +12 -6
  1276. package/skills/subagent-driven-development/SKILL.md +114 -58
  1277. package/skills/swarm/AGENTS.md +12 -6
  1278. package/skills/systematic-debugging/AGENTS.md +12 -6
  1279. package/skills/systematic-debugging/CREATION-LOG.md +84 -42
  1280. package/skills/systematic-debugging/SKILL.md +128 -73
  1281. package/skills/systematic-debugging/condition-based-waiting.md +21 -11
  1282. package/skills/systematic-debugging/defense-in-depth.md +29 -13
  1283. package/skills/systematic-debugging/find-polluter.sh +0 -0
  1284. package/skills/systematic-debugging/root-cause-tracing.md +41 -18
  1285. package/skills/systematic-debugging/test-pressure-1.md +38 -19
  1286. package/skills/systematic-debugging/test-pressure-2.md +50 -25
  1287. package/skills/systematic-debugging/test-pressure-3.md +52 -26
  1288. package/skills/team/AGENTS.md +12 -6
  1289. package/skills/team/SKILL.md +139 -89
  1290. package/skills/test-driven-development/AGENTS.md +12 -6
  1291. package/skills/test-driven-development/SKILL.md +129 -67
  1292. package/skills/test-driven-development/testing-anti-patterns.md +54 -28
  1293. package/skills/trace/AGENTS.md +12 -6
  1294. package/skills/trace/SKILL.md +14 -7
  1295. package/skills/ultrapilot/AGENTS.md +12 -6
  1296. package/skills/ultrapilot/SKILL.md +98 -51
  1297. package/skills/ultraqa/AGENTS.md +12 -6
  1298. package/skills/ultraqa/SKILL.md +8 -6
  1299. package/skills/ultrawork/AGENTS.md +12 -6
  1300. package/skills/ultrawork/SKILL.md +57 -30
  1301. package/skills/using-git-worktrees/AGENTS.md +12 -6
  1302. package/skills/using-git-worktrees/SKILL.md +63 -28
  1303. package/skills/using-superpowers/AGENTS.md +12 -6
  1304. package/skills/using-superpowers/SKILL.md +13 -7
  1305. package/skills/using-superpowers/references/AGENTS.md +8 -4
  1306. package/skills/using-superpowers/references/codex-tools.md +1 -1
  1307. package/skills/verification-before-completion/AGENTS.md +12 -6
  1308. package/skills/verification-before-completion/SKILL.md +54 -29
  1309. package/skills/wizard/AGENTS.md +12 -6
  1310. package/skills/wizard/SKILL.md +27 -15
  1311. package/skills/writer-memory/AGENTS.md +12 -6
  1312. package/skills/writer-memory/SKILL.md +73 -42
  1313. package/skills/writer-memory/lib/AGENTS.md +8 -4
  1314. package/skills/writer-memory/templates/AGENTS.md +10 -5
  1315. package/skills/writing-plans/AGENTS.md +12 -6
  1316. package/skills/writing-plans/SKILL.md +57 -28
  1317. package/skills/writing-plans/plan-document-reviewer-prompt.md +1 -1
  1318. package/skills/writing-skills/AGENTS.md +12 -6
  1319. package/skills/writing-skills/SKILL.md +301 -134
  1320. package/skills/writing-skills/anthropic-best-practices.md +155 -37
  1321. package/skills/writing-skills/examples/AGENTS.md +8 -4
  1322. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +37 -15
  1323. package/skills/writing-skills/graphviz-conventions.dot +171 -171
  1324. package/skills/writing-skills/persuasion-principles.md +124 -59
  1325. package/skills/writing-skills/render-graphs.js +0 -0
  1326. package/skills/writing-skills/testing-skills-with-subagents.md +119 -62
  1327. package/templates/AGENTS.md +12 -8
  1328. package/templates/axiom/AGENTS.md +7 -4
  1329. package/templates/axiom/dag-analysis.md +1 -1
  1330. package/templates/axiom/scripts/AGENTS.md +6 -3
  1331. package/templates/axiom/scripts/Check-Memory.ps1 +68 -68
  1332. package/templates/axiom/scripts/Poll-Memory.ps1 +36 -36
  1333. package/templates/axiom/scripts/README.md +7 -4
  1334. package/templates/axiom/scripts/Watch-Memory.ps1 +149 -149
  1335. package/templates/axiom/scripts/agent-runner.ps1 +101 -101
  1336. package/templates/axiom/scripts/start-reviews.ps1 +19 -19
  1337. package/templates/axiom/task-execution.md +10 -6
  1338. package/templates/hooks/AGENTS.md +9 -5
  1339. package/templates/hooks/lib/AGENTS.md +4 -2
  1340. package/templates/rules/AGENTS.md +8 -4
  1341. package/templates/rules/README.md +5 -1
  1342. package/templates/rules/axiom-gatekeepers.md +26 -16
  1343. package/templates/rules/axiom-provider-router.md +12 -7
  1344. package/templates/rules/axiom-router.md +8 -5
  1345. package/templates/rules/coding-style.md +30 -15
  1346. package/templates/rules/git-workflow.md +13 -7
  1347. package/templates/rules/performance.md +38 -19
  1348. package/templates/rules/security.md +24 -12
  1349. package/templates/rules/testing.md +25 -13
  1350. package/templates/tasks/README.md +15 -4
  1351. package/templates/tasks/bug-fix.md +48 -24
  1352. package/templates/tasks/code-review.md +46 -23
  1353. package/templates/tasks/feature-development.md +56 -28
  1354. package/templates/tasks/refactoring.md +48 -24
  1355. package/templates/tasks/security-audit.md +48 -24
@@ -30,7 +30,7 @@ description: 创建新 skill、编辑现有 skill 或在部署前验证 skill
30
30
  ## TDD 与 Skill 的映射
31
31
 
32
32
  | TDD 概念 | Skill 创建 |
33
- |----------|-----------|
33
+ | ---------- | ----------- |
34
34
  | **测试用例** | 带 subagent 的压力场景 |
35
35
  | **生产代码** | Skill 文档(SKILL.md) |
36
36
  | **测试失败(RED)** | Agent 在没有 skill 时违反规则(基线) |
@@ -47,26 +47,37 @@ description: 创建新 skill、编辑现有 skill 或在部署前验证 skill
47
47
  ## 何时创建 Skill
48
48
 
49
49
  **创建时机:**
50
- - 技术对你来说不是直觉上显而易见的
51
- - 你会在多个项目中再次引用
52
- - 模式广泛适用(非项目特定)
53
- - 他人会受益
50
+
51
+ * 技术对你来说不是直觉上显而易见的
52
+
53
+ * 你会在多个项目中再次引用
54
+
55
+ * 模式广泛适用(非项目特定)
56
+
57
+ * 他人会受益
54
58
 
55
59
  **不要创建:**
56
- - 一次性解决方案
57
- - 其他地方有充分文档的标准实践
58
- - 项目特定约定(放在 CLAUDE.md 中)
59
- - 机械约束(如果可以用 regex/验证强制执行,就自动化——将文档留给判断调用)
60
+
61
+ * 一次性解决方案
62
+
63
+ * 其他地方有充分文档的标准实践
64
+
65
+ * 项目特定约定(放在 CLAUDE.md 中)
66
+
67
+ * 机械约束(如果可以用 regex/验证强制执行,就自动化——将文档留给判断调用)
60
68
 
61
69
  ## Skill 类型
62
70
 
63
71
  ### 技术(Technique)
72
+
64
73
  有步骤可遵循的具体方法(condition-based-waiting、root-cause-tracing)
65
74
 
66
75
  ### 模式(Pattern)
76
+
67
77
  思考问题的方式(flatten-with-flags、test-invariants)
68
78
 
69
79
  ### 参考(Reference)
80
+
70
81
  API 文档、语法指南、工具文档(office docs)
71
82
 
72
83
  ## 目录结构
@@ -85,17 +96,24 @@ skills/
85
96
  2. **可复用工具** - 脚本、工具、模板
86
97
 
87
98
  **内联保留:**
88
- - 原则和概念
89
- - 代码模式(< 50 行)
90
- - 其他所有内容
99
+
100
+ * 原则和概念
101
+
102
+ * 代码模式(< 50 行)
103
+
104
+ * 其他所有内容
91
105
 
92
106
  ## SKILL.md 结构
93
107
 
94
108
  **Frontmatter(YAML):**
95
- - 仅支持两个字段:`name` 和 `description`
96
- - 最多 1024 个字符
97
- - `name`:仅使用字母、数字和连字符(无括号、特殊字符)
98
- - `description`:第三人称,仅描述何时使用(不描述功能)
109
+
110
+ * 仅支持两个字段:`name` `description`
111
+
112
+ * 最多 1024 个字符
113
+
114
+ * `name`:仅使用字母、数字和连字符(无括号、特殊字符)
115
+
116
+ * `description`:第三人称,仅描述何时使用(不描述功能)
99
117
  - 以"Use when..."开头,聚焦于触发条件
100
118
  - 包含具体症状、情况和上下文
101
119
  - **绝不总结 skill 的流程或工作流**(参见 CSO 部分了解原因)
@@ -110,28 +128,35 @@ description: Use when [specific triggering conditions and symptoms]
110
128
  # Skill Name
111
129
 
112
130
  ## Overview
131
+
113
132
  这是什么?1-2 句话的核心原则。
114
133
 
115
134
  ## When to Use
135
+
116
136
  [如果决策不明显,添加小型内联流程图]
117
137
 
118
138
  带症状和用例的项目符号列表
119
139
  何时不使用
120
140
 
121
141
  ## Core Pattern(用于技术/模式)
142
+
122
143
  前后代码对比
123
144
 
124
145
  ## Quick Reference
146
+
125
147
  用于扫描常见操作的表格或项目符号
126
148
 
127
149
  ## Implementation
150
+
128
151
  简单模式的内联代码
129
152
  重型参考或可复用工具链接到文件
130
153
 
131
154
  ## Common Mistakes
155
+
132
156
  出错原因 + 修复
133
157
 
134
158
  ## Real-World Impact(可选)
159
+
135
160
  具体结果
136
161
  ```
137
162
 
@@ -156,132 +181,183 @@ description: Use when [specific triggering conditions and symptoms]
156
181
  **陷阱:** 总结工作流的描述为 Claude 创造了捷径。Skill 正文变成了 Claude 跳过的文档。
157
182
 
158
183
  ```yaml
184
+
159
185
  # 差:总结工作流 - Claude 可能遵循此而不读 skill
186
+
160
187
  description: Use when executing plans - dispatches subagent per task with code review between tasks
161
188
 
162
189
  # 差:流程细节过多
190
+
163
191
  description: Use for TDD - write test first, watch it fail, write minimal code, refactor
164
192
 
165
193
  # 好:仅触发条件,无工作流摘要
194
+
166
195
  description: Use when executing implementation plans with independent tasks in the current session
167
196
 
168
197
  # 好:仅触发条件
198
+
169
199
  description: Use when implementing any feature or bugfix, before writing implementation code
170
200
  ```
171
201
 
172
202
  **内容:**
173
- - 使用具体的触发器、症状和情况来表明此 skill 适用
174
- - 描述*问题*(竞态条件、不一致行为)而非*语言特定症状*(setTimeout、sleep)
175
- - 除非 skill 本身是技术特定的,否则保持触发器与技术无关
176
- - 如果 skill 是技术特定的,在触发器中明确说明
177
- - 以第三人称写作(注入到系统提示中)
178
- - **绝不总结 skill 的流程或工作流**
203
+
204
+ * 使用具体的触发器、症状和情况来表明此 skill 适用
205
+
206
+ * 描述*问题*(竞态条件、不一致行为)而非*语言特定症状*(setTimeout、sleep)
207
+
208
+ * 除非 skill 本身是技术特定的,否则保持触发器与技术无关
209
+
210
+ * 如果 skill 是技术特定的,在触发器中明确说明
211
+
212
+ * 以第三人称写作(注入到系统提示中)
213
+
214
+ * **绝不总结 skill 的流程或工作流**
179
215
 
180
216
  ```yaml
217
+
181
218
  # 差:太抽象,模糊,不包含何时使用
219
+
182
220
  description: For async testing
183
221
 
184
222
  # 差:第一人称
223
+
185
224
  description: I can help you with async tests when they're flaky
186
225
 
187
226
  # 差:提到技术但 skill 不特定于它
227
+
188
228
  description: Use when tests use setTimeout/sleep and are flaky
189
229
 
190
230
  # 好:以"Use when"开头,描述问题,无工作流
231
+
191
232
  description: Use when tests have race conditions, timing dependencies, or pass/fail inconsistently
192
233
 
193
234
  # 好:带明确触发器的技术特定 skill
235
+
194
236
  description: Use when using React Router and handling authentication redirects
195
237
  ```
196
238
 
197
239
  ### 2. 关键词覆盖
198
240
 
199
241
  使用 Claude 会搜索的词:
200
- - 错误消息:"Hook timed out"、"ENOTEMPTY"、"race condition"
201
- - 症状:"flaky"、"hanging"、"zombie"、"pollution"
202
- - 同义词:"timeout/hang/freeze"、"cleanup/teardown/afterEach"
203
- - 工具:实际命令、库名、文件类型
242
+
243
+ * 错误消息:"Hook timed out"、"ENOTEMPTY"、"race condition"
244
+
245
+ * 症状:"flaky"、"hanging"、"zombie"、"pollution"
246
+
247
+ * 同义词:"timeout/hang/freeze"、"cleanup/teardown/afterEach"
248
+
249
+ * 工具:实际命令、库名、文件类型
204
250
 
205
251
  ### 3. 描述性命名
206
252
 
207
253
  **使用主动语态,动词优先:**
208
- - `creating-skills` 而非 `skill-creation`
209
- - `condition-based-waiting` 而非 `async-test-helpers`
254
+
255
+ * `creating-skills` 而非 `skill-creation`
256
+
257
+ * `condition-based-waiting` 而非 `async-test-helpers`
210
258
 
211
259
  ### 4. Token 效率(关键)
212
260
 
213
261
  **问题:** getting-started 和频繁引用的 skill 会加载到每次对话中。每个 token 都很重要。
214
262
 
215
263
  **目标字数:**
216
- - getting-started 工作流:每个 <150 词
217
- - 频繁加载的 skill:总计 <200
218
- - 其他 skill:<500 词(仍要简洁)
264
+
265
+ * getting-started 工作流:每个 <150
266
+
267
+ * 频繁加载的 skill:总计 <200 词
268
+
269
+ * 其他 skill:<500 词(仍要简洁)
219
270
 
220
271
  **技术:**
221
272
 
222
273
  **将细节移至工具帮助:**
223
274
  ```bash
275
+
224
276
  # 差:在 SKILL.md 中记录所有标志
277
+
225
278
  search-conversations supports --text, --both, --after DATE, --before DATE, --limit N
226
279
 
227
280
  # 好:引用 --help
281
+
228
282
  search-conversations supports multiple modes and filters. Run --help for details.
229
283
  ```
230
284
 
231
285
  **使用交叉引用:**
232
286
  ```markdown
287
+
233
288
  # 差:重复工作流细节
289
+
234
290
  When searching, dispatch subagent with template...
235
291
  [20 行重复指令]
236
292
 
237
293
  # 好:引用其他 skill
294
+
238
295
  Always use subagents (50-100x context savings). REQUIRED: Use [other-skill-name] for workflow.
239
296
  ```
240
297
 
241
298
  **压缩示例:**
242
299
  ```markdown
300
+
243
301
  # 差:冗长示例(42 词)
302
+
244
303
  your human partner: "How did we handle authentication errors in React Router before?"
245
304
  You: I'll search past conversations for React Router authentication patterns.
246
305
  [Dispatch subagent with search query: "React Router authentication error handling 401"]
247
306
 
248
307
  # 好:最小示例(20 词)
308
+
249
309
  Partner: "How did we handle auth errors in React Router?"
250
310
  You: Searching...
251
311
  [Dispatch subagent → synthesis]
252
312
  ```
253
313
 
254
314
  **消除冗余:**
255
- - 不要重复交叉引用 skill 中的内容
256
- - 不要解释命令中显而易见的内容
257
- - 不要包含同一模式的多个示例
315
+
316
+ * 不要重复交叉引用 skill 中的内容
317
+
318
+ * 不要解释命令中显而易见的内容
319
+
320
+ * 不要包含同一模式的多个示例
258
321
 
259
322
  **验证:**
260
323
  ```bash
261
324
  wc -w skills/path/SKILL.md
325
+
262
326
  # getting-started 工作流:目标 <150 每个
327
+
263
328
  # 其他频繁加载:目标 <200 总计
329
+
264
330
  ```
265
331
 
266
332
  **按你做什么或核心洞察命名:**
267
- - `condition-based-waiting` > `async-test-helpers`
268
- - `using-skills` 而非 `skill-usage`
269
- - `flatten-with-flags` > `data-structure-refactoring`
270
- - `root-cause-tracing` > `debugging-techniques`
333
+
334
+ * `condition-based-waiting` > `async-test-helpers`
335
+
336
+ * `using-skills` 而非 `skill-usage`
337
+
338
+ * `flatten-with-flags` > `data-structure-refactoring`
339
+
340
+ * `root-cause-tracing` > `debugging-techniques`
271
341
 
272
342
  **动名词(-ing)适合流程:**
273
- - `creating-skills`、`testing-skills`、`debugging-with-logs`
274
- - 主动,描述你正在采取的行动
343
+
344
+ * `creating-skills`、`testing-skills`、`debugging-with-logs`
345
+
346
+ * 主动,描述你正在采取的行动
275
347
 
276
348
  ### 4. 交叉引用其他 Skill
277
349
 
278
350
  **编写引用其他 skill 的文档时:**
279
351
 
280
352
  仅使用 skill 名称,带明确的要求标记:
281
- - 好:`**REQUIRED SUB-SKILL:** Use ultrapower:test-driven-development`
282
- - 好:`**REQUIRED BACKGROUND:** You MUST understand ultrapower:systematic-debugging`
283
- - 差:`See skills/testing/test-driven-development`(不清楚是否必需)
284
- - 差:`@skills/testing/test-driven-development/SKILL.md`(强制加载,消耗上下文)
353
+
354
+ * 好:`**REQUIRED SUB-SKILL:** Use ultrapower:test-driven-development`
355
+
356
+ * 好:`**REQUIRED BACKGROUND:** You MUST understand ultrapower:systematic-debugging`
357
+
358
+ * 差:`See skills/testing/test-driven-development`(不清楚是否必需)
359
+
360
+ * 差:`@skills/testing/test-driven-development/SKILL.md`(强制加载,消耗上下文)
285
361
 
286
362
  **为何不用 @ 链接:** `@` 语法立即强制加载文件,在你需要之前消耗 200k+ 上下文。
287
363
 
@@ -301,15 +377,22 @@ digraph when_flowchart {
301
377
  ```
302
378
 
303
379
  **仅在以下情况使用流程图:**
304
- - 非显而易见的决策点
305
- - 可能过早停止的流程循环
306
- - "何时使用 A vs B"的决策
380
+
381
+ * 非显而易见的决策点
382
+
383
+ * 可能过早停止的流程循环
384
+
385
+ * "何时使用 A vs B"的决策
307
386
 
308
387
  **绝不用流程图表示:**
309
- - 参考材料 → 表格、列表
310
- - 代码示例Markdown 块
311
- - 线性指令 → 编号列表
312
- - 没有语义含义的标签(step1、helper2)
388
+
389
+ * 参考材料表格、列表
390
+
391
+ * 代码示例 → Markdown 块
392
+
393
+ * 线性指令 → 编号列表
394
+
395
+ * 没有语义含义的标签(step1、helper2)
313
396
 
314
397
  参见 @graphviz-conventions.dot 了解 graphviz 样式规则。
315
398
 
@@ -324,27 +407,39 @@ digraph when_flowchart {
324
407
  **一个优秀的示例胜过许多平庸的示例**
325
408
 
326
409
  选择最相关的语言:
327
- - 测试技术 → TypeScript/JavaScript
328
- - 系统调试Shell/Python
329
- - 数据处理 → Python
410
+
411
+ * 测试技术TypeScript/JavaScript
412
+
413
+ * 系统调试 → Shell/Python
414
+
415
+ * 数据处理 → Python
330
416
 
331
417
  **好的示例:**
332
- - 完整且可运行
333
- - 注释充分,解释为什么
334
- - 来自真实场景
335
- - 清晰展示模式
336
- - 可直接适配(非通用模板)
418
+
419
+ * 完整且可运行
420
+
421
+ * 注释充分,解释为什么
422
+
423
+ * 来自真实场景
424
+
425
+ * 清晰展示模式
426
+
427
+ * 可直接适配(非通用模板)
337
428
 
338
429
  **不要:**
339
- - 用 5+ 种语言实现
340
- - 创建填空模板
341
- - 编写人为示例
430
+
431
+ * 用 5+ 种语言实现
432
+
433
+ * 创建填空模板
434
+
435
+ * 编写人为示例
342
436
 
343
437
  你擅长移植——一个优秀的示例就足够了。
344
438
 
345
439
  ## 文件组织
346
440
 
347
441
  ### 自包含 Skill
442
+
348
443
  ```
349
444
  defense-in-depth/
350
445
  SKILL.md # 所有内容内联
@@ -352,6 +447,7 @@ defense-in-depth/
352
447
  适用时机:所有内容适合,不需要重型参考
353
448
 
354
449
  ### 带可复用工具的 Skill
450
+
355
451
  ```
356
452
  condition-based-waiting/
357
453
  SKILL.md # 概述 + 模式
@@ -360,6 +456,7 @@ condition-based-waiting/
360
456
  适用时机:工具是可复用代码,而非仅叙述
361
457
 
362
458
  ### 带重型参考的 Skill
459
+
363
460
  ```
364
461
  pptx/
365
462
  SKILL.md # 概述 + 工作流
@@ -381,12 +478,18 @@ NO SKILL WITHOUT A FAILING TEST FIRST
381
478
  不测试就编辑 skill?同样违规。
382
479
 
383
480
  **无例外:**
384
- - 不适用于"简单添加"
385
- - 不适用于"只是添加一个部分"
386
- - 不适用于"文档更新"
387
- - 不要将未测试的更改保留为"参考"
388
- - 不要在运行测试时"适配"
389
- - 删除意味着删除
481
+
482
+ * 不适用于"简单添加"
483
+
484
+ * 不适用于"只是添加一个部分"
485
+
486
+ * 不适用于"文档更新"
487
+
488
+ * 不要将未测试的更改保留为"参考"
489
+
490
+ * 不要在运行测试时"适配"
491
+
492
+ * 删除意味着删除
390
493
 
391
494
  **必需背景:** ultrapower:test-driven-development skill 解释了为何重要。同样的原则适用于文档。
392
495
 
@@ -399,10 +502,14 @@ NO SKILL WITHOUT A FAILING TEST FIRST
399
502
  **示例:** TDD、verification-before-completion、designing-before-coding
400
503
 
401
504
  **测试方式:**
402
- - 学术问题:他们理解规则吗?
403
- - 压力场景:在压力下他们遵从吗?
404
- - 多重压力组合:时间 + 沉没成本 + 疲惫
405
- - 识别理由并添加明确的反驳
505
+
506
+ * 学术问题:他们理解规则吗?
507
+
508
+ * 压力场景:在压力下他们遵从吗?
509
+
510
+ * 多重压力组合:时间 + 沉没成本 + 疲惫
511
+
512
+ * 识别理由并添加明确的反驳
406
513
 
407
514
  **成功标准:** Agent 在最大压力下遵循规则
408
515
 
@@ -411,9 +518,12 @@ NO SKILL WITHOUT A FAILING TEST FIRST
411
518
  **示例:** condition-based-waiting、root-cause-tracing、defensive-programming
412
519
 
413
520
  **测试方式:**
414
- - 应用场景:他们能正确应用技术吗?
415
- - 变体场景:他们处理边缘情况吗?
416
- - 缺失信息测试:指令有空白吗?
521
+
522
+ * 应用场景:他们能正确应用技术吗?
523
+
524
+ * 变体场景:他们处理边缘情况吗?
525
+
526
+ * 缺失信息测试:指令有空白吗?
417
527
 
418
528
  **成功标准:** Agent 成功将技术应用于新场景
419
529
 
@@ -422,9 +532,12 @@ NO SKILL WITHOUT A FAILING TEST FIRST
422
532
  **示例:** reducing-complexity、information-hiding 概念
423
533
 
424
534
  **测试方式:**
425
- - 识别场景:他们能识别模式何时适用吗?
426
- - 应用场景:他们能使用心智模型吗?
427
- - 反例:他们知道何时不应用吗?
535
+
536
+ * 识别场景:他们能识别模式何时适用吗?
537
+
538
+ * 应用场景:他们能使用心智模型吗?
539
+
540
+ * 反例:他们知道何时不应用吗?
428
541
 
429
542
  **成功标准:** Agent 正确识别何时/如何应用模式
430
543
 
@@ -433,16 +546,19 @@ NO SKILL WITHOUT A FAILING TEST FIRST
433
546
  **示例:** API 文档、命令参考、库指南
434
547
 
435
548
  **测试方式:**
436
- - 检索场景:他们能找到正确信息吗?
437
- - 应用场景:他们能正确使用找到的内容吗?
438
- - 空白测试:常见用例是否涵盖?
549
+
550
+ * 检索场景:他们能找到正确信息吗?
551
+
552
+ * 应用场景:他们能正确使用找到的内容吗?
553
+
554
+ * 空白测试:常见用例是否涵盖?
439
555
 
440
556
  **成功标准:** Agent 找到并正确应用参考信息
441
557
 
442
558
  ## 跳过测试的常见理由
443
559
 
444
560
  | 借口 | 现实 |
445
- |------|------|
561
+ | ------ | ------ |
446
562
  | "Skill 显然很清晰" | 对你清晰 ≠ 对其他 agent 清晰。测试它。 |
447
563
  | "只是参考" | 参考可能有空白、不清晰的部分。测试检索。 |
448
564
  | "测试是过度杀伤" | 未测试的 skill 有问题。始终如此。15 分钟测试节省数小时。 |
@@ -474,10 +590,14 @@ Write code before test? Delete it.
474
590
  Write code before test? Delete it. Start over.
475
591
 
476
592
  **No exceptions:**
477
- - Don't keep it as "reference"
478
- - Don't "adapt" it while writing tests
479
- - Don't look at it
480
- - Delete means delete
593
+
594
+ * Don't keep it as "reference"
595
+
596
+ * Don't "adapt" it while writing tests
597
+
598
+ * Don't look at it
599
+
600
+ * Delete means delete
481
601
  ```
482
602
 
483
603
  ### 处理"精神 vs 字面"争论
@@ -496,7 +616,7 @@ Write code before test? Delete it. Start over.
496
616
 
497
617
  ```markdown
498
618
  | Excuse | Reality |
499
- |--------|---------|
619
+ | -------- | --------- |
500
620
  | "Too simple to test" | Simple code breaks. Test takes 30 seconds. |
501
621
  | "I'll test after" | Tests passing immediately prove nothing. |
502
622
  | "Tests after achieve same goals" | Tests-after = "what does this do?" Tests-first = "what should this do?" |
@@ -507,13 +627,18 @@ Write code before test? Delete it. Start over.
507
627
  让 agent 在理由化时容易自我检查:
508
628
 
509
629
  ```markdown
630
+
510
631
  ## Red Flags - STOP and Start Over
511
632
 
512
- - Code before test
513
- - "I already manually tested it"
514
- - "Tests after achieve the same purpose"
515
- - "It's about spirit not ritual"
516
- - "This is different because..."
633
+ * Code before test
634
+
635
+ * "I already manually tested it"
636
+
637
+ * "Tests after achieve the same purpose"
638
+
639
+ * "It's about spirit not ritual"
640
+
641
+ * "This is different because..."
517
642
 
518
643
  **All of these mean: Delete code. Start over with TDD.**
519
644
  ```
@@ -533,9 +658,12 @@ description: use when implementing any feature or bugfix, before writing impleme
533
658
  ### RED:编写失败测试(基线)
534
659
 
535
660
  在没有 skill 的情况下运行带 subagent 的压力场景。记录确切行为:
536
- - 他们做了什么选择?
537
- - 他们使用了什么理由(逐字)?
538
- - 哪些压力触发了违规?
661
+
662
+ * 他们做了什么选择?
663
+
664
+ * 他们使用了什么理由(逐字)?
665
+
666
+ * 哪些压力触发了违规?
539
667
 
540
668
  这是"观察测试失败"——你必须在编写 skill 之前看到 agent 自然会做什么。
541
669
 
@@ -550,22 +678,29 @@ description: use when implementing any feature or bugfix, before writing impleme
550
678
  Agent 找到新的理由化?添加明确的反驳。重新测试直到无懈可击。
551
679
 
552
680
  **测试方法:** 参见 @testing-skills-with-subagents.md 了解完整测试方法:
553
- - 如何编写压力场景
554
- - 压力类型(时间、沉没成本、权威、疲惫)
555
- - 系统地堵住漏洞
556
- - 元测试技术
681
+
682
+ * 如何编写压力场景
683
+
684
+ * 压力类型(时间、沉没成本、权威、疲惫)
685
+
686
+ * 系统地堵住漏洞
687
+
688
+ * 元测试技术
557
689
 
558
690
  ## 反模式
559
691
 
560
692
  ### 叙述示例
693
+
561
694
  "在 2025-10-03 的 session 中,我们发现空的 projectDir 导致..."
562
695
  **为何差:** 太具体,不可复用
563
696
 
564
697
  ### 多语言稀释
698
+
565
699
  example-js.js、example-py.py、example-go.go
566
700
  **为何差:** 质量平庸,维护负担
567
701
 
568
702
  ### 流程图中的代码
703
+
569
704
  ```dot
570
705
  step1 [label="import fs"];
571
706
  step2 [label="read file"];
@@ -573,6 +708,7 @@ step2 [label="read file"];
573
708
  **为何差:** 无法复制粘贴,难以阅读
574
709
 
575
710
  ### 通用标签
711
+
576
712
  helper1、helper2、step3、pattern4
577
713
  **为何差:** 标签应有语义含义
578
714
 
@@ -581,9 +717,12 @@ helper1、helper2、step3、pattern4
581
717
  **编写任何 skill 后,你必须停下并完成部署流程。**
582
718
 
583
719
  **不要:**
584
- - 批量创建多个 skill 而不逐一测试
585
- - 在当前 skill 验证之前进入下一个
586
- - 以"批量更高效"为由跳过测试
720
+
721
+ * 批量创建多个 skill 而不逐一测试
722
+
723
+ * 在当前 skill 验证之前进入下一个
724
+
725
+ * 以"批量更高效"为由跳过测试
587
726
 
588
727
  **下方的部署清单对每个 skill 都是强制性的。**
589
728
 
@@ -594,49 +733,74 @@ helper1、helper2、step3、pattern4
594
733
  **重要:使用 TodoWrite 为下方每个清单项创建 todo。**
595
734
 
596
735
  **RED 阶段 - 编写失败测试:**
597
- - [ ] 创建压力场景(纪律型 skill 需要 3+ 个组合压力)
598
- - [ ] 在没有 skill 的情况下运行场景——逐字记录基线行为
599
- - [ ] 识别理由化/失败中的模式
736
+
737
+ * [ ] 创建压力场景(纪律型 skill 需要 3+ 个组合压力)
738
+
739
+ * [ ] 在没有 skill 的情况下运行场景——逐字记录基线行为
740
+
741
+ * [ ] 识别理由化/失败中的模式
600
742
 
601
743
  **GREEN 阶段 - 编写最小 Skill:**
602
- - [ ] 名称仅使用字母、数字、连字符(无括号/特殊字符)
603
- - [ ] YAML frontmatter 仅含 name 和 description(最多 1024 字符)
604
- - [ ] 描述以"Use when..."开头,包含具体触发器/症状
605
- - [ ] 描述以第三人称写作
606
- - [ ] 全文包含搜索关键词(错误、症状、工具)
607
- - [ ] 清晰的概述,含核心原则
608
- - [ ] 针对 RED 阶段识别的具体失败
609
- - [ ] 代码内联或链接到单独文件
610
- - [ ] 一个优秀示例(非多语言)
611
- - [ ] 在有 skill 的情况下运行场景——验证 agent 现在遵从
744
+
745
+ * [ ] 名称仅使用字母、数字、连字符(无括号/特殊字符)
746
+
747
+ * [ ] YAML frontmatter 仅含 name 和 description(最多 1024 字符)
748
+
749
+ * [ ] 描述以"Use when..."开头,包含具体触发器/症状
750
+
751
+ * [ ] 描述以第三人称写作
752
+
753
+ * [ ] 全文包含搜索关键词(错误、症状、工具)
754
+
755
+ * [ ] 清晰的概述,含核心原则
756
+
757
+ * [ ] 针对 RED 阶段识别的具体失败
758
+
759
+ * [ ] 代码内联或链接到单独文件
760
+
761
+ * [ ] 一个优秀示例(非多语言)
762
+
763
+ * [ ] 在有 skill 的情况下运行场景——验证 agent 现在遵从
612
764
 
613
765
  **REFACTOR 阶段 - 堵住漏洞:**
614
- - [ ] 从测试中识别新的理由化
615
- - [ ] 添加明确的反驳(如果是纪律型 skill)
616
- - [ ] 从所有测试迭代构建理由化表格
617
- - [ ] 创建红旗列表
618
- - [ ] 重新测试直到无懈可击
766
+
767
+ * [ ] 从测试中识别新的理由化
768
+
769
+ * [ ] 添加明确的反驳(如果是纪律型 skill)
770
+
771
+ * [ ] 从所有测试迭代构建理由化表格
772
+
773
+ * [ ] 创建红旗列表
774
+
775
+ * [ ] 重新测试直到无懈可击
619
776
 
620
777
  **质量检查:**
621
- - [ ] 仅在决策不明显时使用小型流程图
622
- - [ ] 快速参考表格
623
- - [ ] 常见错误部分
624
- - [ ] 无叙述性故事
625
- - [ ] 仅工具或重型参考使用支持文件
778
+
779
+ * [ ] 仅在决策不明显时使用小型流程图
780
+
781
+ * [ ] 快速参考表格
782
+
783
+ * [ ] 常见错误部分
784
+
785
+ * [ ] 无叙述性故事
786
+
787
+ * [ ] 仅工具或重型参考使用支持文件
626
788
 
627
789
  **部署:**
628
- - [ ] 将 skill 提交到 git 并推送到你的 fork(如果已配置)
629
- - [ ] 考虑通过 PR 贡献回来(如果广泛有用)
790
+
791
+ * [ ] skill 提交到 git 并推送到你的 fork(如果已配置)
792
+
793
+ * [ ] 考虑通过 PR 贡献回来(如果广泛有用)
630
794
 
631
795
  ## 发现工作流
632
796
 
633
797
  未来的 Claude 如何找到你的 skill:
634
798
 
635
799
  1. **遇到问题**("tests are flaky")
636
- 3. **找到 SKILL**(描述匹配)
637
- 4. **扫描概述**(这相关吗?)
638
- 5. **阅读模式**(快速参考表格)
639
- 6. **加载示例**(仅在实现时)
800
+ 2. **找到 SKILL**(描述匹配)
801
+ 3. **扫描概述**(这相关吗?)
802
+ 4. **阅读模式**(快速参考表格)
803
+ 5. **加载示例**(仅在实现时)
640
804
 
641
805
  **为此流程优化** - 早且频繁地放置可搜索的术语。
642
806
 
@@ -653,6 +817,9 @@ helper1、helper2、step3、pattern4
653
817
  ## 路由触发
654
818
 
655
819
  skill 压力测试通过后调用 `next-step-router`:
656
- - current_skill: "writing-skills"
657
- - stage: "stress_test_passed"
658
- - output_summary: 测试的 skill 名称、通过的测试场景数
820
+
821
+ * current_skill: "writing-skills"
822
+
823
+ * stage: "stress_test_passed"
824
+
825
+ * output_summary: 测试的 skill 名称、通过的测试场景数