mirror of
https://github.com/cjo4m06/mcp-shrimp-task-manager.git
synced 2025-07-27 08:32:27 +08:00
新增任務相關欄位,包括依賴關係、實現指南及驗證標準,並調整任務更新邏輯以支持這些新欄位,提升任務管理的完整性與可追溯性。同時更新相關描述以提供更清晰的指導。
This commit is contained in:
parent
d574b502e1
commit
f9409fd48e
65
src/index.ts
65
src/index.ts
@ -69,7 +69,7 @@ async function main() {
|
|||||||
|
|
||||||
server.tool(
|
server.tool(
|
||||||
"analyze_task",
|
"analyze_task",
|
||||||
"深入分析任務需求並系統性檢查代碼庫,評估技術可行性與潛在風險",
|
"深入分析任務需求並系統性檢查代碼庫,評估技術可行性與潛在風險,如果需要提供程式碼請使用 pseudocode 格式且盡量精簡只保留核心實現部分",
|
||||||
{
|
{
|
||||||
summary: z
|
summary: z
|
||||||
.string()
|
.string()
|
||||||
@ -84,7 +84,9 @@ async function main() {
|
|||||||
message:
|
message:
|
||||||
"初步解答構想過於簡短,請提供更完整的技術方案和實施策略詳情",
|
"初步解答構想過於簡短,請提供更完整的技術方案和實施策略詳情",
|
||||||
})
|
})
|
||||||
.describe("初步解答構想,包含技術方案、架構設計和實施策略"),
|
.describe(
|
||||||
|
"初步解答構想,包含技術方案、架構設計和實施策略,如果需要提供程式碼請使用 pseudocode 格式且盡量精簡只保留核心實現部分"
|
||||||
|
),
|
||||||
previousAnalysis: z
|
previousAnalysis: z
|
||||||
.string()
|
.string()
|
||||||
.optional()
|
.optional()
|
||||||
@ -99,7 +101,7 @@ async function main() {
|
|||||||
|
|
||||||
server.tool(
|
server.tool(
|
||||||
"reflect_task",
|
"reflect_task",
|
||||||
"批判性審查分析結果,評估方案完整性並識別優化機會,確保解決方案符合最佳實踐",
|
"批判性審查分析結果,評估方案完整性並識別優化機會,確保解決方案符合最佳實踐,如果需要提供程式碼請使用 pseudocode 格式且盡量精簡只保留核心實現部分",
|
||||||
{
|
{
|
||||||
summary: z
|
summary: z
|
||||||
.string()
|
.string()
|
||||||
@ -115,7 +117,7 @@ async function main() {
|
|||||||
"技術分析結果過於簡略,請提供更詳盡的技術細節、依賴組件和實施方案說明",
|
"技術分析結果過於簡略,請提供更詳盡的技術細節、依賴組件和實施方案說明",
|
||||||
})
|
})
|
||||||
.describe(
|
.describe(
|
||||||
"完整詳盡的技術分析結果,包括所有技術細節、依賴組件和實施方案"
|
"完整詳盡的技術分析結果,包括所有技術細節、依賴組件和實施方案,如果需要提供程式碼請使用 pseudocode 格式且盡量精簡只保留核心實現部分"
|
||||||
),
|
),
|
||||||
},
|
},
|
||||||
async (args) => {
|
async (args) => {
|
||||||
@ -125,7 +127,7 @@ async function main() {
|
|||||||
|
|
||||||
server.tool(
|
server.tool(
|
||||||
"split_tasks",
|
"split_tasks",
|
||||||
"將複雜任務分解為獨立且可追蹤的子任務,建立明確的依賴關係和優先順序。支援四種任務更新模式:追加(append)、覆蓋(overwrite)、選擇性更新(selective)和清除所有任務(clearAllTasks),其中覆蓋模式只會刪除未完成的任務並保留已完成任務,選擇性更新模式可根據任務名稱智能匹配更新現有任務,同時保留其他任務,如果你需要規劃全新的任務請使用清除所有任務模式會清除所有任務並創建備份。請優先使用清除所有任務模式,只有用戶要求變更或修改計畫內容才使用其他模式",
|
"將複雜任務分解為獨立且可追蹤的子任務,建立明確的依賴關係和優先順序。支援四種任務更新模式:追加(append)、覆蓋(overwrite)、選擇性更新(selective)和清除所有任務(clearAllTasks),其中覆蓋模式只會刪除未完成的任務並保留已完成任務,選擇性更新模式可根據任務名稱智能匹配更新現有任務,同時保留其他任務,如果你需要規劃全新的任務請使用清除所有任務模式會清除所有任務並創建備份。請優先使用清除所有任務模式,只有用戶要求變更或修改計畫內容才使用其他模式。\n\n**請參考之前的分析結果提供 pseudocode\n\n**如果任務太多或內容過長,請分批使用「split_tasks」工具,每次只提交一小部分任務",
|
||||||
{
|
{
|
||||||
updateMode: z
|
updateMode: z
|
||||||
.enum(["append", "overwrite", "selective", "clearAllTasks"])
|
.enum(["append", "overwrite", "selective", "clearAllTasks"])
|
||||||
@ -186,8 +188,9 @@ async function main() {
|
|||||||
.describe("與任務相關的檔案列表,包含檔案路徑、類型和描述"),
|
.describe("與任務相關的檔案列表,包含檔案路徑、類型和描述"),
|
||||||
implementationGuide: z
|
implementationGuide: z
|
||||||
.string()
|
.string()
|
||||||
.optional()
|
.describe(
|
||||||
.describe("此特定任務的具體實現方法和步驟"),
|
"此特定任務的具體實現方法和步驟,請參考之前的分析結果提供 pseudocode"
|
||||||
|
),
|
||||||
verificationCriteria: z
|
verificationCriteria: z
|
||||||
.string()
|
.string()
|
||||||
.optional()
|
.optional()
|
||||||
@ -293,6 +296,54 @@ async function main() {
|
|||||||
name: z.string().optional().describe("任務的新名稱(選填)"),
|
name: z.string().optional().describe("任務的新名稱(選填)"),
|
||||||
description: z.string().optional().describe("任務的新描述內容(選填)"),
|
description: z.string().optional().describe("任務的新描述內容(選填)"),
|
||||||
notes: z.string().optional().describe("任務的新補充說明(選填)"),
|
notes: z.string().optional().describe("任務的新補充說明(選填)"),
|
||||||
|
dependencies: z
|
||||||
|
.array(z.string())
|
||||||
|
.optional()
|
||||||
|
.describe("任務的新依賴關係(選填)"),
|
||||||
|
relatedFiles: z
|
||||||
|
.array(
|
||||||
|
z.object({
|
||||||
|
path: z
|
||||||
|
.string()
|
||||||
|
.min(1, { message: "文件路徑不能為空,請提供有效的文件路徑" })
|
||||||
|
.describe("文件路徑,可以是相對於項目根目錄的路徑或絕對路徑"),
|
||||||
|
type: z
|
||||||
|
.enum([
|
||||||
|
RelatedFileType.TO_MODIFY,
|
||||||
|
RelatedFileType.REFERENCE,
|
||||||
|
RelatedFileType.CREATE,
|
||||||
|
RelatedFileType.DEPENDENCY,
|
||||||
|
RelatedFileType.OTHER,
|
||||||
|
])
|
||||||
|
.describe("文件與任務的關係類型"),
|
||||||
|
description: z
|
||||||
|
.string()
|
||||||
|
.optional()
|
||||||
|
.describe("文件的補充描述(選填)"),
|
||||||
|
lineStart: z
|
||||||
|
.number()
|
||||||
|
.int()
|
||||||
|
.positive()
|
||||||
|
.optional()
|
||||||
|
.describe("相關代碼區塊的起始行(選填)"),
|
||||||
|
lineEnd: z
|
||||||
|
.number()
|
||||||
|
.int()
|
||||||
|
.positive()
|
||||||
|
.optional()
|
||||||
|
.describe("相關代碼區塊的結束行(選填)"),
|
||||||
|
})
|
||||||
|
)
|
||||||
|
.optional()
|
||||||
|
.describe("與任務相關的文件列表(選填)"),
|
||||||
|
implementationGuide: z
|
||||||
|
.string()
|
||||||
|
.optional()
|
||||||
|
.describe("任務的新實現指南(選填)"),
|
||||||
|
verificationCriteria: z
|
||||||
|
.string()
|
||||||
|
.optional()
|
||||||
|
.describe("任務的新驗證標準(選填)"),
|
||||||
},
|
},
|
||||||
async (args) => {
|
async (args) => {
|
||||||
return await updateTaskContent(args);
|
return await updateTaskContent(args);
|
||||||
|
@ -171,6 +171,9 @@ export async function updateTaskContent(
|
|||||||
description?: string;
|
description?: string;
|
||||||
notes?: string;
|
notes?: string;
|
||||||
relatedFiles?: RelatedFile[];
|
relatedFiles?: RelatedFile[];
|
||||||
|
dependencies?: string[];
|
||||||
|
implementationGuide?: string;
|
||||||
|
verificationCriteria?: string;
|
||||||
}
|
}
|
||||||
): Promise<{ success: boolean; message: string; task?: Task }> {
|
): Promise<{ success: boolean; message: string; task?: Task }> {
|
||||||
// 獲取任務並檢查是否存在
|
// 獲取任務並檢查是否存在
|
||||||
@ -204,6 +207,20 @@ export async function updateTaskContent(
|
|||||||
updateObj.relatedFiles = updates.relatedFiles;
|
updateObj.relatedFiles = updates.relatedFiles;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (updates.dependencies !== undefined) {
|
||||||
|
updateObj.dependencies = updates.dependencies.map((dep) => ({
|
||||||
|
taskId: dep,
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
|
||||||
|
if (updates.implementationGuide !== undefined) {
|
||||||
|
updateObj.implementationGuide = updates.implementationGuide;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (updates.verificationCriteria !== undefined) {
|
||||||
|
updateObj.verificationCriteria = updates.verificationCriteria;
|
||||||
|
}
|
||||||
|
|
||||||
// 如果沒有要更新的內容,提前返回
|
// 如果沒有要更新的內容,提前返回
|
||||||
if (Object.keys(updateObj).length === 0) {
|
if (Object.keys(updateObj).length === 0) {
|
||||||
return { success: true, message: "沒有提供需要更新的內容", task };
|
return { success: true, message: "沒有提供需要更新的內容", task };
|
||||||
|
@ -267,7 +267,8 @@ export const analyzeTaskSchema = z.object({
|
|||||||
initialConcept: z
|
initialConcept: z
|
||||||
.string()
|
.string()
|
||||||
.min(50, {
|
.min(50, {
|
||||||
message: "初步解答構想過於簡短,請提供更完整的技術方案和實施策略詳情",
|
message:
|
||||||
|
"初步解答構想過於簡短,請提供更完整的技術方案和實施策略詳情,如果需要提供程式碼請使用 pseudocode 格式且盡量精簡只保留核心實現部分",
|
||||||
})
|
})
|
||||||
.describe("初步解答構想,包含技術方案、架構設計和實施策略"),
|
.describe("初步解答構想,包含技術方案、架構設計和實施策略"),
|
||||||
previousAnalysis: z
|
previousAnalysis: z
|
||||||
@ -352,7 +353,9 @@ export const reflectTaskSchema = z
|
|||||||
message:
|
message:
|
||||||
"技術分析結果過於簡略,請提供更詳盡的技術細節、依賴組件和實施方案說明",
|
"技術分析結果過於簡略,請提供更詳盡的技術細節、依賴組件和實施方案說明",
|
||||||
})
|
})
|
||||||
.describe("完整詳盡的技術分析結果,包括所有技術細節、依賴組件和實施方案"),
|
.describe(
|
||||||
|
"完整詳盡的技術分析結果,包括所有技術細節、依賴組件和實施方案,如果需要提供程式碼請使用 pseudocode 格式且盡量精簡只保留核心實現部分"
|
||||||
|
),
|
||||||
})
|
})
|
||||||
.refine((data) => data.summary.length * 3 <= data.analysis.length, {
|
.refine((data) => data.summary.length * 3 <= data.analysis.length, {
|
||||||
message:
|
message:
|
||||||
@ -395,6 +398,7 @@ export async function reflectTask({
|
|||||||
|
|
||||||
- **如果確認方案已足夠完善**:
|
- **如果確認方案已足夠完善**:
|
||||||
- 請使用「split_tasks」工具,將解決方案分解為具體、可執行的子任務
|
- 請使用「split_tasks」工具,將解決方案分解為具體、可執行的子任務
|
||||||
|
- 如果任務太多或內容過長,請分批使用「split_tasks」工具,每次只提交一小部分任務
|
||||||
- 建立明確的依賴關係和執行順序
|
- 建立明確的依賴關係和執行順序
|
||||||
- 為每個子任務設定明確的完成標準和驗收條件
|
- 為每個子任務設定明確的完成標準和驗收條件
|
||||||
|
|
||||||
@ -409,7 +413,7 @@ export async function reflectTask({
|
|||||||
拆分任務時,已將規劃與分析階段產生的關鍵知識保留並融入到任務中:
|
拆分任務時,已將規劃與分析階段產生的關鍵知識保留並融入到任務中:
|
||||||
|
|
||||||
1. **全局分析結果** - 所有任務都已關聯完整的分析文檔,在執行時可查看
|
1. **全局分析結果** - 所有任務都已關聯完整的分析文檔,在執行時可查看
|
||||||
2. **任務專屬實現指南** - 每個任務都已保存具體的實現方法和建議
|
2. **任務專屬實現指南** - 每個任務都已保存具體的實現方法和建議,如果可以請提供 pseudocode
|
||||||
3. **任務專屬驗證標準** - 每個任務都設置了明確的驗證要求和檢查點
|
3. **任務專屬驗證標準** - 每個任務都設置了明確的驗證要求和檢查點
|
||||||
|
|
||||||
此機制確保了任務執行者可以獲得完整的背景知識和技術細節,無需重新思考或推導解決方案。
|
此機制確保了任務執行者可以獲得完整的背景知識和技術細節,無需重新思考或推導解決方案。
|
||||||
@ -486,8 +490,9 @@ export const splitTasksSchema = z
|
|||||||
.describe("與任務相關的檔案列表,包含檔案路徑、類型和描述"),
|
.describe("與任務相關的檔案列表,包含檔案路徑、類型和描述"),
|
||||||
implementationGuide: z
|
implementationGuide: z
|
||||||
.string()
|
.string()
|
||||||
.optional()
|
.describe(
|
||||||
.describe("此特定任務的具體實現方法和步驟"),
|
"此特定任務的具體實現方法和步驟,請參考之前的分析結果提供 pseudocode"
|
||||||
|
),
|
||||||
verificationCriteria: z
|
verificationCriteria: z
|
||||||
.string()
|
.string()
|
||||||
.optional()
|
.optional()
|
||||||
@ -1518,6 +1523,18 @@ export const updateTaskContentSchema = z
|
|||||||
)
|
)
|
||||||
.optional()
|
.optional()
|
||||||
.describe("與任務相關的文件列表(選填)"),
|
.describe("與任務相關的文件列表(選填)"),
|
||||||
|
dependencies: z
|
||||||
|
.array(z.string())
|
||||||
|
.optional()
|
||||||
|
.describe("任務的新依賴關係(選填)"),
|
||||||
|
implementationGuide: z
|
||||||
|
.string()
|
||||||
|
.optional()
|
||||||
|
.describe("任務的新實現指南(選填)"),
|
||||||
|
verificationCriteria: z
|
||||||
|
.string()
|
||||||
|
.optional()
|
||||||
|
.describe("任務的新驗證標準(選填)"),
|
||||||
})
|
})
|
||||||
.refine(
|
.refine(
|
||||||
(data) => {
|
(data) => {
|
||||||
@ -1541,7 +1558,10 @@ export const updateTaskContentSchema = z
|
|||||||
data.name ||
|
data.name ||
|
||||||
data.description ||
|
data.description ||
|
||||||
data.notes ||
|
data.notes ||
|
||||||
(data.relatedFiles && data.relatedFiles.length > 0)
|
data.dependencies ||
|
||||||
|
data.implementationGuide ||
|
||||||
|
data.verificationCriteria ||
|
||||||
|
data.relatedFiles
|
||||||
);
|
);
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
@ -1557,6 +1577,9 @@ export async function updateTaskContent({
|
|||||||
description,
|
description,
|
||||||
notes,
|
notes,
|
||||||
relatedFiles,
|
relatedFiles,
|
||||||
|
dependencies,
|
||||||
|
implementationGuide,
|
||||||
|
verificationCriteria,
|
||||||
}: z.infer<typeof updateTaskContentSchema>) {
|
}: z.infer<typeof updateTaskContentSchema>) {
|
||||||
// 獲取任務以檢查它是否存在
|
// 獲取任務以檢查它是否存在
|
||||||
const task = await getTaskById(taskId);
|
const task = await getTaskById(taskId);
|
||||||
@ -1580,6 +1603,10 @@ export async function updateTaskContent({
|
|||||||
if (notes) updateSummary += `,更新注記`;
|
if (notes) updateSummary += `,更新注記`;
|
||||||
if (relatedFiles)
|
if (relatedFiles)
|
||||||
updateSummary += `,更新相關文件 (${relatedFiles.length} 個)`;
|
updateSummary += `,更新相關文件 (${relatedFiles.length} 個)`;
|
||||||
|
if (dependencies)
|
||||||
|
updateSummary += `,更新依賴關係 (${dependencies.length} 個)`;
|
||||||
|
if (implementationGuide) updateSummary += `,更新實現指南`;
|
||||||
|
if (verificationCriteria) updateSummary += `,更新驗證標準`;
|
||||||
|
|
||||||
// 執行更新操作
|
// 執行更新操作
|
||||||
const result = await modelUpdateTaskContent(taskId, {
|
const result = await modelUpdateTaskContent(taskId, {
|
||||||
@ -1587,6 +1614,9 @@ export async function updateTaskContent({
|
|||||||
description,
|
description,
|
||||||
notes,
|
notes,
|
||||||
relatedFiles,
|
relatedFiles,
|
||||||
|
dependencies,
|
||||||
|
implementationGuide,
|
||||||
|
verificationCriteria,
|
||||||
});
|
});
|
||||||
|
|
||||||
// 構建響應消息
|
// 構建響應消息
|
||||||
|
Loading…
x
Reference in New Issue
Block a user