Skip to content

Commit c1e927f

Browse files
committed
feat: strengthen governance support chains
1 parent 7435bd0 commit c1e927f

27 files changed

Lines changed: 521 additions & 70 deletions

‎README.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +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` 为控制面、多批次、测试路线与正式发版提供可审计支撑,不新增工作流分支
24+
- **支撑型 Skill**: `execution-contract` / `test-router` / `release-verification` / `host-contract-verification` / `source-consumer-sync` 为控制面、多批次、测试路线、宿主契约验证与真相源-消费者同步提供可审计支撑,不新增工作流分支
2525
- **执行闭环复审**: dev/fix 完成前执行 ECR 执行闭环复审,交叉验证 CP 产物、报告、daily memory、SUMMARY、diff/commit、测试/探针与 dirty 边界
2626
- **推荐结论**: analyze/audit/report 多建议或多路径场景必须给出推荐结论与推荐理由;无后续动作时明确写“推荐:无后续动作”
2727
- **确认交互降级**: 用户确认先抽象为 ConfirmationRequest,再按宿主能力选择按钮、权限提示、Hook 阻断或文本确认 fallback,不把按钮 UI 承诺为全宿主能力
@@ -60,7 +60,7 @@ npx @vextjs/devcodex init --codex # 仅 Codex adapter
6060
├── copilot-instructions.md ← 默认 Copilot always-on 总则(新增)
6161
├── instructions/ ← Instructions 约束(12 个,含全部工作流规则)
6262
├── agents/ ← Copilot 自定义 Agent(v1.9.8 起恢复默认分发)
63-
├── skills/ ← Skill 详细检查标准(39 个,按需读取,含 spec-governance 与支撑型 Skill)
63+
├── skills/ ← Skill 详细检查标准(41 个,按需读取,含 spec-governance 与 5 个支撑型 Skill)
6464
├── prompts/ ← Prompt 模板(26 个)
6565
├── hooks/ ← 宿主生命周期 Hook 配置与运行时
6666
│ ├── devcodex.lifecycle.json
@@ -136,7 +136,7 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
136136
- **Intent Expansion Card**:非 chat 工作流会在 CP1 / 问题确认前形成可审查卡片,记录项目、连续性、模块领域、风险、宿主能力、验证路线、置信度和备选路线。
137137
- **意图扩展摘要**:当扩展后路由变化、命中控制面/宿主差异、风险较高或跨会话恢复时,会在用户面输出 3~5 行摘要,便于确认“为什么这样路由”。
138138
- **Hook closure 三态**:Stop/PreCompact 可见回复验证区分 `verified-present`、`verified-missing`、`unverified`;无法解析最终 assistant 内容时只提示无法验证,并给出 payload capture 指引,不再断言“未输出”。
139-
- **长流程执行契约**:Auto、控制面、多批次、预计修改 ≥10 文件或发布前置任务会触发 ExecutionContract;测试路线不明显时触发 TestRoute;正式发版前触发 ReleaseVerification。
139+
- **长流程执行契约**:Auto、控制面、多批次、预计修改 ≥10 文件或发布前置任务会触发 ExecutionContract;测试路线不明显时触发 TestRoute;正式发版前触发 ReleaseVerification;控制面消费链联动时建立 Concept Sync Map;宿主契约变化时触发 `host-contract-verification`。
140140
- **边界先确认**:若已判断为新需求切换,且当前工作区还有未提交变更,会先提醒是否应先提交当前变更。
141141
- **报告推荐项**:当报告中存在多个可执行建议或后续路径时,会明确给出推荐结论和推荐理由;没有建议时也会写明“推荐:无后续动作”。
142142
- **确认交互适配**:ConfirmationRequest 是确认语义的统一抽象;Claude Code SDK / VS Code 扩展可用按钮,Hook 宿主可用阻断原因,Cursor / JetBrains 等 fallback 宿主使用文本确认。
@@ -246,7 +246,7 @@ devcodex/
246246
├── instructions.md # 单源规范文件;安装时按平台生成 copilot-instructions.md / CLAUDE.md / AGENTS.md
247247
├── agents/ # Agent 源文件;Copilot 端默认分发,Claude Code 端不分发
248248
├── instructions/ # 全局 Instructions(12 个,含工作流规则摘要,自动注入)
249-
├── skills/ # Skill 详细检查标准(39 个,按 01-common §按需读取表 路由读取)
249+
├── skills/ # Skill 详细检查标准(41 个,按 01-common §按需读取表 路由读取)
250250
├── prompts/ # Prompt 模板(26 个)
251251
├── hooks/ # Workspace Hooks 配置与分发到 `.github/hooks/_runtime/` 的运行时
252252
├── codex/ # Codex Hook 配置源,分发到 `.codex/hooks.json`
@@ -259,7 +259,7 @@ devcodex/
259259

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

262-
控制面与长流程新增三类支撑型 Skill:`execution-contract` 约束 scope / allowedPaths / requiredArtifacts / validationRoute / rollbackPlan,`test-router` 统一选择验证路线,`release-verification` 在正式 tag / publish 前执行 R0~R7 发布验证链。
262+
控制面与长流程当前有五类支撑型 Skill:`execution-contract` 约束 scope / allowedPaths / requiredArtifacts / consumerScope / validationRoute / deviationLog,`test-router` 统一选择验证路线,`release-verification` 在正式 tag / publish 前执行 R0~R7 发布验证链,`host-contract-verification` 负责 direct replay / fixture replay / bootstrap / workspace guard 证据,`source-consumer-sync` 负责 Concept Sync Map 与当前消费者同步边界。
263263

264264
&gt; ℹ️ 维护者状态文件(本仓库开发过程中累积的 violations/pending-fixes 记录)按 active-root 保存,例如 workspace-namespace 下的 `.devcodex/<project>/data/`,**不分发**给用户。
265265

‎changelogs/unreleased.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,8 @@
1212
- 修复 Hook Stop/PreCompact 可见回复验证:支持 content parts、messages、choices 与 transcript variants,并将 closure 判断升级为 `verified-present` / `verified-missing` / `unverified` 三态。
1313
- 修复 Copilot 多项目 workspace 根每轮 warning:已识别唯一项目后短 TTL 内沿用 sticky `activeProject` 与项目 `mode`,workspace-namespace 提示改为真实 `.devcodex/workspace/profile/` 路径,并避免把 payload `role: "user"`、prompt `user-visible`、URL 片段或前缀项目路径等通用/相邻词误判为同名项目。
1414
- 补充 dev/fix 用户可见意图扩展摘要规则,在控制面、宿主差异、路由修正、风险升高或跨会话 resume 时输出 3~5 行摘要。
15-
- 新增 `execution-contract`、`test-router`、`release-verification` 三个支撑型 Skill,并同步注册到 `plugin.json`。
15+
- 新增 `execution-contract`、`test-router`、`release-verification`、`host-contract-verification`、`source-consumer-sync` 五个支撑型 Skill,并同步注册到 `plugin.json`。
1616
- 补强 dev/fix、报告模板、实施计划、实施进度与交付清单对执行契约、测试路由、发布验证和多批次进度的强制消费。
17-
- 更新 README、website 与 Agent 文档,将 Skill 数量同步为 39,并说明 Auto/控制面/多批次/发布任务的闭环约束。
17+
- 补强 Concept Sync Map 与 HostContractRoute:控制面任务需显式区分真相源、当前消费者、历史镜像、validate 探针、部署副本与黄色偏离边界;宿主契约任务需显式记录 direct replay / fixture replay / bootstrap / workspace guard 证据。
18+
- 更新 README、website 与 Agent/Profile 文档,将 Skill 数量同步为 41,并说明 Auto/控制面/多批次/发布任务的闭环约束。
1819
- 收敛规范资产跨层漂移:统一 `resume` 读取顺序、PC5 的 Codex 部署面、`audit-state` 的 `<audit-root>` 口径、audit 报告收敛头部,以及 `CONTRIBUTING` 模板占位命令;新增 `validate` 的 `V30~V34` 探针并同步 website 当前消费者文案。

‎instructions/01-common.instructions.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ 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 | 默认即强联查 |
95+
| 执行契约 / 测试路由 / 发布验证 / 宿主契约 / 消费链同步变更 | `skills/execution-contract`、`skills/test-router`、`skills/release-verification`、`skills/host-contract-verification`、`skills/source-consumer-sync`、dev/fix instructions、报告模板、validate | L3 | 默认即强联查 |
9696
| 实施进度跟踪规则变更 | `instructions/02-output-paths`、`instructions/10-dev`、`skills/cp-gate`、`prompts/implementation-progress`、`scripts/validate.js` | L3 | 默认即强联查 |
9797
| 工作区真相源 / 部署副本 / 分发链变更 | `index.js`、`mcp/`、`hooks/_runtime/`、`README.md`、Profile、`.github/`、`.claude/` | L3 | 默认即强联查 |
9898
| 发布 / 版本 / changelog / profile 口径变更 | `package.json`、`plugin.json`、`CHANGELOG.md`、`changelogs/`、`README.md`、Profile、必要公告文档 | L2 | 多真相源口径同步 → L3 |
@@ -147,7 +147,7 @@ applyTo: "**"
147147
> 4. `skills/report/SKILL.md` 模板引用表
148148
> 5. `instructions/02-output-paths.instructions.md` §报告子目录列表
149149
>
150-
> ⚠️ **支撑型 Skill**(如 `execution-contract` / `test-router` / `release-verification`)不是工作流子类型,不强制写入子类型路由表;但必须同步 `plugin.json` 注册、触发说明、报告/模板消费点、文档说明与 validate 探针。
150+
> ⚠️ **支撑型 Skill**(如 `execution-contract` / `test-router` / `release-verification` / `host-contract-verification` / `source-consumer-sync`)不是工作流子类型,不强制写入子类型路由表;但必须同步 `plugin.json` 注册、触发说明、报告/模板消费点、文档说明与 validate 探针。
151151
152152
| 工作流.子类型 | 必读 Skills |
153153
|-------------|------------|
@@ -179,6 +179,8 @@ applyTo: "**"
179179
- `execution-contract`:Auto、控制面、预计 ≥10 文件、多批次、发布或需要强边界任务触发
180180
- `test-router`:dev/fix 执行前选择验证路线时触发
181181
- `release-verification`:用户明确要求 release / tag / publish 或版本发布验证时触发
182+
- `host-contract-verification`:宿主事件契约、visible reply、sticky project、workspace guard、bootstrap 证据任务触发
183+
- `source-consumer-sync`:规范源、README/website/Profile/validate/部署副本联动时触发
182184
- `api-verification`:PR-5① 标记触发
183185
- `impact-review`:PR-5② 标记触发
184186
- `document-sync`:dev/fix 执行完成后触发

‎instructions/10-dev.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,7 @@ CP1(需求确认)→ PR-1 内部自检 → CP2(方案确认)→ plan-rev
124124
- 发布 / 版本 / changelog / profile 口径变更
125125
- 若同时涉及多真相源同步、模板-示例-校验链或部署副本,必须升级为 **L3 强联查**,并按 C19 追加交叉验证
126126
- `document-sync`、`impact-review`、`api-verification` 继续作为联查子动作使用,不替代统一联查矩阵
127-
- `execution-contract`、`test-router`、`release-verification` 作为支撑型 Skill:只提供契约、验证路线和发布验证链,不替代 CP、dev/fix 主流程或安全底线
127+
- `execution-contract`、`test-router`、`release-verification`、`host-contract-verification`、`source-consumer-sync` 作为支撑型 Skill:分别提供执行契约、验证路线、发布验证链、宿主契约证据与真相源-消费者同步边界,不替代 CP、dev/fix 主流程或安全底线
128128

129129
### 跨服务需求处理(CP1 前确认)
130130

‎plugin.json‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -215,6 +215,16 @@
215215
"file": "skills/release-verification/SKILL.md",
216216
"tier": "free"
217217
},
218+
{
219+
"id": "host-contract-verification",
220+
"file": "skills/host-contract-verification/SKILL.md",
221+
"tier": "free"
222+
},
223+
{
224+
"id": "source-consumer-sync",
225+
"file": "skills/source-consumer-sync/SKILL.md",
226+
"tier": "free"
227+
},
218228
{
219229
"id": "spec-governance",
220230
"file": "skills/spec-governance/SKILL.md",

‎prompts/delivery-checklist.prompt.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@ applyTo: .devcodex/**/requirements/**
3333
| 8 | ExecutionContract | Auto / 控制面 / 多批次 / 预计修改 ≥10 文件 / release 前置任务 | ☐/N/A |
3434
| 9 | TestRoute | 跨模块、API、Hook/CLI、模板-示例-校验链或测试路线不明显 | ☐/N/A |
3535
| 10 | ReleaseVerification | 用户明确要求 tag / release / publish 或进入正式发版 | ☐/N/A |
36+
| 11 | ConceptSyncMap | 控制面、模板-示例-校验链、README / website / Profile / validate / 部署副本联动 | ☐/N/A |
37+
| 12 | HostContractVerification | Hook / CLI / visible reply / sticky project / workspace guard / bootstrap 相关任务 | ☐/N/A |
3638

3739
## 使用说明
3840

‎prompts/implementation-plan.prompt.md‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ applyTo: .devcodex/**/requirements/**
99
> **触发**: dev 工作流 CP3 阶段
1010
> ⚠️ 本模板只承接任务拆分、实施顺序、前置依赖、验证方式与回滚策略,不重复需求背景或技术方案中的设计论证。
1111
> ⚠️ 生成的 Markdown 实施计划文档必须在头部后补 `## 目录导航`。
12-
> ⚠️ 控制面、Auto、多批次、预计修改 ≥10 文件、模板-示例-校验链或发布前置任务,计划中必须列出 ExecutionContract / TestRoute / ReleaseVerification / 05-实施进度.md 的触发状态与证据。
12+
> ⚠️ 控制面、Auto、多批次、预计修改 ≥10 文件、模板-示例-校验链或发布前置任务,计划中必须列出 ExecutionContract / TestRoute / ReleaseVerification / ConceptSyncMap / HostContractVerification / 05-实施进度.md 的触发状态与证据。
1313
1414
## 计划模式
1515

