| name | repo-dev-check |
| description | 在 Flow2Spec 双仓自身开发时自查「写盘边界 + 双仓一致 + 分发口径」：识别当前 pending 改动是否落错地方（应改 templates 却动了配置根、本仓专属却写进 templates、只改单侧仓库），并给出修复动作。触发词：dev-workflow 自查、写盘边界、双仓漂移、templates vs 配置根、分发检查。 |
repo-dev-check（本仓开发纪律自查）
适用：仅在 Flow2Spec 双仓自身（Flow2Spec-public / flow2spec）里开发时启用。下游项目不会拿到本 SKILL——它只存在于本仓的 .claude/skills/、.cursor/skills/、.codex/skills/，从不进 templates/。
单一事实源：本 SKILL 依据 f2s-dev-workflow-constraints 规则执行（Claude：.claude/rules/repo-dev-workflow-constraints.md；Cursor：.cursor/rules/repo-dev-workflow-constraints.mdc；Codex：.codex/topics/repo-dev-workflow-constraints.md）。步骤 0 必须 Read 该规则全文。
触发场景
- 用户显式说「跑 dev-workflow 自查 / 检查双仓 / 检查是不是改错地方了」；
- 用户在 Flow2Spec 双仓内、Agent 即将提交前主动自查；
- Agent 发现自己刚做了配置根下的
Edit / Write，或只在单侧仓库落了盘，须补做本自查；
- Agent 在改开发纪律相关的规则 / skill / topic 时（比如本文件、
f2s-dev-workflow-constraints）。
不触发：下游项目内、纯业务代码修改无 template/config-root 交集时。
前置
步骤 0：Read .claude/rules/repo-dev-workflow-constraints.md（Cursor：.cursor/rules/*.mdc；Codex：.codex/topics/*.md）全文。不 Read 直接开跑属违规。
编排
- 主 agent 通篇执行：本 skill 无重 IO 操作，无需拆子。
- 配置：不受
flow2spec.config.json.subAgent 约束（无论 true / false 都主 agent 跑）。
- 写权：本 skill 不主动落盘业务文件；只做判定 + 建议；确实需要写盘时逐条回到具体 skill（如
f2s-git-commit）流程。
步骤
步骤 1：定位当前仓 + git 摸底
- 判断当前工作目录是否在 Flow2Spec 双仓内：
Bash 跑 git remote -v 查看，若 URL 含 github.com/Lands-1203/Flow2Spec 或 git.dev.sh.ctripcorp.com/trainH5/flow2spec 则算作双仓，否则报错退出（下游项目不该跑本 skill）。
Bash：git status -s | grep -v DS_Store 列出所有未提交改动。Bash：ls "/Users/<user>/Desktop/项目/ai/flow2spec 双仓/"（或用户当前放双仓的父目录）确认另一侧仓库是否存在于本机。用户不用双父目录时，跳过对侧检查、只做本侧自查（并在摘要提示）。
步骤 2：写盘边界判定（对每份 pending 文件）
对步骤 1 列出的每一份改动文件，套下表判定：
| 文件路径模式 | 是否合规 | 判定依据 |
|---|
templates/zh-CN/** 或 templates/en-US/** | ✅ 合规 | 生产侧唯一入口 |
docs/** / lib/** / cli.js / scripts/** / package.json | ✅ 合规 | 包源码 |
.Knowledge/** | ✅ 合规 | 本仓自身知识库 |
.claude/rules/repo-dev-workflow-constraints.md | ✅ 合规 | 本仓专属手写规则（templates 无对应源） |
.claude/skills/repo-dev-check/** | ✅ 合规 | 本仓专属手写 skill（templates 无对应源） |
.cursor/rules/repo-dev-workflow-constraints.mdc | ✅ 合规 | 同上（Cursor 端） |
.cursor/skills/repo-dev-check/** | ✅ 合规 | 同上 |
.codex/topics/repo-dev-workflow-constraints.md | ✅ 合规 | 同上（Codex 端） |
.codex/skills/repo-dev-check/** | ✅ 合规 | 同上 |
.claude/rules/<其它>.md / .cursor/rules/<其它>.mdc / .codex/topics/<其它>.md | ❌ 违规 | 有 templates 对应源 → 应改 templates/{zh-CN,en-US}/rules/<其它>.md |
.claude/skills/<其它>/** / .cursor/skills/<其它>/** / .codex/skills/<其它>/** | ❌ 违规 | 有 templates 对应源 → 应改 templates/{zh-CN,en-US}/skills/<其它>/SKILL.md |
根 AGENTS.md | ❌ 违规 | 由 buildCodexAgentsMd(templatesDir, ...) 从 templates 拼装 → 应改 templates/{zh-CN,en-US}/AGENTS.md |
.claude/hooks/** / .cursor/hooks/** / .codex/hooks/** / .claude/settings.json / .cursor/hooks.json / .codex/hooks.json | ❌ 违规 | init 产物 → 需求要改的话改 lib/init.js 或 templates/ |
.claude/memory/** / LOCAL_CONTEXT.md | ⚠️ 本地态 | 不入库，不受约束（但提醒别 commit） |
判定捷径：在 templates/{zh-CN,en-US}/ 里能找到对应源 ⇒ 属「下游会用到的 init 产物」，禁止手改配置根。否则属本仓专属手写内容，配置根版本就是原始版本。
步骤 3：双仓漂移判定
须双父目录都存在才能做这步。对上一步判定「合规」的每份文件（不含本地态）：
- 计算对侧仓库对应路径（
Flow2Spec-public/foo/bar.md ↔ flow2spec/foo/bar.md）。
Bash：diff <(sed 's/@double-codeing\/flow2spec/@ctrip\/flow2spec/g' 本侧) 对侧 或反向。- 漂移标志：diff 非空 → 提示「双仓漂移：<路径>」；建议动作：把改动同步到对侧同名路径。
- 例外：
package.json 的 version 字段、包名字段允许天然不等；README* 的 remote URL 段允许不等。
步骤 4：分发口径检查
- 检查用户最近对话里是否有「跑 init / sync / 分发」的明确指令。没有则：Agent 禁止主动跑
flow2spec init / npm run sync:agents。
- 若本轮已完成 templates 侧改动、用户未明示分发，摘要末尾提示：
已改 templates；请你执行 npm run sync:agents 或 node ./cli.js init codex claude cursor 分发到配置根。
- 若本轮改了本仓专属配置根文件（本规则、本 skill 等），点名「本仓专属手写；无需 init 分发」。
步骤 5：输出摘要
按以下模板输出（都写完为止）：
## repo-dev-check 结果
### 当前仓
- 仓库：Flow2Spec-public / flow2spec / 非双仓（退出）
### 写盘边界（步骤 2）
- ✅ 合规改动：<数量>
- <路径 1>
- <路径 2>
- ❌ 违规改动：<数量>
- <路径>：违规原因（应改 templates/{zh-CN,en-US}/... 的哪份）
- ⚠️ 本地态（不入库）：<路径>
### 双仓漂移（步骤 3）
- 双父目录：存在 / 缺失（跳过对侧检查）
- 漂移文件：<数量>
- <路径>：本侧 vs 对侧（附首条差异）
- 一致文件：<数量>
### 分发建议（步骤 4）
- 是否有用户明示 init 指令：是 / 否
- 本轮涉及 templates 改动：是 / 否
- **建议**：<「请你跑 npm run sync:agents ...」 / 「本轮改动均为本仓专属，无需分发」 / 「等你补完对侧改动再讨论分发」>
完成后自检
- 步骤 0 是否 Read 了
f2s-dev-workflow-constraints 规则全文？
- 步骤 1 是否
git remote -v 确认当前仓是 Flow2Spec 双仓其一？
- 步骤 2 是否逐份改动都套了表判定，未凭记忆断言？
- 步骤 3 是否在双父目录存在时都跑了对侧 diff（不是抽查）？
- 步骤 4 分发建议是否明确指出：是否需要 sync:agents、由谁跑？
- 摘要是否覆盖所有 5 节，且违规 / 漂移条目都点了名（不是"疑似"）？
禁止项
- 禁止在下游项目内调用本 skill——它只对 Flow2Spec 双仓生效。
- 禁止跳过步骤 0 直接判定；须先读规则全文再对照。
- 禁止 Agent 主动执行
flow2spec init / npm run sync:agents 分发命令；本 skill 只出建议。
- 禁止把「本仓专属手写内容」写进
templates/；也禁止把「templates 有源的规则/技能」的配置根版本视为本仓专属。
