Skip to content

Commit 7f41d80

Browse files
committed
feat: add control-plane support skills
1 parent 9be36a4 commit 7f41d80

38 files changed

Lines changed: 602 additions & 48 deletions

‎README.md‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
2121
- **宿主生命周期护栏**: Claude Code 与 OpenAI Codex 在已支持的 Hook 事件上提供 runtime 护栏;Copilot / JetBrains / Cursor 等无等价本地 Hook 时降级为 instruction-fallback;默认 `safety-only` 仅对危险命令硬拦,流程项提醒放行,`strict` 模式才升级可阻断事件
2222
- **全模式入口检查**: 所有模式在实质任务前显示 PC0~PC7;dev 模式额外执行 PC4 规范雷达与完整合规链
2323
- **项目现实扩展**: 先做语义意图初判,再结合目标项目 Profile、目录与当前任务上下文修正最终路由、产物落点和验证方式
24+
- **支撑型 Skill**: `execution-contract` / `test-router` / `release-verification` 为控制面、多批次、测试路线与正式发版提供可审计支撑,不新增工作流分支
2425
- **执行闭环复审**: dev/fix 完成前执行 ECR 执行闭环复审,交叉验证 CP 产物、报告、daily memory、SUMMARY、diff/commit、测试/探针与 dirty 边界
2526
- **推荐结论**: analyze/audit/report 多建议或多路径场景必须给出推荐结论与推荐理由;无后续动作时明确写“推荐:无后续动作”
2627
- **确认交互降级**: 用户确认先抽象为 ConfirmationRequest,再按宿主能力选择按钮、权限提示、Hook 阻断或文本确认 fallback,不把按钮 UI 承诺为全宿主能力
@@ -59,7 +60,7 @@ npx @vextjs/devcodex init --codex # 仅 Codex adapter
5960
├── copilot-instructions.md ← 默认 Copilot always-on 总则(新增)
6061
├── instructions/ ← Instructions 约束(12 个,含全部工作流规则)
6162
├── agents/ ← Copilot 自定义 Agent(v1.9.8 起恢复默认分发)
62-
├── skills/ ← Skill 详细检查标准(36 个,按需读取,含 spec-governance)
63+
├── skills/ ← Skill 详细检查标准(39 个,按需读取,含 spec-governance 与支撑型 Skill)
6364
├── prompts/ ← Prompt 模板(26 个)
6465
├── hooks/ ← 宿主生命周期 Hook 配置与运行时
6566
│ ├── devcodex.lifecycle.json
@@ -133,6 +134,7 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
133134
- **入口检查全模式显示**:无论 `prod` 还是 `dev`,都会先展示 PC0~PC7;`prod` 只显示基础状态,`dev` 追加规范雷达、合规检查和完成验证。
134135
- **项目现实扩展再路由**:识别用户意图后,会先加载目标项目 Profile,并用项目技术栈、目录结构、当前需求上下文修正最终工作流,避免只按字面关键词执行。
135136
- **Intent Expansion Card**:非 chat 工作流会在 CP1 / 问题确认前形成可审查卡片,记录项目、连续性、模块领域、风险、宿主能力、验证路线、置信度和备选路线。
137+
- **长流程执行契约**:Auto、控制面、多批次、预计修改 ≥10 文件或发布前置任务会触发 ExecutionContract;测试路线不明显时触发 TestRoute;正式发版前触发 ReleaseVerification。
136138
- **边界先确认**:若已判断为新需求切换,且当前工作区还有未提交变更,会先提醒是否应先提交当前变更。
137139
- **报告推荐项**:当报告中存在多个可执行建议或后续路径时,会明确给出推荐结论和推荐理由;没有建议时也会写明“推荐:无后续动作”。
138140
- **确认交互适配**:ConfirmationRequest 是确认语义的统一抽象;Claude Code SDK / VS Code 扩展可用按钮,Hook 宿主可用阻断原因,Cursor / JetBrains 等 fallback 宿主使用文本确认。
@@ -241,7 +243,7 @@ devcodex/
241243
├── instructions.md # 单源规范文件;安装时按平台生成 copilot-instructions.md / CLAUDE.md / AGENTS.md
242244
├── agents/ # Agent 源文件;Copilot 端默认分发,Claude Code 端不分发
243245
├── instructions/ # 全局 Instructions(12 个,含工作流规则摘要,自动注入)
244-
├── skills/ # Skill 详细检查标准(36 个,按 01-common §按需读取表 路由读取)
246+
├── skills/ # Skill 详细检查标准(39 个,按 01-common §按需读取表 路由读取)
245247
├── prompts/ # Prompt 模板(26 个)
246248
├── hooks/ # Workspace Hooks 配置与分发到 `.github/hooks/_runtime/` 的运行时
247249
├── codex/ # Codex Hook 配置源,分发到 `.codex/hooks.json`
@@ -254,6 +256,8 @@ devcodex/
254256

