create_commit_comment
Add comments to specific commits in Alibaba Cloud DevOps repositories to provide feedback, document changes, or track issues directly in the code history.
Instructions
[Code Management] Create a comment on a commit
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organizationId | Yes | 组织ID | |
| repositoryId | Yes | 代码库ID或者URL-Encoder编码的全路径 | |
| sha | Yes | 提交的SHA值 | |
| content | Yes | commit的评论内容 |
Implementation Reference
- tool-handlers/commit.ts:32-37 (handler)Handler code for the 'create_commit_comment' tool: validates input parameters using the schema, calls the core implementation function, and returns the result as a formatted text content block.
case 'create_commit_comment': const createCommitCommentParams = CreateCommitCommentRequestSchema.parse(request.params.arguments); const createCommitCommentResult = await createCommitComment(createCommitCommentParams); return { content: [{ type: "text", text: JSON.stringify(createCommitCommentResult, null, 2) }], }; - operations/codeup/commits.ts:144-157 (helper)Core implementation function that encodes the repository ID, constructs the API URL, and sends a POST request to create the commit comment via yunxiaoRequest utility.
export async function createCommitComment(params: z.infer<typeof CreateCommitCommentRequestSchema>) { const { organizationId, repositoryId, sha, content } = params; const encodedRepoId = handleRepositoryIdEncoding(repositoryId); const url = `/oapi/v1/codeup/organizations/${organizationId}/repositories/${encodedRepoId}/commits/${sha}/comments`; const response: any = await yunxiaoRequest(url, { method: "POST", body: { content } }); return response; } - operations/codeup/commits.ts:28-33 (schema)Zod schema defining the input parameters for the create_commit_comment tool: organizationId, repositoryId, sha, and content.
export const CreateCommitCommentRequestSchema = z.object({ organizationId: z.string().describe("组织ID"), repositoryId: z.string().describe("代码库ID或者URL-Encoder编码的全路径"), sha: z.string().describe("提交的SHA值"), content: z.string().describe("commit的评论内容"), }); - tool-registry/commit.ts:20-24 (registration)Tool registration entry defining the name, description, and input schema for the 'create_commit_comment' tool.
{ name: 'create_commit_comment', description: '[Code Management] Create a comment on a commit', inputSchema: zodToJsonSchema(CreateCommitCommentRequestSchema), }