@liangjie559567/ultrapower 5.5.15 → 5.5.16
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.
- package/bridge/mcp-server.cjs +4 -4
- package/dist/tools/memory-tools.js +4 -4
- package/dist/tools/memory-tools.js.map +1 -1
- package/docs/README.md +110 -0
- package/docs/api/.gitkeep +0 -0
- package/docs/features/.gitkeep +0 -0
- package/docs/getting-started/.gitkeep +0 -0
- package/docs/getting-started/concepts.md +103 -0
- package/docs/getting-started/installation.md +100 -0
- package/docs/getting-started/quickstart.md +96 -0
- package/docs/guides/.gitkeep +0 -0
- package/docs/prd/documentation-system-draft.md +227 -0
- package/docs/prd/documentation-system-rough.md +515 -0
- package/docs/reviews/documentation-system/review_critic.md +312 -0
- package/docs/reviews/documentation-system/review_domain.md +390 -0
- package/docs/reviews/documentation-system/review_product.md +151 -0
- package/docs/reviews/documentation-system/review_tech.md +236 -0
- package/docs/reviews/documentation-system/review_ux.md +213 -0
- package/docs/reviews/documentation-system/summary.md +149 -0
- package/docs/tasks/documentation-system/implementation-plan.md +292 -0
- package/docs/tasks/documentation-system/manifest.md +425 -0
- package/package.json +1 -1
package/bridge/mcp-server.cjs
CHANGED
|
@@ -23117,7 +23117,7 @@ async function addCustomNote(projectRoot, category, content) {
|
|
|
23117
23117
|
|
|
23118
23118
|
// src/tools/memory-tools.ts
|
|
23119
23119
|
var projectMemoryReadTool = {
|
|
23120
|
-
name: "
|
|
23120
|
+
name: "mem_read",
|
|
23121
23121
|
description: "Read the project memory. Can read the full memory or a specific section.",
|
|
23122
23122
|
schema: {
|
|
23123
23123
|
section: external_exports.enum(["all", "techStack", "build", "conventions", "structure", "notes", "directives"]).optional().describe("Section to read (default: all)"),
|
|
@@ -23184,7 +23184,7 @@ ${JSON.stringify(data, null, 2)}
|
|
|
23184
23184
|
}
|
|
23185
23185
|
};
|
|
23186
23186
|
var projectMemoryWriteTool = {
|
|
23187
|
-
name: "
|
|
23187
|
+
name: "mem_write",
|
|
23188
23188
|
description: "Write/update project memory. Can replace entirely or merge with existing memory.",
|
|
23189
23189
|
schema: {
|
|
23190
23190
|
memory: external_exports.record(external_exports.string(), external_exports.unknown()).describe("The memory object to write"),
|
|
@@ -23229,7 +23229,7 @@ Path: ${getWorktreeProjectMemoryPath(root)}`
|
|
|
23229
23229
|
}
|
|
23230
23230
|
};
|
|
23231
23231
|
var projectMemoryAddNoteTool = {
|
|
23232
|
-
name: "
|
|
23232
|
+
name: "mem_add_note",
|
|
23233
23233
|
description: "Add a custom note to project memory. Notes are categorized and persisted across sessions.",
|
|
23234
23234
|
schema: {
|
|
23235
23235
|
category: external_exports.string().max(50).describe('Note category (e.g., "build", "test", "deploy", "env", "architecture")'),
|
|
@@ -23270,7 +23270,7 @@ var projectMemoryAddNoteTool = {
|
|
|
23270
23270
|
}
|
|
23271
23271
|
};
|
|
23272
23272
|
var projectMemoryAddDirectiveTool = {
|
|
23273
|
-
name: "
|
|
23273
|
+
name: "mem_add_directive",
|
|
23274
23274
|
description: "Add a user directive to project memory. Directives are instructions that persist across sessions and survive compaction.",
|
|
23275
23275
|
schema: {
|
|
23276
23276
|
directive: external_exports.string().max(500).describe('The directive (e.g., "Always use TypeScript strict mode")'),
|
|
@@ -10,7 +10,7 @@ import { loadProjectMemory, saveProjectMemory, addCustomNote, addDirective, } fr
|
|
|
10
10
|
// project_memory_read - Read project memory
|
|
11
11
|
// ============================================================================
|
|
12
12
|
export const projectMemoryReadTool = {
|
|
13
|
-
name: '
|
|
13
|
+
name: 'mem_read',
|
|
14
14
|
description: 'Read the project memory. Can read the full memory or a specific section.',
|
|
15
15
|
schema: {
|
|
16
16
|
section: z.enum(['all', 'techStack', 'build', 'conventions', 'structure', 'notes', 'directives']).optional()
|
|
@@ -72,7 +72,7 @@ export const projectMemoryReadTool = {
|
|
|
72
72
|
// project_memory_write - Write project memory
|
|
73
73
|
// ============================================================================
|
|
74
74
|
export const projectMemoryWriteTool = {
|
|
75
|
-
name: '
|
|
75
|
+
name: 'mem_write',
|
|
76
76
|
description: 'Write/update project memory. Can replace entirely or merge with existing memory.',
|
|
77
77
|
schema: {
|
|
78
78
|
memory: z.record(z.string(), z.unknown()).describe('The memory object to write'),
|
|
@@ -127,7 +127,7 @@ export const projectMemoryWriteTool = {
|
|
|
127
127
|
// project_memory_add_note - Add a custom note
|
|
128
128
|
// ============================================================================
|
|
129
129
|
export const projectMemoryAddNoteTool = {
|
|
130
|
-
name: '
|
|
130
|
+
name: 'mem_add_note',
|
|
131
131
|
description: 'Add a custom note to project memory. Notes are categorized and persisted across sessions.',
|
|
132
132
|
schema: {
|
|
133
133
|
category: z.string().max(50).describe('Note category (e.g., "build", "test", "deploy", "env", "architecture")'),
|
|
@@ -170,7 +170,7 @@ export const projectMemoryAddNoteTool = {
|
|
|
170
170
|
// project_memory_add_directive - Add a user directive
|
|
171
171
|
// ============================================================================
|
|
172
172
|
export const projectMemoryAddDirectiveTool = {
|
|
173
|
-
name: '
|
|
173
|
+
name: 'mem_add_directive',
|
|
174
174
|
description: 'Add a user directive to project memory. Directives are instructions that persist across sessions and survive compaction.',
|
|
175
175
|
schema: {
|
|
176
176
|
directive: z.string().max(500).describe('The directive (e.g., "Always use TypeScript strict mode")'),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"memory-tools.js","sourceRoot":"","sources":["../../src/tools/memory-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,4BAA4B,EAC5B,YAAY,EACZ,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,YAAY,GAGb,MAAM,kCAAkC,CAAC;AAG1C,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAG7B;IACH,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"memory-tools.js","sourceRoot":"","sources":["../../src/tools/memory-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,4BAA4B,EAC5B,YAAY,EACZ,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,YAAY,GAGb,MAAM,kCAAkC,CAAC;AAG1C,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAG7B;IACH,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,0EAA0E;IACvF,MAAM,EAAE;QACN,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;aACzG,QAAQ,CAAC,gCAAgC,CAAC;QAC7C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KACxF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;QAEnD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,kDAAkD,4BAA4B,CAAC,IAAI,CAAC,uGAAuG;yBAClM,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACtB,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,8BAA8B,4BAA4B,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU;yBACnI,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,0BAA0B;YAC1B,MAAM,UAAU,GAAiE;gBAC/E,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,aAAa;gBAC1B,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,aAAa;gBACpB,UAAU,EAAE,gBAAgB;aAC7B,CAAC;YAEF,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW;gBACtC,CAAC,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc;oBAC9C,CAAC,CAAC,MAAM,CAAC,GAA0B,CAAC,CAAC;YAEhD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sBAAsB,OAAO,mBAAmB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU;qBAC9F,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAChG,CAAC;aACH,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,8CAA8C;AAC9C,+EAA+E;AAE/E,MAAM,CAAC,MAAM,sBAAsB,GAI9B;IACH,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,kFAAkF;IAC/F,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAChF,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;QACxG,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KACxF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;QAEzD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;YAExD,+BAA+B;YAC/B,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAEvB,IAAI,WAA0B,CAAC;YAE/B,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,QAAQ,EAAE,CAAC;oBACb,WAAW,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAA8B,CAAC;gBACvE,CAAC;qBAAM,CAAC;oBACN,WAAW,GAAG,MAAkC,CAAC;gBACnD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,MAAkC,CAAC;YACnD,CAAC;YAED,yBAAyB;YACzB,IAAI,CAAC,WAAW,CAAC,OAAO;gBAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;YACxD,IAAI,CAAC,WAAW,CAAC,WAAW;gBAAE,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnE,IAAI,CAAC,WAAW,CAAC,WAAW;gBAAE,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC;YAE7D,MAAM,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAE3C,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,gBAAgB,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,2BAA2B,4BAA4B,CAAC,IAAI,CAAC,EAAE;qBAChH,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAChG,CAAC;aACH,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,8CAA8C;AAC9C,+EAA+E;AAE/E,MAAM,CAAC,MAAM,wBAAwB,GAIhC;IACH,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,2FAA2F;IACxG,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wEAAwE,CAAC;QAC/G,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;QACtD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KACxF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;QAErD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;YAExD,uBAAuB;YACvB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,wFAAwF;yBAC/F,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAE7C,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iEAAiE,QAAQ,oBAAoB,OAAO,EAAE;qBAC7G,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sBAAsB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACrF,CAAC;aACH,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,sDAAsD;AACtD,+EAA+E;AAE/E,MAAM,CAAC,MAAM,6BAA6B,GAKrC;IACH,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,0HAA0H;IACvI,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,2DAA2D,CAAC;QACpG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QACxF,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC5F,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KACxF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;QAEhF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;YAExD,uBAAuB;YACvB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,wFAAwF;yBAC/F,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,GAAkB;gBAClC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,SAAS;gBACT,OAAO;gBACP,MAAM,EAAE,UAAU;gBAClB,QAAQ;aACT,CAAC;YAEF,MAAM,CAAC,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;YAC1E,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAEtC,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,uEAAuE,SAAS,qBAAqB,QAAQ,oBAAoB,OAAO,IAAI,QAAQ,EAAE;qBAC7J,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC1F,CAAC;aACH,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,qBAAqB;IACrB,sBAAsB;IACtB,wBAAwB;IACxB,6BAA6B;CAC9B,CAAC"}
|
package/docs/README.md
ADDED
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# ultrapower 文档
|
|
2
|
+
|
|
3
|
+
> **版本**: v5.5.15
|
|
4
|
+
> **最后更新**: 2026-03-05
|
|
5
|
+
|
|
6
|
+
欢迎使用 ultrapower!这是 Claude Code 的多智能体编排框架。
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## 🚀 快速导航
|
|
11
|
+
|
|
12
|
+
- [5 分钟安装](./getting-started/installation.md)
|
|
13
|
+
- [15 分钟快速开始](./getting-started/quickstart.md)
|
|
14
|
+
- [核心概念](./getting-started/concepts.md)
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 👥 按角色查找
|
|
19
|
+
|
|
20
|
+
### 新用户
|
|
21
|
+
刚开始使用 ultrapower?从这里开始:
|
|
22
|
+
- [快速开始](./getting-started/quickstart.md) - 20 分钟内跑通第一个示例
|
|
23
|
+
- [核心概念](./getting-started/concepts.md) - 理解 agents、skills、hooks、tools
|
|
24
|
+
|
|
25
|
+
### 日常用户
|
|
26
|
+
查找特定功能的使用方法:
|
|
27
|
+
- [Agents 列表](./features/agents.md) - 50 个专业 agents
|
|
28
|
+
- [Skills 列表](./features/skills.md) - 71 个工作流 skills
|
|
29
|
+
- [Hooks 系统](./features/hooks.md) - 47 个事件 hooks
|
|
30
|
+
- [工具参考](./features/tools.md) - 35 个自定义工具
|
|
31
|
+
|
|
32
|
+
### 高级用户
|
|
33
|
+
深入理解系统架构:
|
|
34
|
+
- [状态机设计](./architecture/state-machine.md)
|
|
35
|
+
- [Hook 执行顺序](./architecture/hook-execution-order.md)
|
|
36
|
+
- [Agent 生命周期](./architecture/agent-lifecycle.md)
|
|
37
|
+
|
|
38
|
+
### 贡献者
|
|
39
|
+
参与项目开发:
|
|
40
|
+
- [贡献指南](./standards/contribution-guide.md)
|
|
41
|
+
- [代码规范](./standards/runtime-protection.md)
|
|
42
|
+
- [反模式](./standards/anti-patterns.md)
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## 🎯 按场景查找
|
|
47
|
+
|
|
48
|
+
- [功能开发](./guides/scenario-feature-dev.md) - 从需求到交付的完整流程
|
|
49
|
+
- [Bug 调查](./guides/scenario-bug-investigation.md) - 系统化调试方法
|
|
50
|
+
- [代码审查](./guides/scenario-code-review.md) - 多维度审查流程
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 📚 核心功能
|
|
55
|
+
|
|
56
|
+
### Agents(智能体)
|
|
57
|
+
50 个专业 agents,覆盖构建、审查、领域、产品等多个通道。
|
|
58
|
+
|
|
59
|
+
**常用 agents**:
|
|
60
|
+
- `executor` - 代码实现
|
|
61
|
+
- `debugger` - 根因分析
|
|
62
|
+
- `architect` - 系统设计
|
|
63
|
+
- `code-reviewer` - 代码审查
|
|
64
|
+
|
|
65
|
+
[查看完整列表 →](./features/agents.md)
|
|
66
|
+
|
|
67
|
+
### Skills(技能)
|
|
68
|
+
71 个工作流 skills,自动化复杂任务。
|
|
69
|
+
|
|
70
|
+
**高频 skills**:
|
|
71
|
+
- `/ultrapower:autopilot` - 全自主执行
|
|
72
|
+
- `/ultrapower:team` - 多 agent 协作
|
|
73
|
+
- `/ultrapower:ralph` - 持续执行直到完成
|
|
74
|
+
|
|
75
|
+
[查看完整列表 →](./features/skills.md)
|
|
76
|
+
|
|
77
|
+
### Axiom 进化系统
|
|
78
|
+
自我改进的智能体系统,包含知识收割、模式检测、工作流优化。
|
|
79
|
+
|
|
80
|
+
[了解更多 →](./features/axiom.md)
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## 💬 反馈与帮助
|
|
85
|
+
|
|
86
|
+
### 这篇文档有帮助吗?
|
|
87
|
+
- [👍 有帮助](https://github.com/liangjie559567/ultrapower/issues/new?labels=docs-feedback&template=docs-helpful.md)
|
|
88
|
+
- [👎 需改进](https://github.com/liangjie559567/ultrapower/issues/new?labels=docs-feedback&template=docs-improvement.md)
|
|
89
|
+
|
|
90
|
+
### 遇到问题?
|
|
91
|
+
- [故障排查指南](./guides/troubleshooting.md)
|
|
92
|
+
- [提交 Issue](https://github.com/liangjie559567/ultrapower/issues/new)
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 📖 文档结构
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
docs/
|
|
100
|
+
├── getting-started/ # 新手入门
|
|
101
|
+
├── features/ # 功能参考
|
|
102
|
+
├── guides/ # 使用指南
|
|
103
|
+
├── architecture/ # 架构设计
|
|
104
|
+
├── standards/ # 开发规范
|
|
105
|
+
└── api/ # API 参考
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
**开始使用**: [安装 ultrapower →](./getting-started/installation.md)
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# 核心概念
|
|
2
|
+
|
|
3
|
+
理解 ultrapower 的四大核心组件。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Agents(智能体)
|
|
8
|
+
|
|
9
|
+
**定义**: 专业的 AI 助手,每个 agent 专注于特定领域。
|
|
10
|
+
|
|
11
|
+
**示例**:
|
|
12
|
+
- `executor` - 代码实现
|
|
13
|
+
- `debugger` - 问题诊断
|
|
14
|
+
- `architect` - 系统设计
|
|
15
|
+
|
|
16
|
+
**使用方式**:
|
|
17
|
+
```
|
|
18
|
+
使用 executor agent 实现登录功能
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
[查看完整 Agents 列表 →](../features/agents.md)
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Skills(技能)
|
|
26
|
+
|
|
27
|
+
**定义**: 预定义的工作流,自动化复杂任务。
|
|
28
|
+
|
|
29
|
+
**示例**:
|
|
30
|
+
- `/ultrapower:autopilot` - 全自主执行
|
|
31
|
+
- `/ultrapower:team` - 多 agent 协作
|
|
32
|
+
- `/ultrapower:ralph` - 持续执行
|
|
33
|
+
|
|
34
|
+
**使用方式**:
|
|
35
|
+
```
|
|
36
|
+
/ultrapower:autopilot "创建 REST API"
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
[查看完整 Skills 列表 →](../features/skills.md)
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Hooks(钩子)
|
|
44
|
+
|
|
45
|
+
**定义**: 事件驱动的自动化触发器。
|
|
46
|
+
|
|
47
|
+
**示例**:
|
|
48
|
+
- `UserPromptSubmit` - 用户输入时触发
|
|
49
|
+
- `ToolUse` - 工具调用时触发
|
|
50
|
+
|
|
51
|
+
**工作原理**:
|
|
52
|
+
```
|
|
53
|
+
用户输入 → Hook 检测关键词 → 自动调用 Skill
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
[查看完整 Hooks 列表 →](../features/hooks.md)
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## Tools(工具)
|
|
61
|
+
|
|
62
|
+
**定义**: 35 个自定义工具,扩展 Claude 能力。
|
|
63
|
+
|
|
64
|
+
**分类**:
|
|
65
|
+
- **LSP 工具** (12个): 代码智能分析
|
|
66
|
+
- **AST 工具** (2个): 结构化代码搜索
|
|
67
|
+
- **State 工具** (5个): 状态管理
|
|
68
|
+
- **Notepad 工具** (6个): 会话记忆
|
|
69
|
+
|
|
70
|
+
[查看完整 Tools 列表 →](../features/tools.md)
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## Axiom 进化系统
|
|
75
|
+
|
|
76
|
+
**定义**: 自我改进的智能体系统。
|
|
77
|
+
|
|
78
|
+
**核心功能**:
|
|
79
|
+
1. **知识收割** - 从执行中学习
|
|
80
|
+
2. **模式检测** - 识别重复模式
|
|
81
|
+
3. **工作流优化** - 自动改进流程
|
|
82
|
+
|
|
83
|
+
[了解 Axiom →](../features/axiom.md)
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## 工作流程图
|
|
88
|
+
|
|
89
|
+
```mermaid
|
|
90
|
+
graph LR
|
|
91
|
+
A[用户需求] --> B[Hook 检测]
|
|
92
|
+
B --> C[调用 Skill]
|
|
93
|
+
C --> D[分配 Agents]
|
|
94
|
+
D --> E[使用 Tools]
|
|
95
|
+
E --> F[完成任务]
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## 下一步
|
|
101
|
+
|
|
102
|
+
- [查看实际使用场景](../guides/scenario-feature-dev.md)
|
|
103
|
+
- [探索高级功能](../architecture/state-machine.md)
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
# 安装指南
|
|
2
|
+
|
|
3
|
+
> **预计时间**: 5 分钟
|
|
4
|
+
> **适用版本**: v5.5.15+
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 前置要求
|
|
9
|
+
|
|
10
|
+
- Node.js >= 18
|
|
11
|
+
- npm >= 9
|
|
12
|
+
- Claude Code CLI
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## 安装步骤
|
|
17
|
+
|
|
18
|
+
### 1. 全局安装 ultrapower
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm install -g @liangjie559567/ultrapower@latest
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
✅ **检查点**: 运行 `omc --version` 应显示版本号
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
### 2. 初始化项目
|
|
29
|
+
|
|
30
|
+
在您的项目目录中运行:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
omc install
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
这将:
|
|
37
|
+
- 创建 `.omc/` 目录
|
|
38
|
+
- 生成 `CLAUDE.md` 配置文件
|
|
39
|
+
- 安装必要的 hooks
|
|
40
|
+
|
|
41
|
+
✅ **检查点**: 项目根目录应包含 `CLAUDE.md` 文件
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
### 3. 验证安装
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
# 检查 ultrapower 状态
|
|
49
|
+
omc doctor
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
✅ **检查点**: 所有检查项应显示 ✅
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 常见问题
|
|
57
|
+
|
|
58
|
+
### 错误: `command not found: omc`
|
|
59
|
+
|
|
60
|
+
**原因**: npm 全局路径未添加到 PATH
|
|
61
|
+
|
|
62
|
+
**解决**:
|
|
63
|
+
```bash
|
|
64
|
+
# 查看 npm 全局路径
|
|
65
|
+
npm config get prefix
|
|
66
|
+
|
|
67
|
+
# 添加到 PATH(macOS/Linux)
|
|
68
|
+
export PATH="$PATH:$(npm config get prefix)/bin"
|
|
69
|
+
|
|
70
|
+
# 添加到 PATH(Windows)
|
|
71
|
+
# 将 %APPDATA%\npm 添加到系统环境变量
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
### 错误: `EACCES: permission denied`
|
|
77
|
+
|
|
78
|
+
**原因**: 权限不足
|
|
79
|
+
|
|
80
|
+
**解决**:
|
|
81
|
+
```bash
|
|
82
|
+
# 使用 sudo(不推荐)
|
|
83
|
+
sudo npm install -g @liangjie559567/ultrapower
|
|
84
|
+
|
|
85
|
+
# 或配置 npm 使用用户目录(推荐)
|
|
86
|
+
npm config set prefix ~/.npm-global
|
|
87
|
+
export PATH=~/.npm-global/bin:$PATH
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## 下一步
|
|
93
|
+
|
|
94
|
+
✅ 安装完成!继续:
|
|
95
|
+
- [快速开始](./quickstart.md) - 15 分钟跑通第一个示例
|
|
96
|
+
- [核心概念](./concepts.md) - 理解 ultrapower 工作原理
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
**遇到问题?** [查看故障排查指南](../guides/troubleshooting.md)
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# 快速开始
|
|
2
|
+
|
|
3
|
+
> **预计时间**: 20 分钟
|
|
4
|
+
> **前置条件**: 已完成[安装](./installation.md)
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 第一个示例:使用 Autopilot
|
|
9
|
+
|
|
10
|
+
### 步骤 1: 创建测试项目
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
mkdir ultrapower-demo && cd ultrapower-demo
|
|
14
|
+
npm init -y
|
|
15
|
+
omc install
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
✅ **检查点 1**: 项目包含 `CLAUDE.md` 文件
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
### 步骤 2: 启动 Claude Code
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
claude chat
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
✅ **检查点 2**: Claude Code CLI 已启动
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
### 步骤 3: 运行第一个 Autopilot 任务
|
|
33
|
+
|
|
34
|
+
在 Claude Code 中输入:
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
/ultrapower:autopilot "创建一个简单的 HTTP 服务器,监听 3000 端口"
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
**预期输出**:
|
|
41
|
+
- Agent 自动分析需求
|
|
42
|
+
- 生成代码文件
|
|
43
|
+
- 运行测试验证
|
|
44
|
+
|
|
45
|
+
✅ **检查点 3**: 生成了 `server.js` 或类似文件
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
### 步骤 4: 验证结果
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
node server.js
|
|
53
|
+
# 访问 http://localhost:3000
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
✅ **检查点 4**: 服务器正常运行
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## 🎉 恭喜!
|
|
61
|
+
|
|
62
|
+
你已经成功运行了第一个 ultrapower 示例!
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## 下一步学习
|
|
67
|
+
|
|
68
|
+
### 理解核心概念
|
|
69
|
+
- [什么是 Agents?](./concepts.md#agents)
|
|
70
|
+
- [什么是 Skills?](./concepts.md#skills)
|
|
71
|
+
|
|
72
|
+
### 尝试更多功能
|
|
73
|
+
- [Team 协作](../guides/workflow-team-pipeline.md) - 多 agent 并行工作
|
|
74
|
+
- [Ralph 循环](../guides/workflow-ralph-loop.md) - 持续执行直到完成
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## 常见问题
|
|
79
|
+
|
|
80
|
+
### Q: Autopilot 没有响应?
|
|
81
|
+
|
|
82
|
+
**检查**:
|
|
83
|
+
1. 确认 `CLAUDE.md` 存在
|
|
84
|
+
2. 运行 `omc doctor` 检查状态
|
|
85
|
+
3. 查看 [故障排查](../guides/troubleshooting.md)
|
|
86
|
+
|
|
87
|
+
### Q: 生成的代码有错误?
|
|
88
|
+
|
|
89
|
+
**正常现象**!Autopilot 会自动:
|
|
90
|
+
1. 检测错误
|
|
91
|
+
2. 调用 debugger agent
|
|
92
|
+
3. 自动修复并重试
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
**遇到问题?** [查看完整故障排查指南](../guides/troubleshooting.md)
|
|
File without changes
|