Agent Skills › Terry-Mao/AICodingFlow › review-spec-local

review-spec-local

GitHub

在本地执行规范审查工作流，准备与CI一致的审查输入快照并委托给review-spec进行审查。支持从当前分支或关联PR获取描述和差异，生成符合contract的review.json输出，并严格验证输出格式及确保不修改仓库文件。

.agents/skills/review-spec-local/SKILL.md Terry-Mao/AICodingFlow

Trigger Scenarios

用户希望在推送代码前对本地规格变更进行审查需要模拟CI审查环境以提前发现规格问题

Install

npx skills add Terry-Mao/AICodingFlow --skill review-spec-local -g -y

More Options

Non-standard path

npx skills add https://github.com/Terry-Mao/AICodingFlow/tree/main/.agents/skills/review-spec-local -g -y

Use without installing

npx skills use Terry-Mao/AICodingFlow@review-spec-local

指定 Agent (Claude Code)

npx skills add Terry-Mao/AICodingFlow --skill review-spec-local -a claude-code -g -y

安装 repo 全部 skill

npx skills add Terry-Mao/AICodingFlow --all -g -y

预览 repo 内 skill

npx skills add Terry-Mao/AICodingFlow --list

SKILL.md

Frontmatter

{
    "name": "review-spec-local",
    "description": "Run the repository spec review workflow locally from the current branch using temporary-directory snapshots and the same review.json contract as CI."
}

review-spec-local

Use this skill after local spec work and before pushing or creating a spec PR. It prepares the same review inputs used by the GitHub review workflow, then delegates review logic to review-spec.

Workflow

From the repository root, prepare local review inputs. This prefers the GitHub PR associated with the current branch for pr_description.txt, then falls back to locally built PR metadata when the GitHub PR cannot be fetched. The pr_diff.txt snapshot is built from the local worktree diff. The command writes snapshots to a temporary directory and prints the selected review skill as skill=<path> plus exact file paths:
```
python3 .github/scripts/prepare_local_review_inputs.py
```
Read the skill path printed by the command.
Follow the selected skill exactly. It will apply any referenced local companion guidance when present.
Use only the printed snapshot paths as review inputs:
- pr_description_path
- pr_diff_path
Inspect repository files from the current repository root when the review skill needs source context.
Write the review output only to the printed review_path.

Validate the review output:

python3 .github/scripts/validate_review_json.py <pr_diff_path> <review_path>

Validate that the review phase did not mutate repository files:

python3 .github/scripts/validate_local_review_result.py \
  --baseline-status <baseline_status_path>

Safety Rules

After input preparation, do not run git add, git commit, git push, gh, or GitHub API commands.
Do not post comments or mutate GitHub state.
Do not modify source, workflow, tests, specs, or skill files.
If review discovers issues, report them through review.json; do not fix specs during this skill.