shen-shi

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

审视 (GitHub Triage)

GitHub 只读审查技能。分析开放的 Issues 和 PRs，生成有证据支持的报告。

Read-only GitHub analysis skill. Analyzes open issues and PRs with evidence-backed reports.

GitHub只读审查技能，可分析开放的Issues和PRs，生成有证据支撑的报告。

Quick Commands

快速命令

命令/Command	功能/Function
`/审视 <仓库>`	分析仓库所有开放 Issue 和 PR
`/审视 issues <仓库>`	只分析 Issues
`/审视 prs <仓库>`	只分析 PRs
`/审视 <URL>`	分析特定 Issue 或 PR
`/analyze <repo>`	Analyze all open items
`/analyze issues <repo>`	Analyze issues only
`/analyze prs <repo>`	Analyze PRs only

命令	功能
`/审视 <仓库>`	分析仓库所有开放的Issue和PR
`/审视 issues <仓库>`	仅分析Issues
`/审视 prs <仓库>`	仅分析PRs
`/审视 <URL>`	分析特定的Issue或PR
`/analyze <repo>`	分析所有开放项
`/analyze issues <repo>`	仅分析Issues
`/analyze prs <repo>`	仅分析PRs

核心原则/Core Principles

核心原则

只读不写/Read-Only Policy

只读不写策略

【绝对禁止/NEVER】
- gh issue comment - 不评论
- gh issue close - 不关闭
- gh pr merge - 不合并
- gh api -X POST/PUT/PATCH/DELETE - 不写入

【允许/ALLOWED】
- gh issue view / gh pr view - 读取数据
- gh api (GET only) - 读取 API
- git log/show/blame - 读取 git 历史
- Write - 仅写入报告文件到临时目录

【绝对禁止】
- gh issue comment - 不评论
- gh issue close - 不关闭
- gh pr merge - 不合并
- gh api -X POST/PUT/PATCH/DELETE - 不执行写入操作

【允许】
- gh issue view / gh pr view - 读取数据
- gh api (GET only) - 读取API
- git log/show/blame - 读取git历史
- Write - 仅允许将报告文件写入临时目录

证据规则/Evidence Rule

证据规则

【证据要求】
每个事实陈述必须有 GitHub permalink 作为证明。
Every factual claim requires a GitHub permalink as proof.

Permalink 格式/Format:
https://github.com/{owner}/{repo}/blob/{commit_sha}/{path}#L{start}-L{end}

示例/Example:
❌ 错误/Wrong: "代码有 bug"
✓ 正确/Correct: "代码有 bug [证据](https://github.com/owner/repo/blob/abc123/src/file.py#L45-L50)"

【证据要求】
每个事实陈述必须有GitHub permalink作为证明。

Permalink格式：
https://github.com/{owner}/{repo}/blob/{commit_sha}/{path}#L{start}-L{end}

示例：
❌ 错误："代码有bug"
✓ 正确："代码有bug [证据](https://github.com/owner/repo/blob/abc123/src/file.py#L45-L50)"

工作流程/Workflow

工作流程

Phase 1: 数据收集/Data Collection

阶段1：数据收集

markdown

undefined

markdown

undefined

数据收集/Data Collection

数据收集

仓库/Repo: {owner}/{repo} 时间/Time: {timestamp}

仓库: {owner}/{repo} 时间: {timestamp}

开放 Issues/Open Issues

开放Issues

#	标题/Title	标签/Labels	创建时间/Created	优先级/Priority
1	{title}	{labels}	{date}	P0/P1/P2

#	标题	标签	创建时间	优先级
1	{title}	{labels}	{date}	P0/P1/P2

开放 PRs/Open PRs

开放PRs

#	标题/Title	状态/Status	CI 状态/CI	创建时间/Created
1	{title}	{status}	{ci}	{date}

undefined

#	标题	状态	CI状态	创建时间
1	{title}	{status}	{ci}	{date}

undefined

Phase 2: 并行分析/Parallel Analysis

阶段2：并行分析

