메뉴
为一个或多个代码项目做工作流初始化或全量规范巡检：核对 AGENTS、README、CHANGELOG、doc、术语、决策和代码目录现实，先报告再路由。Use when user says 项目初始化, 项目规范巡检, 工作流初始化, 校准 AGENTS, project setup, project bootstrap, scaffold. 不用于代码体检或架构 review；专项地图维护使用 507-map。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Git 提交：在用户明确要求提交时，轻量安全复核变更、精确暂存、运行相关验证并创建真实 Conventional Commit；只做本地提交，推送与对外发布由 507-release 承接。Use when user says commit, 提交, 提交一下, 提交这些改动, 提交代码, Git 提交, commit 一下, 生成并执行提交, 准备提交, 存个档。
对外发布：在用户明确要求发布、推送或发版时，定版本号、打 tag、推送远端，并按项目实际探测的发布渠道（npm、GitHub Release）发布。每个不可逆对外动作执行前都向用户显式确认。Use when user says release, publish, push, 发版, 发布, 推送, 发包, 打 tag, 升版本, 升级版本号, 发新版本, 上线, 发到 npm, 发 GitHub Release。默认只做用户明确点名的对外动作，不自动扩到全部渠道。
根因修复：已明确存在 bug、报错、崩溃、异常、回归或合并冲突时，先建立可重复反馈环，再以最小改动修复根因并验证。Use when user says fix, 修一下, 修 bug, 报错了, 崩了, 跑挂了, 有 bug, 修复报错, 合并冲突, 修复冲突, 修不通, debugging, error, crash, regression.
维护项目地图：以当前代码为证据，建立或校准 README、doc 组织、目录职责、入口与上下游，只修改地图文档。Use when user says map, project map, 梳理项目结构, 项目结构, 更新 README, 补 README, 校准 README, 整理 doc, 整理结构, 文档地图, 目录职责, 分层 README.
交付审查：围绕明确的 commit、branch、diff 或路径检查 Standards、Spec 与 Code Quality，只报告问题、证据和路由。Use when user says review this change, code review, review 一下, 检查, 审查, 审查改动, 审查这次改动, 检查提交, 检查分支, 过一遍代码, 把关, 需求符合度, 交付审查. 不用于主动寻找全库架构机会。
在保持公开契约与可观察行为不变的前提下，对指定代码范围或 507-inspect 报告逐项建立证据、修改并验证。可深入内部模块、抽象与接缝；若需要行为变化则停止并路由到需求实施。Use when user mentions simplify, simplify code, 简化, 简化代码, 行为不变重构, 内部简化, 按报告修改, 处理 inspect 报告, 局部重构, 降低复杂度, 收敛架构摩擦。
| name | 507-setup |
| description | 为一个或多个代码项目做工作流初始化或全量规范巡检：核对 AGENTS、README、CHANGELOG、doc、术语、决策和代码目录现实，先报告再路由。Use when user says 项目初始化, 项目规范巡检, 工作流初始化, 校准 AGENTS, project setup, project bootstrap, scaffold. 不用于代码体检或架构 review；专项地图维护使用 507-map。 |
给具体代码项目建立或校准工作规范。它读取文档、代码结构、测试和配置来判断项目规范是否反映现实，先给巡检报告，再把专项修改路由给职责明确的 skill（技能）。
巡检标准以本技能的 references/project-standard.md 为权威来源；执行前先完整读取该文件。
AGENTS.md、README.md、CHANGELOG.md；doc/README.md、术语表、决策档案和经验笔记；doc/ 的产品、架构、能力参考、路线图、实施方案和归档边界；README.md；AGENTS.md、项目入口、文档地图、术语和决策可能整体失真；只维护某个目录的 README、doc 组织或项目地图时，不跑全量巡检，使用 507-map。
默认只读并输出报告，不直接修改文件。用户确认落地后：
507-map；507-grill 对齐；507-inspect；507-fix，行为不变内部简化转 507-simplify。本 skill 不修改业务代码，不把全面巡检伪装成顺手重构，也不写宿主专属配置。
用户可提供一个或多个项目根目录。若给的是 workspace（工作区），先识别其中的仓库并等待选定目标；不把 workspace 当单个项目，也不自动批量修改全部仓库。
完整读取 references/project-standard.md，再读目标项目。目标项目有明确历史例外时，记录差异、影响和推荐，不凭样例覆盖现状。
读取根目录文件、入口、项目清单、测试/构建配置、doc/ 结构，以及代码目录 README。记录项目类型、当前入口、验证方式和明显缺口。
逐项检查：
AGENTS.md 是否包含项目定位、阅读顺序、边界、验证和特有禁忌；README.md 是否回答是什么、给谁用、怎么运行、目录与入口；CHANGELOG.md 与 Unreleased；doc/README.md 是否说明阅读顺序、当前权威和归档边界；# 项目初始化与巡检报告
## 总览
| 项目 | AGENTS | README | CHANGELOG | doc 地图 | 术语 | 决策 | 分层 README | 验证入口 | 主要缺口 |
## 项目详情
### <project>
- 当前现实：...
- 规范缺口：...
- 文档与代码冲突：...
- 历史例外：...
- 推荐动作：...
## 建议执行顺序
1. ...
每项建议说明依据、影响和对应落地 skill。没有实际内容时不建议创建空目录、空术语表、空决策档案或空经验笔记。
507-map；507-grill；507-inspect；507-prd / 507-issue；507-fix / 507-test / 507-simplify。一次只处理已确认的项目和范围，不跨项目批量改写。
巡检报告必须能把每个结论定位到文件、代码结构或可运行配置。落地后按修改类型检查 Markdown（标记语言）链接、项目命令、差异范围和文档/代码一致性；无法验证时写明缺口。
507-map；代码/测试问题进入 507-fix 或 507-test；需求或治理项进入 507-prd / 507-issue；落地后进入 507-review，用户明确要求提交时再进入 507-commit。507-grill，不自行重写权威规范。