@elvis1513/auto-coding-skill 4.0.0 → 4.1.0
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/README.md +38 -9
- package/cli/assets/agents/reviewer.toml +3 -2
- package/cli/assets/skill/SKILL.md +45 -16
- package/cli/assets/skill/data/policies/workflow-migrations-v1.json +291 -5
- package/cli/assets/skill/data/templates/ENGINEERING.md +46 -19
- package/cli/assets/skill/data/templates/bridges/AGENTS.md +133 -27
- package/cli/assets/skill/scripts/ap.py +241 -50
- package/cli/assets/skill/scripts/scaffold_templates.py +40 -5
- package/cli/src/index.js +172 -85
- package/cli/tests/ap_concurrency_test.py +62 -10
- package/cli/tests/ap_profiles_test.py +27 -20
- package/cli/tests/index.test.js +78 -62
- package/package.json +1 -1
- package/cli/assets/skill/data/templates/docs/tasks/closure-log.md +0 -17
- package/cli/assets/skill/data/templates/docs/tasks/taskbook.md +0 -30
package/README.md
CHANGED
|
@@ -5,7 +5,12 @@ A delivery-first Codex engineering workflow:
|
|
|
5
5
|
`analysis → decomposition → necessary design → development → one final fast
|
|
6
6
|
changed-scope gate → commit/push`.
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
The Skill is a selectable guardrail, not a command sequence that must run for
|
|
9
|
+
every task. The model skips machinery whose expected benefit does not exceed its
|
|
10
|
+
cost; read-only work and obvious small clean-checkout changes normally stay direct.
|
|
11
|
+
|
|
12
|
+
Version 4.1 consolidates the 4.x delivery-first workflow into one canonical
|
|
13
|
+
repository contract. Version 4.0 replaced the 3.x governance-first defaults with progressive
|
|
9
14
|
guardrails. Clean single-writer work stays on the current branch. Worktrees,
|
|
10
15
|
parallel fixers, fingerprint review, durable design records, and stronger
|
|
11
16
|
affected-scope checks are enabled only when concurrency or risk justifies them.
|
|
@@ -26,7 +31,7 @@ The project install contains:
|
|
|
26
31
|
.agents/agents/
|
|
27
32
|
docs/ENGINEERING.md
|
|
28
33
|
docs/tools/autopipeline/ap.py
|
|
29
|
-
AGENTS.md (managed
|
|
34
|
+
AGENTS.md (fully managed canonical repository contract)
|
|
30
35
|
```
|
|
31
36
|
|
|
32
37
|
Ordinary projects no longer receive taskbook or closure logs. Existing optional
|
|
@@ -80,7 +85,7 @@ Dirty or parallel work receives an isolated task branch/worktree:
|
|
|
80
85
|
|
|
81
86
|
```bash
|
|
82
87
|
python3 docs/tools/autopipeline/ap.py task-start T0002 \
|
|
83
|
-
--owned-path backend --
|
|
88
|
+
--owned-path backend --review-required
|
|
84
89
|
# implement in the printed worktree
|
|
85
90
|
python3 docs/tools/autopipeline/ap.py task-review T0002 \
|
|
86
91
|
--verdict approved --diff-fingerprint "$SHA256"
|
|
@@ -93,6 +98,10 @@ Integration serializes the target push and removes clean merged worktrees and
|
|
|
93
98
|
temporary branches. Unknown changes, unmerged history, unsafe ignored data, or
|
|
94
99
|
dirty submodules block cleanup rather than being discarded.
|
|
95
100
|
|
|
101
|
+
Parallel development uses one task ID and one `task-start` per writer. `--writers`
|
|
102
|
+
belongs to `classify` planning only; the runtime rejects overlapping active
|
|
103
|
+
`owned_paths` and never creates multiple writers in one task/worktree.
|
|
104
|
+
|
|
96
105
|
## Real changed-scope validation
|
|
97
106
|
|
|
98
107
|
Risk classification and validation execution are deliberately separate:
|
|
@@ -152,13 +161,14 @@ diagnostics outside normal closure.
|
|
|
152
161
|
|
|
153
162
|
The main agent owns architecture, final validation, Git closure, ordered
|
|
154
163
|
integration, push, and cleanup. Push ends the coding task; later CI/acceptance is
|
|
155
|
-
|
|
164
|
+
not polled automatically. An explicitly requested failure diagnosis may continue
|
|
165
|
+
in the same conversation/task without an artificial second ledger lifecycle.
|
|
156
166
|
|
|
157
167
|
## Upgrade and multi-project sync
|
|
158
168
|
|
|
159
|
-
Finish
|
|
160
|
-
|
|
161
|
-
|
|
169
|
+
Finish every registered task using its currently installed runtime before syncing
|
|
170
|
+
a different Skill version. Batch sync fails before any writes when it finds an
|
|
171
|
+
active manifest, regardless of schema version.
|
|
162
172
|
|
|
163
173
|
```bash
|
|
164
174
|
autocoding status --projects /path/a,/path/b
|
|
@@ -168,8 +178,27 @@ autocoding sync --projects /path/a,/path/b
|
|
|
168
178
|
|
|
169
179
|
Sync replaces the managed Skill directory, so missing files are restored and
|
|
170
180
|
obsolete managed files are removed. It preserves project frontmatter, access
|
|
171
|
-
values, custom agents, explicit model overrides, optional documents, and
|
|
172
|
-
outside managed
|
|
181
|
+
values, custom role agents, explicit model overrides, optional documents, and
|
|
182
|
+
project-specific facts outside the managed ENGINEERING block. Root `AGENTS.md` is
|
|
183
|
+
replaced as a whole; its previous content is archived under
|
|
184
|
+
`docs/archive/workflow/` as historical, non-authoritative context.
|
|
185
|
+
|
|
186
|
+
## What changed in 4.1.0
|
|
187
|
+
|
|
188
|
+
- Made root `AGENTS.md` byte-identical across installed projects and whole-file
|
|
189
|
+
managed on every full sync/upgrade.
|
|
190
|
+
- Established code/tests/runtime as the source of current behavior and
|
|
191
|
+
`ENGINEERING.md` as the single project workflow/configuration source.
|
|
192
|
+
- Added an engineering-centered documentation framework plus optional
|
|
193
|
+
`docs/project/` fact templates.
|
|
194
|
+
- Prevented Skill upgrades while any registered task is active and recorded the
|
|
195
|
+
installed Skill version in new task manifests.
|
|
196
|
+
- Made reviewer scope bounded, with targeted recheck for mechanical docs-only
|
|
197
|
+
fixes and non-blocking handling of adjacent findings.
|
|
198
|
+
- Defined ledger/archive reconciliation as a terminal maintenance action, so
|
|
199
|
+
closing records cannot recursively create more task records.
|
|
200
|
+
- Kept explicit Jenkins failure diagnosis in the same requested task while
|
|
201
|
+
preserving push-as-completion and no automatic polling.
|
|
173
202
|
|
|
174
203
|
## What changed in 4.0.0
|
|
175
204
|
|
|
@@ -20,8 +20,9 @@ developer_instructions = """
|
|
|
20
20
|
- 复现条件
|
|
21
21
|
- 建议修法
|
|
22
22
|
9. 发现测试不足时,指出应补哪些测试或验证路径。
|
|
23
|
-
10. 结论必须是 approved 或 changes-requested;changes-requested 只返回 owning_fixer
|
|
23
|
+
10. 结论必须是 approved 或 changes-requested;changes-requested 只返回 owning_fixer,修改后必须绑定新的 diff fingerprint。代码、配置或行为语义变化需要重新审查;仅链接、归档索引、状态措辞等机械文档修正,可由同一 reviewer 只做 targeted recheck,不必重跑完整审计。
|
|
24
24
|
11. 不修改代码,不提交、不推送、不集成、不清理分支;审查不扩展本地门禁。
|
|
25
25
|
12. 最终只返回一个 JSON 对象,不要 Markdown 或代码围栏。对象必须符合 `.agents/skills/auto-coding-skill/data/contracts/orchestration-v1.schema.json#/$defs/agentResult`,包含全部必填字段,`contract_version` 固定为 1,`role` 固定为 `reviewer`,`changed_paths` 固定为空数组,`diff_fingerprint` 必须原样返回;审查完成时 `status=completed` 且 `verdict` 只能是 `approved` 或 `changes-requested`,无法继续时使用 `status=blocked`、`verdict=blocked`。findings 按 P0/P1/P2/P3 排序。
|
|
26
|
-
13.
|
|
26
|
+
13. 只阻断当前任务承诺范围内由本次变更新增或恶化的问题。相邻或既有问题写入 risks/follow-up,不得无限扩大当前任务和 review 范围。
|
|
27
|
+
14. 目标分支推送成功后,不自动跟踪 Jenkins、部署或项目负责人的实际验收;用户明确要求诊断本次推送引发的失败时,可在同一会话和任务范围继续,不要求人为新建台账任务。
|
|
27
28
|
"""
|
|
@@ -5,15 +5,26 @@ description: Delivery-first engineering workflow for repository changes. Use for
|
|
|
5
5
|
|
|
6
6
|
# Auto Coding Skill
|
|
7
7
|
|
|
8
|
+
## Activate only useful guardrails
|
|
9
|
+
|
|
10
|
+
This Skill is a decision aid, not a mandatory ceremony. For each task, use only
|
|
11
|
+
the mechanisms whose expected efficiency or quality benefit exceeds their cost.
|
|
12
|
+
Read-only questions, obvious clean-checkout edits, and terminal ledger maintenance
|
|
13
|
+
need no classify command, machine task lifecycle, design record, reviewer, or
|
|
14
|
+
subagent by default. Repository code changes still receive one real, fast,
|
|
15
|
+
affected-scope validation before commit/push.
|
|
16
|
+
|
|
8
17
|
Deliver changes through:
|
|
9
18
|
|
|
10
19
|
`analysis → decomposition → necessary design → development → one final fast
|
|
11
20
|
changed-scope gate → commit/push`.
|
|
12
21
|
|
|
13
|
-
Read `docs/ENGINEERING.md` for project
|
|
14
|
-
validation routes. Treat target-branch push
|
|
15
|
-
|
|
16
|
-
|
|
22
|
+
Read the fully managed root `AGENTS.md`, then `docs/ENGINEERING.md` for project
|
|
23
|
+
facts, access values, risk rules, and validation routes. Treat target-branch push
|
|
24
|
+
as normal coding completion. Do not poll Jenkins, deployment, or owner acceptance.
|
|
25
|
+
When the user explicitly asks to diagnose a failure caused by that push, continue
|
|
26
|
+
the diagnosis and repair in the same conversation/task without inventing another
|
|
27
|
+
ledger lifecycle.
|
|
17
28
|
|
|
18
29
|
## Choose the lightest safe path
|
|
19
30
|
|
|
@@ -41,7 +52,7 @@ Use the runtime-supported lifecycle when a machine-enforced task boundary helps:
|
|
|
41
52
|
|
|
42
53
|
```bash
|
|
43
54
|
python3 docs/tools/autopipeline/ap.py task-start T0001 \
|
|
44
|
-
--owned-path src [--
|
|
55
|
+
--owned-path src [--isolated] [--review-required]
|
|
45
56
|
# Work in the path printed by task-start.
|
|
46
57
|
python3 docs/tools/autopipeline/ap.py commit-push T0001 --msg "T0001: summary"
|
|
47
58
|
# Isolated tasks only:
|
|
@@ -67,6 +78,9 @@ never use them to trigger a full local repository gate automatically.
|
|
|
67
78
|
explicitly configured, or parallel integration work.
|
|
68
79
|
- Route blocking review findings back to the owning writer and invalidate the
|
|
69
80
|
approval after any content change or rebase.
|
|
81
|
+
- Keep review inside the promised task scope. Adjacent pre-existing findings are
|
|
82
|
+
non-blocking follow-ups. Semantic changes require full review against a new
|
|
83
|
+
fingerprint; mechanical docs-only corrections may use a targeted recheck.
|
|
70
84
|
|
|
71
85
|
Historical debt does not block normal delivery. Block only new or worsened P0/P1
|
|
72
86
|
issues. Handle repository-wide governance through an explicit task and optional
|
|
@@ -77,9 +91,12 @@ baseline/backlog.
|
|
|
77
91
|
Let the main agent own decomposition, architecture, dependencies, final gate,
|
|
78
92
|
Git closure, integration, and cleanup.
|
|
79
93
|
|
|
80
|
-
- Run independent read-only explorer, docs, or browser questions in parallel
|
|
94
|
+
- Run independent read-only explorer, docs, or browser questions in parallel only
|
|
95
|
+
when the model judges their expected value higher than coordination cost;
|
|
96
|
+
classification may suggest capabilities but never auto-dispatches them.
|
|
81
97
|
- Dispatch fixers only for bounded, dependency-free units with non-overlapping
|
|
82
|
-
paths; give each parallel fixer its own registered
|
|
98
|
+
paths; give each parallel fixer its own task ID, writer lease, and registered
|
|
99
|
+
worktree. `task-start` creates exactly one writer/worktree.
|
|
83
100
|
- Start dependent writers only after prerequisite commits are integrated.
|
|
84
101
|
- Add a reviewer only when the risk policy requires one.
|
|
85
102
|
- Do not force fan-out for small serial tasks.
|
|
@@ -107,19 +124,29 @@ python3 docs/tools/autopipeline/ap.py light-gate --scope changed --explain
|
|
|
107
124
|
- Run one final routed closure gate after the diff is stable.
|
|
108
125
|
- Do not automatically run full regression, Docker, builds, Jenkins, deployment,
|
|
109
126
|
API verification, or target checks.
|
|
110
|
-
- Do not
|
|
111
|
-
|
|
127
|
+
- Do not install dependencies proactively. Only after the selected final route
|
|
128
|
+
fails because a repository-locked dependency is absent may it be restored once;
|
|
129
|
+
then retry only that affected route.
|
|
112
130
|
|
|
113
131
|
## Keep project state small
|
|
114
132
|
|
|
115
|
-
Store task manifests, ownership, leases,
|
|
116
|
-
the Git common directory. Store gate
|
|
133
|
+
Store task manifests, the installed Skill version, ownership, leases,
|
|
134
|
+
dependencies, and review fingerprints in the Git common directory. Store gate
|
|
135
|
+
timing/evidence under `.local` by default.
|
|
117
136
|
Do not create taskbook, closure Markdown, evidence JSONL, active-task, or design
|
|
118
137
|
documents for ordinary work. Preserve existing project documents as user data;
|
|
119
138
|
create or update them only when explicitly useful.
|
|
120
139
|
|
|
121
|
-
Keep `
|
|
122
|
-
|
|
140
|
+
Keep root `AGENTS.md` byte-identical to the packaged canonical file; sync replaces
|
|
141
|
+
it as a whole and archives its previous contents as historical, non-authoritative
|
|
142
|
+
context. Keep `docs/ENGINEERING.md` as the only manual workflow configuration
|
|
143
|
+
source. Put larger product, repository, and runtime facts in `docs/project/`, not
|
|
144
|
+
in root AGENTS or duplicated workflow sections. Allow direct plaintext values
|
|
145
|
+
under `access.*`; do not invent or echo credentials.
|
|
146
|
+
|
|
147
|
+
Pure ledger, closure, or archive reconciliation is a terminal maintenance action:
|
|
148
|
+
run its targeted consistency check and commit once. It must not create another
|
|
149
|
+
active task, closure record, evidence chain, or review cycle for closing itself.
|
|
123
150
|
|
|
124
151
|
## Install and upgrade
|
|
125
152
|
|
|
@@ -131,7 +158,9 @@ python3 docs/tools/autopipeline/ap.py upgrade --write
|
|
|
131
158
|
python3 docs/tools/autopipeline/ap.py doctor
|
|
132
159
|
```
|
|
133
160
|
|
|
134
|
-
Finish
|
|
135
|
-
must preserve project configuration, access values, custom agents, optional
|
|
161
|
+
Finish every registered task before syncing a different runtime version. Upgrade
|
|
162
|
+
must preserve project configuration, access values, custom role agents, optional
|
|
136
163
|
documents, and explicit model overrides while removing obsolete managed Skill
|
|
137
|
-
files and filling new managed assets.
|
|
164
|
+
files and filling new managed assets. Root `AGENTS.md` is the exception: it is
|
|
165
|
+
fully replaced by the canonical version, with the previous file archived under
|
|
166
|
+
`docs/archive/workflow/`.
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schema_version": 1,
|
|
3
3
|
"managed_versions": {
|
|
4
|
-
"agents": "4.
|
|
5
|
-
"engineering": "4.
|
|
4
|
+
"agents": "4.1.0",
|
|
5
|
+
"engineering": "4.1.0"
|
|
6
6
|
},
|
|
7
7
|
"known_official_agents_sha256": [
|
|
8
8
|
"ebaaadab60327b3a4852948443d7191a4d48cb00bf4910038ab78c9149089373"
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
"paths": ["AGENTS.md"],
|
|
26
26
|
"match": "exact-line",
|
|
27
27
|
"text": "7. Run the resolved changed/standard/full gate. High-risk work must use the configured real full command and then verify Jenkins/target surfaces before `PASS`.",
|
|
28
|
-
"replacement": "7. Run the configured changed-scope fast gate once, commit and push, then stop;
|
|
28
|
+
"replacement": "7. Run the configured changed-scope fast gate once, commit and push, then stop; do not poll Jenkins or targets unless the user explicitly asks to diagnose this push in the same task."
|
|
29
29
|
},
|
|
30
30
|
{
|
|
31
31
|
"id": "agents-v22-autovpn-version",
|
|
@@ -64,7 +64,7 @@
|
|
|
64
64
|
"paths": ["AGENTS.md"],
|
|
65
65
|
"match": "exact-line",
|
|
66
66
|
"text": "7. For high-risk, pass full locally, commit/push, verify configured Jenkins and target surfaces, then record `PASS`, `FAIL`, or `PARTIAL` from actual evidence.",
|
|
67
|
-
"replacement": "7. Run the changed-scope fast gate once, commit/push, and record `DEV-CLOSED`;
|
|
67
|
+
"replacement": "7. Run the changed-scope fast gate once, commit/push, and record `DEV-CLOSED`; do not poll Jenkins or targets unless the user explicitly asks to diagnose this push in the same task."
|
|
68
68
|
},
|
|
69
69
|
{
|
|
70
70
|
"id": "agents-v22-geestack-profile",
|
|
@@ -135,7 +135,7 @@
|
|
|
135
135
|
"paths": ["AGENTS.md"],
|
|
136
136
|
"match": "exact-line",
|
|
137
137
|
"text": "- Local Docker startup/runtime checks remain opt-in by task scope; high-risk local full still requires all configured non-runtime build/test/static checks.",
|
|
138
|
-
"replacement": "- Local Docker startup/runtime checks remain opt-in and run only
|
|
138
|
+
"replacement": "- Local Docker startup/runtime checks remain opt-in and run only when explicitly requested for diagnosis, not as part of the automatic development gate."
|
|
139
139
|
},
|
|
140
140
|
{
|
|
141
141
|
"id": "engineering-v22-table-high-risk-en",
|
|
@@ -323,9 +323,295 @@
|
|
|
323
323
|
"match": "exact-block",
|
|
324
324
|
"text": "high-risk 工作必须先通过本地 full gate,再提交推送,随后验证启用的 Jenkins 与目标环境,\n最后依据真实证据记录 PASS、FAIL 或 PARTIAL。Jenkins/目标配置、账号和明文密码直接维护在\nfrontmatter 的 `access.*`;兼容凭据环境变量可继续保留。本地审计或升级不得自行触发构建、部署或目标探测。",
|
|
325
325
|
"replacement": "Jenkins/目标配置、账号和明文密码直接维护在 frontmatter 的 `access.*`,兼容凭据环境变量可继续保留。正常开发在 changed/quick 门禁和推送后结束;本地审计或升级不得自行触发构建、部署或目标探测。"
|
|
326
|
+
},
|
|
327
|
+
{
|
|
328
|
+
"id": "engineering-section-adaptive-profiles",
|
|
329
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
330
|
+
"match": "heading-section",
|
|
331
|
+
"text": "Adaptive execution profiles"
|
|
332
|
+
},
|
|
333
|
+
{
|
|
334
|
+
"id": "engineering-section-delivery-flow",
|
|
335
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
336
|
+
"match": "heading-section",
|
|
337
|
+
"text": "Delivery flow"
|
|
338
|
+
},
|
|
339
|
+
{
|
|
340
|
+
"id": "engineering-section-verification",
|
|
341
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
342
|
+
"match": "heading-section",
|
|
343
|
+
"text": "Verification"
|
|
344
|
+
},
|
|
345
|
+
{
|
|
346
|
+
"id": "engineering-section-main-commands",
|
|
347
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
348
|
+
"match": "heading-section",
|
|
349
|
+
"text": "Main commands"
|
|
350
|
+
},
|
|
351
|
+
{
|
|
352
|
+
"id": "engineering-section-execution-profiles-lower",
|
|
353
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
354
|
+
"match": "heading-section",
|
|
355
|
+
"text": "Execution profiles"
|
|
356
|
+
},
|
|
357
|
+
{
|
|
358
|
+
"id": "engineering-section-core-optional-docs",
|
|
359
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
360
|
+
"match": "heading-section",
|
|
361
|
+
"text": "Core and optional documents"
|
|
362
|
+
},
|
|
363
|
+
{
|
|
364
|
+
"id": "engineering-section-common-commands",
|
|
365
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
366
|
+
"match": "heading-section",
|
|
367
|
+
"text": "Common commands"
|
|
368
|
+
},
|
|
369
|
+
{
|
|
370
|
+
"id": "engineering-section-concurrent-write-tasks",
|
|
371
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
372
|
+
"match": "heading-section",
|
|
373
|
+
"text": "Concurrent write tasks"
|
|
374
|
+
},
|
|
375
|
+
{
|
|
376
|
+
"id": "engineering-section-subagent-orchestration",
|
|
377
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
378
|
+
"match": "heading-section",
|
|
379
|
+
"text": "Subagent orchestration"
|
|
380
|
+
},
|
|
381
|
+
{
|
|
382
|
+
"id": "engineering-section-standard-flow",
|
|
383
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
384
|
+
"match": "heading-section",
|
|
385
|
+
"text": "Standard Flow"
|
|
386
|
+
},
|
|
387
|
+
{
|
|
388
|
+
"id": "engineering-section-xjmate-profiles",
|
|
389
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
390
|
+
"match": "heading-section",
|
|
391
|
+
"text": "三档执行"
|
|
392
|
+
},
|
|
393
|
+
{
|
|
394
|
+
"id": "engineering-section-autovpn-flow",
|
|
395
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
396
|
+
"match": "heading-section",
|
|
397
|
+
"text": "2. 默认闭环"
|
|
398
|
+
},
|
|
399
|
+
{
|
|
400
|
+
"id": "engineering-section-autovpn-agents",
|
|
401
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
402
|
+
"match": "heading-section",
|
|
403
|
+
"text": "3. Agent 与模型"
|
|
404
|
+
},
|
|
405
|
+
{
|
|
406
|
+
"id": "engineering-section-autovpn-commands",
|
|
407
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
408
|
+
"match": "heading-section",
|
|
409
|
+
"text": "7. 常用命令"
|
|
410
|
+
},
|
|
411
|
+
{
|
|
412
|
+
"id": "engineering-heading-geestock-minimal",
|
|
413
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
414
|
+
"match": "exact-line",
|
|
415
|
+
"text": "## Minimal configuration",
|
|
416
|
+
"replacement": "## Runtime and deployment facts"
|
|
417
|
+
},
|
|
418
|
+
{
|
|
419
|
+
"id": "engineering-heading-geestock-default",
|
|
420
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
421
|
+
"match": "exact-line",
|
|
422
|
+
"text": "## Default workflow",
|
|
423
|
+
"replacement": "## Local validation and delivery topology"
|
|
424
|
+
},
|
|
425
|
+
{
|
|
426
|
+
"id": "engineering-heading-structure-policy",
|
|
427
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
428
|
+
"match": "exact-line",
|
|
429
|
+
"text": "## Structure policy",
|
|
430
|
+
"replacement": "## Repository structure facts"
|
|
431
|
+
},
|
|
432
|
+
{
|
|
433
|
+
"id": "engineering-heading-documents-history",
|
|
434
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
435
|
+
"match": "exact-line",
|
|
436
|
+
"text": "## Documents and history",
|
|
437
|
+
"replacement": "## Historical document layout"
|
|
438
|
+
},
|
|
439
|
+
{
|
|
440
|
+
"id": "engineering-heading-geemanage-profiles",
|
|
441
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
442
|
+
"match": "exact-line",
|
|
443
|
+
"text": "## Execution Profiles",
|
|
444
|
+
"replacement": "## Runtime and environment history"
|
|
445
|
+
},
|
|
446
|
+
{
|
|
447
|
+
"id": "engineering-heading-geemanage-gates",
|
|
448
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
449
|
+
"match": "exact-line",
|
|
450
|
+
"text": "## Gates",
|
|
451
|
+
"replacement": "## Validation command facts"
|
|
452
|
+
},
|
|
453
|
+
{
|
|
454
|
+
"id": "engineering-heading-geemanage-history",
|
|
455
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
456
|
+
"match": "exact-line",
|
|
457
|
+
"text": "## Documentation And History",
|
|
458
|
+
"replacement": "## Historical document layout"
|
|
459
|
+
},
|
|
460
|
+
{
|
|
461
|
+
"id": "engineering-heading-geemanage-agent-tool",
|
|
462
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
463
|
+
"match": "exact-line",
|
|
464
|
+
"text": "## Agent And Tool Policy",
|
|
465
|
+
"replacement": "## Jenkins and artifact facts"
|
|
466
|
+
},
|
|
467
|
+
{
|
|
468
|
+
"id": "engineering-heading-geesight-gate",
|
|
469
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
470
|
+
"match": "exact-line",
|
|
471
|
+
"text": "## Gate contract",
|
|
472
|
+
"replacement": "## Validation and contract facts"
|
|
473
|
+
},
|
|
474
|
+
{
|
|
475
|
+
"id": "engineering-heading-geesight-closure",
|
|
476
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
477
|
+
"match": "exact-line",
|
|
478
|
+
"text": "## Verified closure",
|
|
479
|
+
"replacement": "## Access facts"
|
|
480
|
+
},
|
|
481
|
+
{
|
|
482
|
+
"id": "engineering-heading-xjmate-gate",
|
|
483
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
484
|
+
"match": "exact-line",
|
|
485
|
+
"text": "## 门禁约定",
|
|
486
|
+
"replacement": "## 校验命令与诊断事实"
|
|
487
|
+
},
|
|
488
|
+
{
|
|
489
|
+
"id": "engineering-heading-xjmate-history",
|
|
490
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
491
|
+
"match": "exact-line",
|
|
492
|
+
"text": "## 文档与历史",
|
|
493
|
+
"replacement": "## 历史文档布局"
|
|
494
|
+
},
|
|
495
|
+
{
|
|
496
|
+
"id": "engineering-heading-autovpn-profiles",
|
|
497
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
498
|
+
"match": "exact-line",
|
|
499
|
+
"text": "## 1. 三档执行策略",
|
|
500
|
+
"replacement": "## 校验命令与诊断事实"
|
|
501
|
+
},
|
|
502
|
+
{
|
|
503
|
+
"id": "engineering-heading-autovpn-history",
|
|
504
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
505
|
+
"match": "exact-line",
|
|
506
|
+
"text": "## 5. 文档与历史",
|
|
507
|
+
"replacement": "## 项目文档资产"
|
|
508
|
+
},
|
|
509
|
+
{
|
|
510
|
+
"id": "engineering-v41-geestack-history-facts",
|
|
511
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
512
|
+
"match": "exact-block",
|
|
513
|
+
"text": "The minimal always-managed documents are `docs/ENGINEERING.md`, the taskbook,\nand the closure log. API documentation is project-required. DDs, ADRs, reviews,\ntesting matrices, deployment records, summaries, baselines, and backlogs are\ncreated or updated only when the change needs them.",
|
|
514
|
+
"replacement": "Existing taskbooks, closure logs, DDs, reviews, matrices, deployment records, summaries, baselines, and backlogs are preserved project history, not mandatory outputs. API documentation remains project-required when its configured contract paths change."
|
|
515
|
+
},
|
|
516
|
+
{
|
|
517
|
+
"id": "engineering-v41-geestock-minimal-workflow",
|
|
518
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
519
|
+
"match": "exact-block",
|
|
520
|
+
"text": "Required for normal development:\n\n- `workflow.mode`: `dev`\n- `workflow.profile`: `auto`, `micro`, `standard`, or `high-risk`\n- `project.name`\n- all direct URL, username, and password values under `access.*`\n- one fast `commands.gate_changed`; standard/full commands are explicit diagnostics\n- `concurrency.isolation: adaptive`\n\nLegacy command keys such as `commands.light_gate`, `quick_test`, `test`, and\n`build` remain callable explicitly. Run `doctor` for exact missing-field diagnostics.\n",
|
|
521
|
+
"replacement": ""
|
|
522
|
+
},
|
|
523
|
+
{
|
|
524
|
+
"id": "engineering-v41-geestock-default-workflow",
|
|
525
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
526
|
+
"match": "exact-block",
|
|
527
|
+
"text": "Development:\n\n1. Read this file and the active task entry.\n2. Run or reason through `classify --scope auto`.\n3. Record the smallest useful design note; create DD/ADR only when indicated.\n4. Implement the necessary change using existing project structure and reuse points.\n5. Run exactly one configured changed/quick gate; profiles only adjust analysis, design, and review depth.\n6. Record `DEV-CLOSED`, commit, and push.\nThe authoritative order remains ENGINEERING, taskbook/archives, design and\ninterface records, regression/bug records, closure evidence, deployment records,\nthen implementation. Do not mark unexecuted checks as PASS.\n",
|
|
528
|
+
"replacement": ""
|
|
529
|
+
},
|
|
530
|
+
{
|
|
531
|
+
"id": "engineering-v41-geemanage-profile-workflow",
|
|
532
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
533
|
+
"match": "exact-block",
|
|
534
|
+
"text": "- `workflow.profile: auto` 根据改动解析为 `micro`、`standard` 或 `high-risk`。\n- `micro` 用于纯文档、纯测试或隔离的低风险改动,执行 changed/quick 门禁并推送闭环。\n- `standard` 用于普通功能和缺陷,提升分析与评审深度,但仍只执行 changed/quick 门禁并推送闭环。\n- 数据库迁移、认证权限、安全、依赖/构建、Jenkins、Compose 和运行时配置属于 high-risk,提升分析、设计和评审深度;正常开发仍只执行 changed/quick 门禁。",
|
|
535
|
+
"replacement": ""
|
|
536
|
+
},
|
|
537
|
+
{
|
|
538
|
+
"id": "engineering-v41-geemanage-history-workflow",
|
|
539
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
540
|
+
"match": "exact-block",
|
|
541
|
+
"text": "- `docs/tasks/taskbook.md` 是活动任务源;`docs/tasks/closure-log.md` 保存轻量闭环记录。\n- 跨模块、API、DB、认证、部署/CI 或长期结构决策才创建 DD/ADR;其他任务只写最小设计。",
|
|
542
|
+
"replacement": "- Existing taskbook、closure 和 design 文档是保留的项目历史,不是普通任务的必填产物。"
|
|
543
|
+
},
|
|
544
|
+
{
|
|
545
|
+
"id": "engineering-v41-geemanage-agent-workflow",
|
|
546
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
547
|
+
"match": "exact-block",
|
|
548
|
+
"text": "- `.agents/agents/*.toml` 只描述角色与权限,不固定模型;由当前客户端动态选择可用模型。\n- 主代理负责范围、结构决策、集成、门禁和闭环;独立的探索、文档研究、实现切片或复核才交给子代理。\n- 优先复用 repo 脚本、`docs/tools/autopipeline/ap.py`、已安装 skill/MCP/connector;当前 API 行为需要外部事实时只使用权威文档。\n- 任何 Jenkins、目标环境或浏览器结果只能由实际执行证据支持。",
|
|
549
|
+
"replacement": "- 任何 Jenkins、目标环境或浏览器结果只能由实际执行证据支持。"
|
|
550
|
+
},
|
|
551
|
+
{
|
|
552
|
+
"id": "engineering-v41-geesight-history-assets",
|
|
553
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
554
|
+
"match": "exact-block",
|
|
555
|
+
"text": "最小必需文档是本文件、`docs/tasks/taskbook.md` 和 `docs/tasks/closure-log.md`。现有 API、\ndesign、ADR、review、testing、deployment、bug 和 summary 文档是项目已经启用的可选实体,\n继续保留,不复制回 Skill 模板目录。\n\ntaskbook、closure log 和顶层 `docs/design/T*.md` 是活跃工作集。已关闭历史通过",
|
|
556
|
+
"replacement": "现有 taskbook、closure、API、design、ADR、review、testing、deployment、bug 和 summary 文档是保留的项目资产,不是普通任务的必填产物。已关闭历史通过"
|
|
557
|
+
},
|
|
558
|
+
{
|
|
559
|
+
"id": "engineering-v41-geesight-authority",
|
|
560
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
561
|
+
"match": "exact-block",
|
|
562
|
+
"text": "权威顺序:ENGINEERING → active taskbook/archives → active design/design archives → API/ADR →\ntesting/review/bug/deployment → closure/evidence → implementation。",
|
|
563
|
+
"replacement": ""
|
|
564
|
+
},
|
|
565
|
+
{
|
|
566
|
+
"id": "engineering-v41-geesight-access-only",
|
|
567
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
568
|
+
"match": "exact-line",
|
|
569
|
+
"text": "Jenkins/目标配置、账号和明文密码直接维护在 frontmatter 的 `access.*`,兼容凭据环境变量可继续保留。正常开发在 changed/quick 门禁和推送后结束;本地审计或升级不得自行触发构建、部署或目标探测。",
|
|
570
|
+
"replacement": "Jenkins/目标配置、账号和明文密码直接维护在 frontmatter 的 `access.*`;兼容凭据环境变量可继续保留。"
|
|
571
|
+
},
|
|
572
|
+
{
|
|
573
|
+
"id": "engineering-v41-xjmate-history",
|
|
574
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
575
|
+
"match": "exact-block",
|
|
576
|
+
"text": "- 活跃任务写入 `docs/tasks/taskbook.md`,闭环写入 `docs/tasks/closure-log.md`。\n- API 文档和 change log 是必需文档;接口、权限或跨端契约变化必须同步维护。",
|
|
577
|
+
"replacement": "- Existing taskbook 和 closure 是保留的项目历史。\n- API 文档和 change log 是必需文档;接口、权限或跨端契约变化必须同步维护。"
|
|
578
|
+
},
|
|
579
|
+
{
|
|
580
|
+
"id": "engineering-v41-xjmate-design-workflow",
|
|
581
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
582
|
+
"match": "exact-line",
|
|
583
|
+
"text": "- DD、review、testing、deployment 等文档按任务需要维护,不因模板存在而批量创建。"
|
|
584
|
+
},
|
|
585
|
+
{
|
|
586
|
+
"id": "engineering-v41-autovpn-profile-table",
|
|
587
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
588
|
+
"match": "exact-block",
|
|
589
|
+
"text": "| Profile | 适用范围 | 必须门禁 | 闭环 |\n| --- | --- | --- | --- |\n| `micro` | 纯文档、纯测试或隔离的小改动 | changed | dev / `DEV-CLOSED` |\n| `standard` | 普通功能与缺陷修复 | standard | dev / `DEV-CLOSED` |\n| `high-risk` | migration、auth/access、billing/order、Jenkins、容器与生产部署 | changed/quick | push / `DEV-CLOSED` |\n\n",
|
|
590
|
+
"replacement": ""
|
|
591
|
+
},
|
|
592
|
+
{
|
|
593
|
+
"id": "engineering-v41-autovpn-doc-assets",
|
|
594
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
595
|
+
"match": "exact-block",
|
|
596
|
+
"text": "核心文档是 ENGINEERING、taskbook 和 closure log。AutoVPN 已长期维护 API、\ndesign、ADR、review、testing、bugs、deployment、summary 及月度 archive,\n这些是项目资产,不因 2.2.0 的最小默认模板而删除或重建。",
|
|
597
|
+
"replacement": "AutoVPN 已长期维护 taskbook、closure、API、design、ADR、review、testing、bugs、deployment、summary 及月度 archive;这些是保留的项目资产,不是普通任务的必填产物。"
|
|
598
|
+
},
|
|
599
|
+
{
|
|
600
|
+
"id": "engineering-v41-autovpn-authority",
|
|
601
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
602
|
+
"match": "exact-block",
|
|
603
|
+
"text": "权威顺序:ENGINEERING → taskbook/archive → design/ADR → API 契约 →\nregression/bugs → closure/evidence → deployment → 实现。",
|
|
604
|
+
"replacement": ""
|
|
326
605
|
}
|
|
327
606
|
],
|
|
328
607
|
"conflict_rules": [
|
|
608
|
+
{
|
|
609
|
+
"id": "duplicate-managed-workflow-section",
|
|
610
|
+
"paths": ["docs/ENGINEERING.md"],
|
|
611
|
+
"pattern": "^\\s*#{1,6}\\s+(?:adaptive\\s+)?execution\\s+profiles?\\s*$|^\\s*#{1,6}\\s+(?:minimal\\s+configuration|concurrent\\s+write\\s+tasks|subagent\\s+orchestration|default\\s+workflow|delivery\\s+flow|gates?|gate\\s+contract|verification|structure\\s+policy|core\\s+and\\s+optional\\s+documents|documents?\\s+and\\s+history|documentation\\s+and\\s+history|agent\\s+and\\s+tool\\s+policy|standard\\s+flow|verified\\s+closure|common\\s+commands|main\\s+commands)\\s*$|^\\s*#{1,6}\\s*(?:[1-7]\\.\\s*)?(?:三档执行(?:策略)?|默认闭环|Agent\\s*与模型|门禁约定|文档与历史|常用命令)\\s*$|^\\s*#{2,6}\\s+.*(?:workflow|工作流|默认闭环|standard\\s+flow)\\s*$",
|
|
612
|
+
"flags": "i",
|
|
613
|
+
"message": "shared workflow headings must live only in the managed block; move durable project facts to a project-facts heading or docs/project/ and remove the duplicate section"
|
|
614
|
+
},
|
|
329
615
|
{
|
|
330
616
|
"id": "stale-workflow-version",
|
|
331
617
|
"paths": ["AGENTS.md", "docs/ENGINEERING.md"],
|