AgentSkillsCN

code-patterns

针对本项目常见的代码模式，当您需要实现新功能或处理异常情况时，可使用此技能。

SKILL.md
--- frontmatter
name: code-patterns
description: "Common code patterns for this project. Use when implementing features or handling errors."

Code Patterns

When to Use

  • •Implementing new features
  • •Handling GitHub API calls
  • •Adding code analysis patterns
  • •Writing type-safe code

GitHub API Error Handling

typescript
try {
  const result = await this.octokit.pulls.get({
    owner: params.owner,
    repo: params.repo,
    pull_number: params.prNumber,
  });
  return result.data;
} catch (error) {
  const message = error instanceof Error ? error.message : String(error);
  console.error("Error fetching PR:", message);
  throw new Error(`Failed to fetch PR: ${message}`);
}
  • •Rate limiting: automatic via @octokit/plugin-throttling
  • •Pagination: use @octokit/plugin-paginate-rest
  • •Auth: ensure GITHUB_TOKEN in .env

Type-Safe Code

typescript
// CORRECT - Explicit type definition
export const PRParamsSchema = z.object({
  owner: z.string(),
  repo: z.string(),
  prNumber: z.number(),
});

export interface PRParams {
  owner: string;
  repo: string;
  prNumber: number;
}

// CORRECT - use optional property
interface GoodType {
  value?: string;
}

// CORRECT - use optional chaining when accessing
const result = obj?.value ?? "default";

Adding Analysis Patterns

Security patterns (src/code-analyzer.ts):

typescript
{
  pattern: /your-regex-pattern/gi,
  message: "Description of the issue",
}

Code smell patterns:

typescript
{
  pattern: /your-regex-pattern/g,
  message: "Description of the smell",
}

Service Layer

All GitHub API calls must go through GitHubService:

typescript
// CORRECT
const result = await githubService.getPRDetails(params);

// WRONG - bypasses service
const result = await octokit.pulls.get({...});