depa-codument 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +262 -0
- package/package.json +63 -0
- package/src/cli/commands/archive.ts +519 -0
- package/src/cli/commands/decisions.ts +123 -0
- package/src/cli/commands/engineering.ts +105 -0
- package/src/cli/commands/init.ts +54 -0
- package/src/cli/commands/list.ts +73 -0
- package/src/cli/commands/modeling.ts +105 -0
- package/src/cli/commands/show.ts +238 -0
- package/src/cli/commands/status.ts +140 -0
- package/src/cli/commands/upgrade-track.ts +385 -0
- package/src/cli/commands/upgrade-workspace.ts +138 -0
- package/src/cli/commands/validate.ts +330 -0
- package/src/cli/engineering/config.ts +68 -0
- package/src/cli/engineering/lint.ts +58 -0
- package/src/cli/engineering/merge.ts +172 -0
- package/src/cli/engineering/registry.ts +230 -0
- package/src/cli/engineering/schema.ts +126 -0
- package/src/cli/engineering/validate.ts +286 -0
- package/src/cli/index.ts +136 -0
- package/src/cli/modeling/config.ts +68 -0
- package/src/cli/modeling/lint.ts +58 -0
- package/src/cli/modeling/merge.ts +172 -0
- package/src/cli/modeling/registry.ts +229 -0
- package/src/cli/modeling/schema.ts +160 -0
- package/src/cli/modeling/validate.ts +282 -0
- package/src/cli/utils/index.ts +941 -0
- package/src/cli/utils/install.ts +291 -0
- package/src/cli/utils/spec-xml.ts +673 -0
- package/src/cli/utils/track-time.ts +75 -0
- package/src/cli/utils/vfs.ts +102 -0
- package/src/templates/codument/README.md +59 -0
- package/src/templates/codument/attractors/product.md +17 -0
- package/src/templates/codument/attractors/project.md +10 -0
- package/src/templates/codument/backlog/README.md +33 -0
- package/src/templates/codument/config/attractor-profiles.xml +31 -0
- package/src/templates/codument/config/engineering.xml +22 -0
- package/src/templates/codument/config/modeling.xml +22 -0
- package/src/templates/codument/config/operation-hooks.xml +55 -0
- package/src/templates/codument/memory/README.md +13 -0
- package/src/templates/codument/missions/README.md +125 -0
- package/src/templates/codument/sop/README.md +14 -0
- package/src/templates/codument/std/AGENTS.md +82 -0
- package/src/templates/codument/std/attractors/depa-attractor.md +572 -0
- package/src/templates/codument/std/attractors/knowledge-tiers.md +128 -0
- package/src/templates/codument/std/attractors/model-driven-docs.md +293 -0
- package/src/templates/codument/std/attractors/project-memory.md +48 -0
- package/src/templates/codument/std/docs-impl-fractal/index.md +110 -0
- package/src/templates/codument/std/docs-modeling-fractal/index.md +156 -0
- package/src/templates/codument/std/kernel-pointer.md +19 -0
- package/src/templates/codument/std/operations/README.md +30 -0
- package/src/templates/codument/std/operations/_operation-spec.md +41 -0
- package/src/templates/codument/std/operations/archive-mission.md +66 -0
- package/src/templates/codument/std/operations/archive-track.md +238 -0
- package/src/templates/codument/std/operations/artifact-sync.md +172 -0
- package/src/templates/codument/std/operations/discuss-phase.md +214 -0
- package/src/templates/codument/std/operations/discuss.md +87 -0
- package/src/templates/codument/std/operations/docs-bootstrap.md +148 -0
- package/src/templates/codument/std/operations/gap-loop.md +301 -0
- package/src/templates/codument/std/operations/impl-mission.md +167 -0
- package/src/templates/codument/std/operations/impl-quick.md +79 -0
- package/src/templates/codument/std/operations/impl-track.md +537 -0
- package/src/templates/codument/std/operations/migrate.md +337 -0
- package/src/templates/codument/std/operations/plan-mission.md +230 -0
- package/src/templates/codument/std/operations/plan-track-wave.md +231 -0
- package/src/templates/codument/std/operations/plan-track.md +579 -0
- package/src/templates/codument/std/operations/revise-track.md +136 -0
- package/src/templates/codument/std/operations/validate.md +339 -0
- package/src/templates/codument/std/operations/verify.md +184 -0
- package/src/templates/codument/std/root-agents.md +39 -0
- package/src/templates/codument/std/sop/questioning.md +98 -0
- package/src/templates/codument/std/sop/tdd.md +26 -0
- package/src/templates/codument/std/sop/validation.md +25 -0
- package/src/templates/codument/std/sop/wave-exec.md +42 -0
- package/src/templates/codument/std/sop/workflow.md +35 -0
- package/src/templates/codument/std/spec/behavior-delta.md +36 -0
- package/src/templates/codument/std/spec/behavior-registry.md +42 -0
- package/src/templates/codument/std/spec/engineering-delta.md +68 -0
- package/src/templates/codument/std/spec/engineering-node-schema.md +86 -0
- package/src/templates/codument/std/spec/engineering-registry.md +82 -0
- package/src/templates/codument/std/spec/flow-notation.md +93 -0
- package/src/templates/codument/std/spec/folder-manifest.md +99 -0
- package/src/templates/codument/std/spec/mission-xml-spec.md +249 -0
- package/src/templates/codument/std/spec/modeling-delta.md +85 -0
- package/src/templates/codument/std/spec/modeling-node-schema.md +183 -0
- package/src/templates/codument/std/spec/modeling-registry.md +49 -0
- package/src/templates/codument/std/spec/track-xml-spec.md +272 -0
- package/src/templates/codument/std/spec/xnl-format.md +301 -0
- package/src/templates/codument/workflows/README.md +15 -0
- package/src/templates/manifest.ts +177 -0
- package/src/templates/skills/README.md +38 -0
- package/src/templates/skills/codument-archive/SKILL.md +17 -0
- package/src/templates/skills/codument-archive-mission/SKILL.md +17 -0
- package/src/templates/skills/codument-archive-track/SKILL.md +17 -0
- package/src/templates/skills/codument-artifact-sync/SKILL.md +17 -0
- package/src/templates/skills/codument-code-quality-score/SKILL.md +67 -0
- package/src/templates/skills/codument-decision-tree/SKILL.md +40 -0
- package/src/templates/skills/codument-discuss/SKILL.md +17 -0
- package/src/templates/skills/codument-discuss-phase/SKILL.md +17 -0
- package/src/templates/skills/codument-docs-bootstrap/SKILL.md +17 -0
- package/src/templates/skills/codument-gap-loop/SKILL.md +17 -0
- package/src/templates/skills/codument-impl-mission/SKILL.md +17 -0
- package/src/templates/skills/codument-impl-quick/SKILL.md +17 -0
- package/src/templates/skills/codument-impl-track/SKILL.md +17 -0
- package/src/templates/skills/codument-implement/SKILL.md +14 -0
- package/src/templates/skills/codument-migrate/SKILL.md +17 -0
- package/src/templates/skills/codument-modeling-engineering-e2e/SKILL.md +74 -0
- package/src/templates/skills/codument-plan-mission/SKILL.md +17 -0
- package/src/templates/skills/codument-plan-track/SKILL.md +17 -0
- package/src/templates/skills/codument-plan-track-wave/SKILL.md +17 -0
- package/src/templates/skills/codument-revise-track/SKILL.md +17 -0
- package/src/templates/skills/codument-track/SKILL.md +14 -0
- package/src/templates/skills/codument-validate/SKILL.md +17 -0
- package/src/templates/skills/codument-verify/SKILL.md +17 -0
- package/src/types/text-assets.d.ts +9 -0
- package/src/version.ts +1 -0
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-code-quality-score
|
|
3
|
+
description: 对 codument track 实现或 modeling+engineering E2E 生成的代码做证据化质量评分和评价。用于运行 scripts/score-e2e-code-quality.ts,结合测试、typecheck、lint、build、codument validate、modeling/engineering validate、架构边界、可维护性和安全/数据一致性输出 0-100 分、等级、问题和改进建议。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · Code Quality Score
|
|
7
|
+
|
|
8
|
+
使用本 skill 时,先运行确定性评分脚本,再补人工/agent 复核。评分必须带证据,不只给一句主观评价。
|
|
9
|
+
|
|
10
|
+
## 快速运行
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
bun run scripts/score-e2e-code-quality.ts /tmp/cdt-me-e2e-ecommerce-1234 --track <track-id>
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
指定输出目录:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
bun run scripts/score-e2e-code-quality.ts <workspace> --track <track-id> --out <workspace>/reports
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
输出:
|
|
23
|
+
|
|
24
|
+
```text
|
|
25
|
+
reports/code-quality.json
|
|
26
|
+
reports/code-quality.md
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## 评分维度
|
|
30
|
+
|
|
31
|
+
总分 0-100,脚本按以下维度给出初评:
|
|
32
|
+
|
|
33
|
+
- Runnable behavior:项目是否可构建/可运行,codument track 是否可 validate。
|
|
34
|
+
- Tests and type safety:是否有测试,测试和 typecheck 是否通过。
|
|
35
|
+
- Architecture fit:源码结构是否存在,是否和 modeling/engineering deltas 对齐。
|
|
36
|
+
- Codument alignment:track、modeling validate、engineering validate 是否通过。
|
|
37
|
+
- Maintainability:lint、模块拆分、文件组织。
|
|
38
|
+
- Safety and data boundaries:输入校验、权限/策略、事实源/写路径边界、工程规则。
|
|
39
|
+
|
|
40
|
+
## 人工复核要求
|
|
41
|
+
|
|
42
|
+
读 `code-quality.md` 后补充:
|
|
43
|
+
|
|
44
|
+
- 哪些分数来自机器证据,哪些是人工判断。
|
|
45
|
+
- 关键高风险问题按严重度排序。
|
|
46
|
+
- 代码是否真的满足 behavior case,而不是只让测试通过。
|
|
47
|
+
- modeling 的事实源、状态机、组件 IO 是否在代码中有对应实现。
|
|
48
|
+
- engineering 的 howto/rules/reference/code-map 是否被实现遵循。
|
|
49
|
+
- 如果无法运行某命令,明确标记为未验证,不要当作通过。
|
|
50
|
+
|
|
51
|
+
## 推荐输出格式
|
|
52
|
+
|
|
53
|
+
```markdown
|
|
54
|
+
总分:82/100(B)
|
|
55
|
+
|
|
56
|
+
主要问题:
|
|
57
|
+
- P1: ...
|
|
58
|
+
- P2: ...
|
|
59
|
+
|
|
60
|
+
证据:
|
|
61
|
+
- `bun test`: pass
|
|
62
|
+
- `codument modeling validate --deltas <track>`: pass
|
|
63
|
+
- ...
|
|
64
|
+
|
|
65
|
+
建议:
|
|
66
|
+
- ...
|
|
67
|
+
```
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-decision-tree
|
|
3
|
+
description: 为 plan-track / plan-mission / discuss 做有界决策树式澄清:先查代码和 codument owner 文档,生成 analysis/decision-tree.md,按 severity=auto|light|normal|deep 控制是否提问,并回写 decisions.md。需要强化规划问答、无问答高自主规划、或整理阻塞决策时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · decision-tree
|
|
7
|
+
|
|
8
|
+
用于给 track / mission / discuss 增加有界决策树式澄清。权威规则在工作区:
|
|
9
|
+
|
|
10
|
+
- `@/codument/std/sop/questioning.md`
|
|
11
|
+
- `@/codument/std/attractors/knowledge-tiers.md`
|
|
12
|
+
|
|
13
|
+
## 输入
|
|
14
|
+
|
|
15
|
+
- 当前 track 或 mission 目录,或待规划目标。
|
|
16
|
+
- 可选 severity:`auto | light | normal | deep`;未指定默认 `light`。
|
|
17
|
+
|
|
18
|
+
## 执行
|
|
19
|
+
|
|
20
|
+
1. 先读取本地代码、测试、schema、config、behaviors、modeling、engineering、decisions、archive;能查证的问题不要问用户。
|
|
21
|
+
2. 写入或更新 `analysis/decision-tree.md`:
|
|
22
|
+
- Root Question
|
|
23
|
+
- Severity
|
|
24
|
+
- Decision Frontier
|
|
25
|
+
- Assumptions
|
|
26
|
+
3. 对非 auto 模式,只问当前 frontier 中最阻塞下游产物、且无法查证的问题;每题给推荐答案、选项、取舍和无回复默认。
|
|
27
|
+
4. 对 auto 模式,不提问;选择保守默认并写入 Assumptions / Evidence。
|
|
28
|
+
5. 把稳定决策回写 `decisions.md`,推荐字段:
|
|
29
|
+
- Parent
|
|
30
|
+
- Blocks
|
|
31
|
+
- Evidence
|
|
32
|
+
- Confidence
|
|
33
|
+
- Reversibility
|
|
34
|
+
- Durable candidate
|
|
35
|
+
|
|
36
|
+
## 输出
|
|
37
|
+
|
|
38
|
+
- `analysis/decision-tree.md`
|
|
39
|
+
- 更新后的 `decisions.md`
|
|
40
|
+
- 必要时提示运行 `codument decisions validate <track-id>`
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-discuss
|
|
3
|
+
description: 创建 track/mission 前的上下文讨论与任务尺度分流;读取 Codument 知识和项目文件,临时使用 codument/analysis,建议 quick/track/mission/blocked,不创建 discussion workspace。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · discuss
|
|
7
|
+
|
|
8
|
+
这是 codument **discuss** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/discuss.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行;它会搜集上下文、使用 `codument/analysis/` 作为临时 scratch,并输出 `quick|track|mission|blocked` 的下一步建议。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化。
|
|
15
|
+
- **用法**:讨论 `<尚未确定 quick/track/mission 的需求>`。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/discuss.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-discuss-phase
|
|
3
|
+
description: 对已创建 track 的某个 phase 做执行前讨论,细化 TaskSpace、验收、门控、调度和风险,并把稳定知识当轮收敛进 owner 文档。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · discuss-phase
|
|
7
|
+
|
|
8
|
+
这是 codument **discuss-phase** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/discuss-phase.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行;track.xml 格式见 `@/codument/std/spec/track-xml-spec.md`,知识晋升/路由见 `@/codument/std/attractors/knowledge-tiers.md` 与 `model-driven-docs.md`(均由 body 按需引用)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化,且目标 track 已创建。
|
|
15
|
+
- **用法**:讨论 track phase: `<track-id>` [phase](缺省下一个未完成 phase)。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/discuss-phase.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-docs-bootstrap
|
|
3
|
+
description: 把现存项目现状一次性总结进分形 docs——docs/modeling(领域本体,领域中立)+ docs/impl(实现知识),并补目录职责块、记不确定项。首次为项目建立 docs 知识体系时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · docs-bootstrap
|
|
7
|
+
|
|
8
|
+
这是 codument **docs-bootstrap** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/docs-bootstrap.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行(盘点→写 modeling→写 impl→补目录职责→记不确定);分形规范见 `@/codument/std/docs-{modeling,impl}-fractal/index.md`,目录职责见 `@/codument/std/spec/folder-manifest.md`(均由 body 引用)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化。docs 同步能力未开也可纯手动跑。
|
|
15
|
+
- **用法**:引导 docs: `[scope]`(缺省全项目)。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/docs-bootstrap.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-gap-loop
|
|
3
|
+
description: 有界目标对比纠偏(双角色:父层编排 + fresh 子代理)——对比实现 vs 目标、写 gap 报告、修复、复检直到 NO_GAP 或耗尽轮数。需要把实现拉回目标、或某 scope 配了 cdt:GapLoop 时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · gap-loop
|
|
7
|
+
|
|
8
|
+
这是 codument **gap-loop** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/gap-loop.md`
|
|
11
|
+
|
|
12
|
+
⚠️ 本操作是**双角色协议**:读 body 后**第一动作是判定自己是父层编排代理还是本轮 fresh 子代理**,只执行对应章节。完整规程见 `@/codument/std/operations/gap-loop.md`(body 引用)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化,目标 track 已在实现中。
|
|
15
|
+
- **用法**:校验 track: `<track-id>` [--phase <id>] [--background <path>]。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/gap-loop.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-impl-mission
|
|
3
|
+
description: 执行或续跑 active mission——按 mission.xml 的 DAG,用 MissionPlanner/Observer/Reconciler/Applier 四个控制论 + DEPA actor 观察实际态、执行一个有界动作、允许受控重规划。开始或继续长周期 mission 时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · impl-mission
|
|
7
|
+
|
|
8
|
+
这是 codument **impl-mission** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/impl-mission.md`
|
|
11
|
+
|
|
12
|
+
mission.xml 规范见 `@/codument/std/spec/mission-xml-spec.md`;流程块规范见 `@/codument/std/spec/flow-notation.md`。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化,目标 mission 已在 `pending/` 或 `active/`。
|
|
15
|
+
- **用法**:实现 mission: `<mission-id>`。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/impl-mission.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-impl-quick
|
|
3
|
+
description: 基于 Codument 知识上下文和项目工程文件快速实现小改动;适用于 bug、测试、局部重构、非破坏性配置修正。不创建 track/mission,发现超出 quick 范围时转建议 plan-track/plan-mission。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · impl-quick
|
|
7
|
+
|
|
8
|
+
这是 codument **impl-quick** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/impl-quick.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行(加载 Codument owner 知识、判断 quick 边界、实现最小变更、运行验证、报告是否有需要沉淀到 modeling/engineering 的长期知识)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化。
|
|
15
|
+
- **用法**:快速实现 `<小改动描述>`。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/impl-quick.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-impl-track
|
|
3
|
+
description: 按 track.xml 的 TaskSpace + Schedule 执行实现——编排 fresh 子代理逐任务推进、回写状态、跑生命周期 hook、支持中断续跑。开始或继续实现已批准的 track 时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · impl-track
|
|
7
|
+
|
|
8
|
+
这是 codument **impl-track** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/impl-track.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行(遍历 phase、层内顺序/DAG 调度、派发子代理、回写 status、跑 cdt: hook、续跑检测);方法论见 `@/codument/std/sop/{tdd,wave-exec,gap-loop}.md`(均由 body 按需引用)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化,目标 track 提案已批准。
|
|
15
|
+
- **用法**:实现 track: `<track-id>` [phase](缺省从第一个未完成 phase 起)。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/impl-track.md` 为准。
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-implement
|
|
3
|
+
description: "[已更名为 codument-impl-track] 按 track.xml 的 TaskSpace + Schedule 执行实现——编排 fresh 子代理逐任务推进、回写状态、跑生命周期 hook、支持中断续跑。开始或继续实现已批准的 track 时使用。"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · implement(别名 → impl-track)
|
|
7
|
+
|
|
8
|
+
本 skill 已更名为 **codument-impl-track**。旧名 `codument-implement` 保留为别名壳,触发后仍路由到新逻辑——权威提示词见:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/impl-track.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行。新引用请用 `codument-impl-track`。
|
|
13
|
+
|
|
14
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/impl-track.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-migrate
|
|
3
|
+
description: 迁移旧 codument 资产到新标准——旧 plan.xml→track.xml、Markdown specs→XML behaviors 登记表、旧 archive 目录布局。升级旧 codument 项目到当前标准时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · migrate
|
|
7
|
+
|
|
8
|
+
这是 codument **migrate** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/migrate.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行(统一覆盖:archive 布局迁移 + Markdown specs→XML behaviors 迁移);目标格式见 `@/codument/std/spec/behavior-registry.md`、`behavior-delta.md`、`track-xml-spec.md`(均由 body 引用)。旧资产保留到 `codument/legacy/`。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化。
|
|
15
|
+
- **用法**:迁移 `[archive | specs | all]`。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/migrate.md` 为准。
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-modeling-engineering-e2e
|
|
3
|
+
description: 运行 codument modeling + engineering 真实大模型端到端验证。用于验证 init 后开启 modeling/engineering、真实 agent 创建 track 并生成 modeling_deltas/engineering_deltas、实现代码、运行 validate 与代码质量评分的完整流程;也用于复跑 todo/ecommerce/blog 三业务题目或自定义业务题目。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · Modeling + Engineering E2E
|
|
7
|
+
|
|
8
|
+
使用本 skill 时,在 codument 仓库根运行真实 E2E 脚本;不要把真实大模型 E2E 放进普通 `bun test`。
|
|
9
|
+
|
|
10
|
+
## 快速运行
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
MODE=plan-only AGENT=codex MODEL=gpt-5.5 bash scripts/verify-modeling-engineering-e2e.sh ecommerce
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
完整链路(会继续让 agent 写代码并评分):
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
MODE=full AGENT=codex MODEL=gpt-5.5 bash scripts/verify-modeling-engineering-e2e.sh ecommerce
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
三业务题目:
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
for topic in todo ecommerce blog; do
|
|
26
|
+
MODE=plan-only AGENT=codex MODEL=gpt-5.5 bash scripts/verify-modeling-engineering-e2e.sh "$topic"
|
|
27
|
+
done
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
自定义题目:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
PRODUCT="$(cat product.md)" MODE=full bash scripts/verify-modeling-engineering-e2e.sh custom
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## 运行模式
|
|
37
|
+
|
|
38
|
+
- `MODE=plan-only`:初始化项目、开启 modeling + engineering、真实 agent 创建 track、生成并 validate `modeling_deltas` / `engineering_deltas`。
|
|
39
|
+
- `MODE=full`:在 plan-only 成功后,继续真实 agent 实现代码,并运行代码质量评分。
|
|
40
|
+
- `ENGINEERING=0`:兼容旧 modeling-only 回归。
|
|
41
|
+
- `KEEP=1`:保留 `/tmp/cdt-me-e2e-*` 工作区供检查,默认开启。
|
|
42
|
+
- `SKIP_AGENT=1`:只做脚本 smoke,不调用真实大模型;不能作为有效 E2E 结论。
|
|
43
|
+
- `AGENT_TIMEOUT=3600`:单次真实 agent 调用超时秒数;本机有 `timeout`/`gtimeout` 时生效。
|
|
44
|
+
|
|
45
|
+
## 判定标准
|
|
46
|
+
|
|
47
|
+
E2E 至少要检查:
|
|
48
|
+
|
|
49
|
+
- `codument validate <track> --strict` 通过。
|
|
50
|
+
- `codument modeling validate --deltas <track>` 通过。
|
|
51
|
+
- `codument engineering validate --deltas <track>` 通过(当 `ENGINEERING=1`)。
|
|
52
|
+
- full 模式下存在 `reports/code-quality.json` 和 `reports/code-quality.md`。
|
|
53
|
+
- 失败时保留 `_agent-plan.log`、`_agent-impl.log`、track 文件和 validate 输出。
|
|
54
|
+
|
|
55
|
+
## 失败排查
|
|
56
|
+
|
|
57
|
+
- 没生成 track:看 `_agent-plan.log`,通常是 agent 没遵循 `AGENTS.md` 或旧 skill 名。
|
|
58
|
+
- 复杂题目卡在生成 track:确认 prompt 中要求分批落盘;真实 codex 曾在一次性巨大补丁前长时间无产物。
|
|
59
|
+
- modeling validate 失败:检查 XNL 语法、component IO、id 与 `<plane>/<context>.xnl` 路径对齐。
|
|
60
|
+
- engineering validate 失败:检查 `#<plane>.<category>.<topic>.<name>` 与 `<plane>/<category>/<topic>.xnl` 对齐,以及 kind 的必需块;规则类目录使用 `rules`,不要用 `rule`。
|
|
61
|
+
- 代码质量低:使用 `codument-code-quality-score` skill 读取报告并做人工复核。
|
|
62
|
+
|
|
63
|
+
## 输出位置
|
|
64
|
+
|
|
65
|
+
默认工作区:
|
|
66
|
+
|
|
67
|
+
```text
|
|
68
|
+
/tmp/cdt-me-e2e-<topic>-<pid>/
|
|
69
|
+
_agent-plan.log
|
|
70
|
+
_agent-impl.log
|
|
71
|
+
codument/tracks/<track>/
|
|
72
|
+
reports/code-quality.json
|
|
73
|
+
reports/code-quality.md
|
|
74
|
+
```
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-plan-mission
|
|
3
|
+
description: 创建长周期 mission——生成 pending mission 的 mission.xml、proposal.md、design.md,用控制论 + DEPA actor 模型规划跨多个 track 的长期自动化目标。需要规划比 track 更长、可能重规划的任务时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · plan-mission
|
|
7
|
+
|
|
8
|
+
这是 codument **plan-mission** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/plan-mission.md`
|
|
11
|
+
|
|
12
|
+
mission.xml 规范见 `@/codument/std/spec/mission-xml-spec.md`;流程块规范见 `@/codument/std/spec/flow-notation.md`。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化。
|
|
15
|
+
- **用法**:创建 mission: `<mission-id>`。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/plan-mission.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-plan-track
|
|
3
|
+
description: 创建 codument 变更追踪(track)——起草 behavior delta + proposal + track.xml(TaskSpace/Schedule/Hooks)。新增能力、破坏性变更、架构/模式调整、改变行为的性能/安全工作时使用;纯 bug 修复/拼写/配置跳过。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · plan-track
|
|
7
|
+
|
|
8
|
+
这是 codument **plan-track** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/plan-track.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行;track.xml 格式见 `@/codument/std/spec/track-xml-spec.md`,提问/确认协议见 `@/codument/std/sop/questioning.md`(均由 body 按需引用)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化(存在 `@/codument/std/operations/`);否则先运行 `codument init`。
|
|
15
|
+
- **用法**:创建 track: `<track-id>`(动词开头 kebab,如 `add-csv-export`)。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/plan-track.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-plan-track-wave
|
|
3
|
+
description: 规划 track 的并行调度——给某层标 cdt:child-mode="dag" 并在 <Schedule> 写 <Dag> 依赖边(Node/After)。某层直接下层需要并行/DAG 执行时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · plan-track-wave
|
|
7
|
+
|
|
8
|
+
这是 codument **plan-track-wave** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/plan-track-wave.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行;Schedule/DAG 语法见 `@/codument/std/spec/track-xml-spec.md`,调度执行套路见 `@/codument/std/sop/wave-exec.md`(均由 body 按需引用)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化,目标 track 已创建。
|
|
15
|
+
- **用法**:规划 track: `<track-id>`。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/plan-track-wave.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-revise-track
|
|
3
|
+
description: 非线性修订进行中 track 的自身产物——proposal / design / behavior_deltas / track.xml / analysis / decisions。实现中途需要改动 track 提案、计划或规范增量时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · revise-track
|
|
7
|
+
|
|
8
|
+
这是 codument **revise-track** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/revise-track.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行(确认 track、按改动类型路由到对应文件、跑 operation-hooks 的 revise hook;hook 返回 BLOCKED 则不修改)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化,目标 track 已存在。
|
|
15
|
+
- **用法**:修订 track: `<track-id>`(说明要改什么)。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/revise-track.md` 为准。
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-track
|
|
3
|
+
description: "[已更名为 codument-plan-track] 创建 codument 变更追踪(track)——起草 behavior delta + proposal + track.xml(TaskSpace/Schedule/Hooks)。新增能力、破坏性变更、架构/模式调整、改变行为的性能/安全工作时使用;纯 bug 修复/拼写/配置跳过。"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · track(别名 → plan-track)
|
|
7
|
+
|
|
8
|
+
本 skill 已更名为 **codument-plan-track**。旧名 `codument-track` 保留为别名壳,触发后仍路由到新逻辑——权威提示词见:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/plan-track.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行。新引用请用 `codument-plan-track`。
|
|
13
|
+
|
|
14
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/plan-track.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-validate
|
|
3
|
+
description: 校验 track.xml(Track/TaskSpace/Schedule/Hooks/Ports)与 behaviors 登记表结构,支持 --strict 与独立校验子代理模式。提交或归档前做结构/一致性检查时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · validate
|
|
7
|
+
|
|
8
|
+
这是 codument **validate** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/validate.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行;track.xml 校验规则见 `@/codument/std/spec/track-xml-spec.md §9`,behavior 格式见 `@/codument/std/spec/behavior-delta.md`(均由 body 按需引用)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化。外部 `codument` CLI 不可用时 body 会降级为提示词自检并说明。
|
|
15
|
+
- **用法**:校验 `<track-id 或 behavior>` [--strict]。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/validate.md` 为准。
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: codument-verify
|
|
3
|
+
description: 独立验证——派 fresh 子代理实际运行(跑测试/启动应用/复现用例)确认 track 验收是否真实达成,只判定不修复,issues-first 输出。实现后做验收确认时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Codument · verify
|
|
7
|
+
|
|
8
|
+
这是 codument **verify** 操作的 skill 壳。**权威提示词在工作区** body——打开并**严格遵循**:
|
|
9
|
+
|
|
10
|
+
`@/codument/std/operations/verify.md`
|
|
11
|
+
|
|
12
|
+
按其中的 Markdown 说明 + `--` 流程标记块执行(Goal-Backward + 三级 Exists/Substantive/Wired + fresh 子代理**实跑**、逐项 PASS/FAIL + 证据)。注意:verify **只判定不修复**(修复属 implement/gap-loop)。
|
|
13
|
+
|
|
14
|
+
- **前置**:项目已通过 `codument init` 初始化,目标 track 已实现部分/全部。
|
|
15
|
+
- **用法**:验证 track: `<track-id>` [phase]。
|
|
16
|
+
|
|
17
|
+
> 壳只做路由,不重述规则。一切以 `@/codument/std/operations/verify.md` 为准。
|
package/src/version.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export const VERSION = "0.4.1";
|