每个 Issue/PR = 1 个后台任务
Each Issue/PR = 1 background task

任务分配/Assignment:
- Issues → /tmp/{datetime}/issue-{N}.md
- PRs → /tmp/{datetime}/pr-{N}.md

分析内容/Analysis:
1. 问题分类/Classification (bug/feature/question)
2. 优先级评估/Priority (P0/P1/P2)
3. 相关代码定位/Code Location
4. 建议行动方案/Recommended Action

每个Issue/PR = 1个后台任务

任务分配：
- Issues → /tmp/{datetime}/issue-{N}.md
- PRs → /tmp/{datetime}/pr-{N}.md

分析内容：
1. 问题分类 (bug/feature/question)
2. 优先级评估 (P0/P1/P2)
3. 相关代码定位
4. 建议行动方案

Phase 3: 报告汇总/Summary Report

阶段3：报告汇总

markdown

undefined

markdown

undefined

审视报告/Triage Report

审视报告

仓库/Repo: {owner}/{repo} 日期/Date: {date} 分析范围/Scope: {issues_count} Issues, {prs_count} PRs

仓库: {owner}/{repo} 日期: {date} 分析范围: {issues_count} Issues, {prs_count} PRs

P0 - 紧急/Urgent

P0 - 紧急

#	类型/Type	问题/Issue	证据/Evidence	建议/Action
123	Bug	{描述}	[link]	{action}

#	类型	问题	证据	建议
123	Bug	{描述}	[link]	{action}

PR 状态/PR Status

PR状态

#	标题/Title	CI	审查/Review	状态/Status
45	{title}	✅	⏳	待审查/Pending

#	标题	CI	审查	状态
45	{title}	✅	⏳	待审查

建议行动/Recommended Actions

建议行动

优先处理 P0 Issue #123
PR #45 需要额外审查
...

undefined

优先处理P0 Issue #123
PR #45 需要额外审查
...

undefined

输出目录/Output Directory

输出目录

/tmp/{YYYYMMDD-HHmmss}/
├── issue-{N}.md    # Issue 分析报告
├── pr-{N}.md       # PR 分析报告
└── summary.md      # 汇总报告

/tmp/{YYYYMMDD-HHmmss}/
├── issue-{N}.md    # Issue分析报告
├── pr-{N}.md       # PR分析报告
└── summary.md      # 汇总报告

使用示例/Examples

使用示例

示例 1：审视仓库

示例1：审视仓库

用户/User: /审视 cycleuser/Skills

→ 收集开放 Issues 和 PRs/Collect open items
→ 并行分析每个项目/Parallel analysis
→ 生成报告到 /tmp/{datetime}/Generate reports
→ 输出汇总/Output summary

用户: /审视 cycleuser/Skills

→ 收集开放Issues和PRs
→ 并行分析每个项目
→ 生成报告到 /tmp/{datetime}
→ 输出汇总结果

Example 2: Analyze Specific PR

示例2：分析特定PR

用户/User: /analyze https://github.com/owner/repo/pull/123

→ 读取 PR 详情/Read PR details
→ 检查 CI 状态/Check CI status
→ 审查代码变更/Review code changes
→ 生成分析报告/Generate analysis report

用户: /analyze https://github.com/owner/repo/pull/123

→ 读取PR详情
→ 检查CI状态
→ 审查代码变更
→ 生成分析报告

Rules

规则

rules/evidence.md - 证据规则/Evidence Rules
rules/classification.md - 问题分类/Classification
rules/report-format.md - 报告格式/Report Format

rules/evidence.md - 证据规则
rules/classification.md - 问题分类规则
rules/report-format.md - 报告格式规则

配置选项/Configuration

配置选项

参数/Param	默认值/Default	说明/Description
parallel_tasks	10	最大并行任务数/Max parallel tasks
output_dir	/tmp	报告输出目录/Report output dir
include_closed	false	是否包含已关闭/Include closed

参数	默认值	说明
parallel_tasks	10	最大并行任务数
output_dir	/tmp	报告输出目录
include_closed	false	是否包含已关闭的项