255257
规范治理新增 `spec-governance` Skill:记录类动作先做意图识别,再由 RecordRouter 分流到 `violations / pending-fixes / process-improvements / pending-issues / gap-registry`;规范/控制面/路径/模板/部署/校验链变更后必须执行 SCV(Spec Change Verification),避免修复一处后引入漂移。
256258

259+
控制面与长流程新增三类支撑型 Skill:`execution-contract` 约束 scope / allowedPaths / requiredArtifacts / validationRoute / rollbackPlan,`test-router` 统一选择验证路线,`release-verification` 在正式 tag / publish 前执行 R0~R7 发布验证链。
260+
257261
> ℹ️ 维护者状态文件(本仓库开发过程中累积的 violations/pending-fixes 记录)保存在 `.devcodex/.maintainer-state/`,**不分发**给用户。
258262

259263
## 客户端支持矩阵(Client Support Matrix)
@@ -339,7 +343,7 @@ DevCodex 的 `plugin.json` 声明 `tier: "free"`,所有 Skill 均标注 `tier:
339343
- **可选**:通过 `.github/agents/` 使用 `@devcodex` / `@devcodex-auto` 自定义 Agent 入口
340344
- **Codex**:通过 `AGENTS.md` 自动注入总则,通过 `.agents/skills/` 按需读取技能;不单独维护 `codex/AGENTS.md`
341345

342-
Auto v1.1 当前只在支持 Hook 的宿主里,对显式 `@devcodex-auto` 入口下的白名单路径提供 runtime 级硬保证;JetBrains 等 `instruction-fallback` 宿主仅同步规则语义,不承诺完全等价的自动放行。
346+
Auto v1.1 当前只在支持 Hook 的宿主里,对显式 `@devcodex-auto` 入口下的白名单路径提供 runtime 级硬保证;JetBrains 等 `instruction-fallback` 宿主仅同步规则语义,不承诺完全等价的自动放行。Auto 任务若命中控制面、多批次或预计修改 ≥10 文件,仍须先形成 ExecutionContract 并持续更新实施进度。
343347

344348
## 许可证
345349

‎agents/README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,15 @@
2525
| CP1 需求确认 | 等待用户 | 自动通过 |
2626
| CP2 方案确认 | 等待用户 | 自动通过 |
2727
| CP3 实施计划 | 等待用户 | 自动通过 |
28+
| ExecutionContract | 条件触发 | 控制面 / 多批次 / 预计修改 ≥10 文件 / release 前置任务强制 |
2829
| 可恢复失败 | 正常询问 | 重试 ≤ 2 次,超限切回确认模式 |
2930

3031
## 使用建议
3132

3233
- **默认**:保留 `devcodex init/update` 自动分发的 `.github/agents/`;日常可直接用 Copilot Chat,只有需要显式入口时再 `@devcodex` / `@devcodex-auto`
3334
- **高频维护**:引入 `@devcodex-auto`,在确保仓库可回滚的前提下加速执行
3435
- **严格审查**:引入 `@devcodex`,确保每个关键节点有人工确认
36+
- **长流程任务**:无论确认模式还是 Auto,命中控制面、多批次、预计修改 ≥10 文件或正式发版时,都应把 ExecutionContract / TestRoute / ReleaseVerification 写入报告证据
3537

3638
## 与 Instructions 路径的关系
3739

‎agents/devcodex-auto.agent.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ disable-model-invocation: true
1818
- **hook-enforced 宿主**:仅对白名单路径自动推进;非白名单路径默认回确认模式
1919
- **instruction-fallback 宿主**:如 JetBrains / Cursor,只同步规则语义,不承诺 runtime 级硬放行;支持 Hook 的宿主按白名单执行 runtime 放行
2020
- **白名单范围**:DevCodex 治理文件、`.devcodex/` 产物、README 与 auto 专属回归脚本
21+
- **执行契约**:控制面、多批次、预计修改 ≥10 文件或发布前置任务必须先形成 ExecutionContract,并按 `allowedPaths`、`requiredArtifacts`、`validationRoute` 推进
2122
- S01~S07 / C01 / C10 / C18 **不可豁免**
2223
- 可恢复失败:重试 ≤ 2 次;不可恢复失败:通知用户 ⚠️
2324

‎changelogs/unreleased.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,4 +8,6 @@
88

99
## 2026-05-28
1010

11-
- 当前无未发布条目。
11+
- 新增 `execution-contract`、`test-router`、`release-verification` 三个支撑型 Skill,并同步注册到 `plugin.json`。
12+
- 补强 dev/fix、报告模板、实施计划、实施进度与交付清单对执行契约、测试路由、发布验证和多批次进度的强制消费。
13+
- 更新 README、website 与 Agent 文档,将 Skill 数量同步为 39,并说明 Auto/控制面/多批次/发布任务的闭环约束。

‎instructions/01-common.instructions.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -92,6 +92,8 @@ applyTo: "**"
9292
| 控制面规则变更 | `instructions/`、`skills/`、`prompts/`、`hooks/`、`scripts/validate.js` | L2 | 涉及多真相源或部署副本 → L3 |
9393
| 模板变更 | `prompts/`、对应 `skills/`、对应 `instructions/`、`scripts/validate.js`、样本/示例文档 | L2 | 命中模板-示例-校验链 → L3 |
9494
| 接口契约 / 验证产物变更 | 技术方案、目标接口文档、`.http`、`.cjs`、调用方说明 | L2 | 对外契约 + 多端联调 → L3 |
95+
| 执行契约 / 测试路由 / 发布验证变更 | `skills/execution-contract`、`skills/test-router`、`skills/release-verification`、dev/fix instructions、报告模板、validate | L3 | 默认即强联查 |
96+
| 实施进度跟踪规则变更 | `instructions/02-output-paths`、`instructions/10-dev`、`skills/cp-gate`、`prompts/implementation-progress`、`scripts/validate.js` | L3 | 默认即强联查 |
9597
| 工作区真相源 / 部署副本 / 分发链变更 | `index.js`、`mcp/`、`hooks/_runtime/`、`README.md`、Profile、`.github/`、`.claude/` | L3 | 默认即强联查 |
9698
| 发布 / 版本 / changelog / profile 口径变更 | `package.json`、`plugin.json`、`CHANGELOG.md`、`changelogs/`、`README.md`、Profile、必要公告文档 | L2 | 多真相源口径同步 → L3 |
9799

@@ -144,6 +146,8 @@ applyTo: "**"
144146
> 3. `skills/routing/SKILL.md` 路由表
145147
> 4. `skills/report/SKILL.md` 模板引用表
146148
> 5. `instructions/02-output-paths.instructions.md` §报告子目录列表
149+
>
150+
> ⚠️ **支撑型 Skill**(如 `execution-contract` / `test-router` / `release-verification`)不是工作流子类型,不强制写入子类型路由表;但必须同步 `plugin.json` 注册、触发说明、报告/模板消费点、文档说明与 validate 探针。
147151
148152
| 工作流.子类型 | 必读 Skills |
149153
|-------------|------------|
@@ -172,6 +176,9 @@ applyTo: "**"
172176
| resume | `memory` |
173177

174178
**按需触发 Skills**(不预读,仅在执行中满足条件时读取):
179+
- `execution-contract`:Auto、控制面、预计 ≥10 文件、多批次、发布或需要强边界任务触发
180+
- `test-router`:dev/fix 执行前选择验证路线时触发
181+
- `release-verification`:用户明确要求 release / tag / publish 或版本发布验证时触发
175182
- `api-verification`:PR-5① 标记触发
176183
- `impact-review`:PR-5② 标记触发
177184
- `document-sync`:dev/fix 执行完成后触发

‎instructions/02-output-paths.instructions.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ applyTo: "**"
4242
│ │ └── <关联服务>/ # 每个关联服务独立子目录
4343
│ │ └── 实施方案.md
4444
│ ├── 04-实施计划.md # 🔴 强制(轻计划摘要 / 完整实施计划两档)
45-
│ ├── 05-实施进度.md # ⚠️ 条件(任务跨 2 轮以上会话且已存在 04-实施计划.md 时)
45+
│ ├── 05-实施进度.md # ⚠️ 条件/强触发(跨轮次、多批次、≥10 文件、阻塞、用户要求跟踪时)
4646
│ ├── scripts/ # ⚠️ 条件(有辅助脚本时,可提交)
4747
│ │ └── <用途>.js / <用途>.sh # 数据迁移/数据填充等共享辅助脚本;默认禁止放业务逻辑或网络请求
4848
│ ├── *-接口验证.http # 🔴 强制(有接口变更时)
@@ -72,9 +72,9 @@ applyTo: "**"
7272
| **本地临时脚本豁免** | 仅本地执行、不会提交发布链路、无敏感信息的临时脚本/配置可放入任务目录 `.tmp/local-scripts/` 或保持未提交;允许直接使用局部常量和网络请求,但不得伪装成共享正式产物 |
7373
| **services/ 触发条件(跨服务)** | 需求涉及 ≥2 个服务时在 CP2 后创建;每个 `实施方案.md` 头部**必须**包含反向引用 `> 📎 上级需求:[需求名](../../01-需求概述.md)(入口服务:<服务名>)`;**禁止**各服务各自单独建 `requirements/<需求名>/` 目录(碎片化) |
7474
| **04-实施计划 计划层级** | 默认创建 `04-实施计划.md`;小到中型任务可使用“轻计划摘要”,高风险 / 多模块 / 接口或 Schema 变更 / 跨轮次任务使用“完整实施计划” |
75-
| **05-实施进度 触发条件** | 仅在任务跨 2 轮以上会话、存在明确阻塞或用户要求持续跟踪时创建,且前提是已存在 `04-实施计划.md` |
75+
| **05-实施进度 触发条件** | 小任务不默认创建;当任务跨 2 轮以上会话、存在明确阻塞、用户要求持续跟踪、CP3 计划拆成多批次、预计修改 ≥10 文件,或命中控制面/模板/validate/部署副本联动时必须创建并持续更新,且前提是已存在 `04-实施计划.md` |
7676
| **禁止写入源码目录** | 脚本/测试/辅助文件严禁放入项目源码目录 |
77-
| **强制产物首轮完成** | 01/04 在首轮会话结束前必须创建;其中 `04-实施计划.md` 可按轻计划摘要 / 完整实施计划两档落地;02-技术方案.md 和 实施方案/ 按条件触发;services/ 在 CP2 后按需创建 |
77+
| **强制产物首轮完成** | 01/04 在首轮会话结束前必须创建;其中 `04-实施计划.md` 可按轻计划摘要 / 完整实施计划两档落地;02-技术方案.md 和 实施方案/ 按条件触发;services/ 在 CP2 后按需创建;强触发条件命中时 `05-实施进度.md` 必须在执行前初始化 |
7878
| **需求归档(v1.9.3+)** | 已完成且不再活跃的需求目录下创建空文件 `.archived`;CP gate 扫描跳过含此标记的需求,避免历史需求全局阻断 dev 工作流 |
7979

8080
## 报告路径
@@ -131,6 +131,7 @@ reports/<子目录>/<agent>/YYYYMMDD/NN--<简述>.md
131131
- 不默认打 `git tag`
132132
- 不默认执行 `publish`
133133
2. 用户**明确确认发版**时,才进入正式 release 流程。
134+
- 正式 release 前必须执行 `release-verification` R0~R7。
134135
3. 历史 `CHANGELOG.md` 与 `changelogs/vX.Y.Z.md` 不要求回填迁移;新规则仅约束后续新增变更。
135136

136137
## Git Tag 发布规范

0 commit comments

Comments
 (0)