@@ -90,6 +90,8 @@ applyTo: .devcodex/**/requirements/**
9090
| ExecutionContract | 是 / 否 | Auto / 控制面 / 多批次 / 预计修改 ≥10 文件 / release 前置任务 | scope / allowedPaths / requiredArtifacts / validationRoute / deviationPolicy / rollbackPlan |
9191
| TestRoute | 是 / 否 | 跨模块 / API / Hook / CLI / 模板-示例-校验链 / 测试路线不明显 | changeType / routes / commands / skipReason / blockingLevel |
9292
| ReleaseVerification | 是 / 否 | 用户要求 tag / release / publish 或进入正式发版 | R0~R7 |
93+
| ConceptSyncMap | 是 / 否 | 控制面 / 模板-示例-校验链 / README / website / Profile / validate / 部署副本联动 | sourceOfTruth / currentConsumers / historicalMirrors / validateProbes / deployCopies / yellowDeviationBoundary |
94+
| HostContractVerification | 是 / 否 | Hook / CLI / visible reply / sticky project / workspace guard / bootstrap | hostSurface / eventScope / evidenceMode / visibleReplyEvidence / workspaceGuard / bootstrapScope |
9395
| 05-实施进度.md | 是 / 否 | 跨多轮/多阶段、阻塞、用户要求持续跟踪、多批次、预计修改 ≥10 文件、控制面或模板-校验链任务 | CP 状态 / 批次状态 / 阻塞 / 验证证据 |
9496

9597
## §5 独立验证方式
@@ -100,6 +102,8 @@ applyTo: .devcodex/**/requirements/**
100102
|--------|---------|---------|
101103
| ExecutionContract | 对照 scope / allowedPaths / requiredArtifacts / validationRoute | 无范围偏移,偏移均按 deviationPolicy 处理 |
102104
| TestRoute | 对照变更类型执行对应命令 | 路线覆盖完整,跳过项有依据 |
105+
| ConceptSyncMap | 对照 sourceOfTruth / currentConsumers / historicalMirrors / validateProbes / deployCopies | 当前消费者与探针无漏改,历史镜像边界明确 |
106+
| HostContractVerification | 对照 hostSurface / eventScope / evidenceMode / workspaceGuard | direct replay / fixture / targeted test 证据与声明一致 |
103107
| 模板/规则一致性 | | |
104108
| 样本映射 | | |
105109
| 自动化校验 | | |
@@ -136,6 +140,8 @@ applyTo: .devcodex/**/requirements/**
136140
- [ ] ExecutionContract 已建立并执行(若触发)
137141
- [ ] TestRoute 已建立并覆盖(若触发)
138142
- [ ] ReleaseVerification R0~R7 已完成(若进入正式发版)
143+
- [ ] ConceptSyncMap 已建立并核对当前消费者/探针/部署副本(若触发)
144+
- [ ] HostContractVerification 已建立并核对宿主证据/guard/visible reply(若触发)
139145
- [ ] 05-实施进度.md 已按触发条件持续同步(若触发)
140146
- [ ] document-sync 完成
141147
- [ ] CHANGELOG / unreleased 已按发布状态更新

‎prompts/implementation-progress.prompt.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,8 @@ applyTo: .devcodex/**/requirements/**
6262
| ExecutionContract | Auto / 控制面 / 多批次 / 预计修改 ≥10 文件 / release 前置任务 | ✅/🔄/N/A | |
6363
| TestRoute | 跨模块 / API / Hook / CLI / 模板-示例-校验链 / 测试路线不明显 | ✅/🔄/N/A | |
6464
| ReleaseVerification | tag / release / publish / 发布前验证 | ✅/🔄/N/A | |
65+
| ConceptSyncMap | 控制面 / 模板-示例-校验链 / README / website / Profile / validate / 部署副本联动 | ✅/🔄/N/A | sourceOfTruth / currentConsumers / historicalMirrors / validateProbes / deployCopies / yellowDeviationBoundary |
66+
| HostContractVerification | Hook / CLI / visible reply / sticky project / workspace guard / bootstrap | ✅/🔄/N/A | hostSurface / eventScope / evidenceMode / visibleReplyEvidence / workspaceGuard / bootstrapScope |
6567
| document-sync | 代码/规范/模板/部署副本联动 | ✅/🔄/N/A | |
6668

6769
## 当前轮次工作

‎prompts/report-audit.prompt.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ applyTo: ".devcodex/**/reports/audit/**, .devcodex/**/reports/self-fix/**"
2424
> **审查范围**: 全面体检 / 定向深度 / 修复验证
2525
> **收敛**: 连续 3 轮零发现(所有子类型统一,不区分定向/全面)
2626
> **PCV状态**: ✅已完成 / 🔄进行中
27+
> **控制面证据**: Concept Sync Map / HostContractVerification / SCV / 新增探针 / 黄色偏离 / 部署同步(按适用填写)
2728
```
2829

2930
## §1 审查轮次摘要
@@ -39,6 +40,18 @@ applyTo: ".devcodex/**/reports/audit/**, .devcodex/**/reports/self-fix/**"
3940
**专属维度**:[已执行的维度编号列表]
4041
**N/A 维度**:[标注 N/A 的维度及原因]
4142

43+
## §2.5 控制面同步证据(条件)
44+
45+
> 审查对象涉及规范源、Skill、Hook、CLI、模板、validate、README/website/Profile 或部署副本时填写;其他场景标 `N/A`。
46+
47+
| 项 | 内容 |
48+
|----|------|
49+
| Concept Sync Map | sourceOfTruth / currentConsumers / historicalMirrors / validateProbes / deployCopies / yellowDeviationBoundary |
50+
| HostContractVerification | hostSurface / eventScope / evidenceMode / visibleReplyEvidence / workspaceGuard / bootstrapScope |
51+
| 新增探针 | |
52+
| 黄色偏离 | |
53+
| 部署同步证据 | |
54+
4255
## §3 问题清单
4356

4457
| # | 级别 | 维度 | 位置 | 问题描述 | 合理性 | 可实施性 | 收益 | 验证状态 | 影响范围 | 发现轮次 | 状态 |

0 commit comments

Comments
 (0)