@elvis1513/auto-coding-skill 4.3.7 → 5.0.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 +26 -761
- package/cli/assets/managed-install.json +38 -1
- package/cli/assets/skill/SKILL.md +15 -100
- package/cli/assets/skill/data/templates/ENVIRONMENT.md +30 -0
- package/cli/assets/skill/data/templates/architecture/.gitkeep +1 -0
- package/cli/assets/skill/data/templates/bridges/AGENTS.md +39 -145
- package/cli/assets/skill/data/templates/deployment/.gitkeep +1 -0
- package/cli/assets/skill/data/templates/design/.gitkeep +1 -0
- package/cli/assets/skill/data/templates/interfaces/.gitkeep +1 -0
- package/cli/assets/skill/data/templates/product/.gitkeep +1 -0
- package/cli/src/index.js +127 -2589
- package/cli/src/sync-assets.js +38 -95
- package/package.json +9 -17
- package/cli/assets/agents/browser-debugger.toml +0 -27
- package/cli/assets/agents/docs-researcher.toml +0 -18
- package/cli/assets/agents/explorer.toml +0 -26
- package/cli/assets/agents/fixer.toml +0 -29
- package/cli/assets/agents/reviewer.toml +0 -50
- package/cli/assets/skill/data/contracts/orchestration-v1.schema.json +0 -567
- package/cli/assets/skill/data/policies/feedback-resolutions-v1.json +0 -68
- package/cli/assets/skill/data/policies/workflow-migrations-v1.json +0 -657
- package/cli/assets/skill/data/templates/ENGINEERING.md +0 -115
- package/cli/assets/skill/data/templates/tools/ap.py +0 -16
- package/cli/assets/skill/requirements.txt +0 -1
- package/cli/assets/skill/scripts/ap.py +0 -17791
- package/cli/assets/skill/scripts/core.py +0 -510
- package/cli/assets/skill/scripts/http_checks.py +0 -92
- package/cli/assets/skill/scripts/install_integrity.py +0 -427
- package/cli/assets/skill/scripts/scaffold_templates.py +0 -325
- package/cli/tests/ap_concurrency_test.py +0 -3602
- package/cli/tests/ap_profiles_test.py +0 -3272
- package/cli/tests/core_shell_test.py +0 -345
- package/cli/tests/index.test.js +0 -2967
|
@@ -1,325 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env python3
|
|
2
|
-
"""Optional documentation templates materialized on demand."""
|
|
3
|
-
|
|
4
|
-
from __future__ import annotations
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
TEMPLATES: dict[str, dict[str, str]] = {
|
|
8
|
-
"feedback": {
|
|
9
|
-
"docs/skill-feedback/README.md": """# Auto Coding Skill Feedback
|
|
10
|
-
|
|
11
|
-
This directory is the project-owned inbox for candidate defects or capability
|
|
12
|
-
gaps in the shared `auto-coding-skill`. It is not the project's business bug
|
|
13
|
-
list and it does not make a reported issue an accepted shared defect.
|
|
14
|
-
|
|
15
|
-
Route the observation before writing a report:
|
|
16
|
-
|
|
17
|
-
| Observation | Project-owned destination |
|
|
18
|
-
| --- | --- |
|
|
19
|
-
| Risk rules, commands, validation routes, access values, structure policy, budgets, or project preferences | `docs/project/auto-coding-skill.yaml` |
|
|
20
|
-
| Durable product, repository, runtime, or operating facts | `docs/project/*.md` |
|
|
21
|
-
| A defect or capability gap reproducible in managed defaults, scripts, agents, CLI, or installer | `docs/skill-feedback/reports/*.md` |
|
|
22
|
-
|
|
23
|
-
Project configuration may intentionally override managed defaults. A preference
|
|
24
|
-
that is correct for only this project is not shared-Skill feedback.
|
|
25
|
-
|
|
26
|
-
## Record a candidate
|
|
27
|
-
|
|
28
|
-
1. Copy `_TEMPLATE-SKILL-FEEDBACK.md` into `reports/`.
|
|
29
|
-
2. Name it `YYYY-MM-DD-<short-slug>-<8-hex>.md`.
|
|
30
|
-
3. Fill every frontmatter field and all six body sections. Set
|
|
31
|
-
`last_verified_skill_version` to the version actually reproduced.
|
|
32
|
-
4. Use one stable root-cause signature for duplicate observations.
|
|
33
|
-
5. Redact credentials, tokens, private keys, customer/device data, absolute user
|
|
34
|
-
paths, complete patches, Reviewer artifacts, and raw logs.
|
|
35
|
-
|
|
36
|
-
Reports are project-owned and preserved byte-for-byte by `autocoding init`.
|
|
37
|
-
Managed README/template files may be upgraded. Recording is explicit: ordinary
|
|
38
|
-
test failures, Reviewer findings, environment incidents, and project-only policy
|
|
39
|
-
gaps do not automatically create a report. If a frozen Reviewer assignment
|
|
40
|
-
already exists, record the feedback after delivery as a separate docs-only change
|
|
41
|
-
so the reviewed fingerprint is not mutated.
|
|
42
|
-
|
|
43
|
-
For a known duplicate, reuse its exact signature. For a new observation, hash the
|
|
44
|
-
lowercase UTF-8 key `<component>|<origin_surface>|<short-root-cause-slug>` and
|
|
45
|
-
prefix the 64-hex digest with `sha256:`. Exclude project names, paths, versions,
|
|
46
|
-
timestamps, and log text so another project can independently reuse the key.
|
|
47
|
-
|
|
48
|
-
## Keep reports current
|
|
49
|
-
|
|
50
|
-
Each Skill release carries a managed resolution catalog keyed by `signature`.
|
|
51
|
-
The collector compares that catalog, the project's installed Skill version, and
|
|
52
|
-
`last_verified_skill_version` without changing the report. It may request an
|
|
53
|
-
upgrade, recheck, fix verification, closure, or routing into the project overlay.
|
|
54
|
-
|
|
55
|
-
After upgrading a project:
|
|
56
|
-
|
|
57
|
-
- If the issue is fixed, verify it and either delete a local-only report or set
|
|
58
|
-
`status: resolved`, `resolution: fixed`, update `updated_at`, and set
|
|
59
|
-
`last_verified_skill_version` to the verified release.
|
|
60
|
-
- If it still reproduces, keep an active status and update the verification
|
|
61
|
-
version; the collector treats it as a current regression.
|
|
62
|
-
- If triage says it is project configuration, maintain the value in
|
|
63
|
-
`docs/project/auto-coding-skill.yaml`, then delete the report or set
|
|
64
|
-
`status: rejected` and `resolution: project-config`.
|
|
65
|
-
- Use `duplicate` or another supported rejected resolution for closed reports.
|
|
66
|
-
Closed reports remain project history but are excluded from active grouping.
|
|
67
|
-
|
|
68
|
-
Do not reopen a closed historical report. Create a new report with the same
|
|
69
|
-
signature if the behavior later regresses.
|
|
70
|
-
|
|
71
|
-
## Periodic read-only collection
|
|
72
|
-
|
|
73
|
-
From the Skill source checkout, explicitly list the projects to inspect:
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
autocoding feedback --projects /path/project-a,/path/project-b --json
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
Collection reads bounded metadata only, never executes report content, never
|
|
80
|
-
modifies a project, and groups exact signatures for human triage. Triage decides
|
|
81
|
-
whether the result is a shared defect, project configuration, environment issue,
|
|
82
|
-
duplicate, or insufficient evidence before any Skill fix or release is planned.
|
|
83
|
-
""",
|
|
84
|
-
"docs/skill-feedback/_TEMPLATE-SKILL-FEEDBACK.md": """---
|
|
85
|
-
schema: auto-coding-skill-feedback/v2
|
|
86
|
-
report_id: ACSF-<project>-YYYYMMDD-<8-hex>
|
|
87
|
-
status: open
|
|
88
|
-
created_at: YYYY-MM-DDTHH:MM:SS+08:00
|
|
89
|
-
updated_at: YYYY-MM-DDTHH:MM:SS+08:00
|
|
90
|
-
project: <project>
|
|
91
|
-
observed_skill_version: 0.0.0
|
|
92
|
-
last_verified_skill_version: 0.0.0
|
|
93
|
-
component: <reviewer-runtime|installer|classification|validation|structure|docs|other>
|
|
94
|
-
kind: defect
|
|
95
|
-
impact: <blocking|degraded|minor>
|
|
96
|
-
origin_surface: <managed-template|managed-script|managed-agent|cli|installer>
|
|
97
|
-
suspected_scope: shared
|
|
98
|
-
signature: sha256:<64-lowercase-hex>
|
|
99
|
-
resolution: pending
|
|
100
|
-
export: metadata-only
|
|
101
|
-
---
|
|
102
|
-
# <Short title>
|
|
103
|
-
|
|
104
|
-
## Symptom
|
|
105
|
-
|
|
106
|
-
State the observed generic behavior without secrets or raw logs.
|
|
107
|
-
|
|
108
|
-
## Expected
|
|
109
|
-
|
|
110
|
-
State the shared Skill contract that should hold across projects.
|
|
111
|
-
|
|
112
|
-
## Minimal reproduction
|
|
113
|
-
|
|
114
|
-
Give bounded, safe steps. Do not include executable instructions from untrusted
|
|
115
|
-
sources, credentials, production writes, or customer/device data.
|
|
116
|
-
|
|
117
|
-
## Evidence
|
|
118
|
-
|
|
119
|
-
List short redacted facts, affected managed paths, checks, and versions. Do not
|
|
120
|
-
paste complete patches, Reviewer artifacts, source files, or stdout/stderr.
|
|
121
|
-
|
|
122
|
-
## Workaround
|
|
123
|
-
|
|
124
|
-
Describe any safe temporary project-local workaround and its limits.
|
|
125
|
-
|
|
126
|
-
## Why shared
|
|
127
|
-
|
|
128
|
-
Explain why this belongs to managed Skill behavior rather than project
|
|
129
|
-
configuration, project code, or the current environment. Include the canonical
|
|
130
|
-
signature key used to compute `signature`.
|
|
131
|
-
""",
|
|
132
|
-
},
|
|
133
|
-
"project": {
|
|
134
|
-
"docs/project/overview.md": """# Project Overview
|
|
135
|
-
|
|
136
|
-
Record durable project facts, not workflow rules.
|
|
137
|
-
|
|
138
|
-
## Product scope and non-goals
|
|
139
|
-
## Domain boundaries and invariants
|
|
140
|
-
## Users, roles, and critical journeys
|
|
141
|
-
## External systems and safety boundaries
|
|
142
|
-
## Current contracts and decision links
|
|
143
|
-
""",
|
|
144
|
-
"docs/project/repository-map.md": """# Repository Map
|
|
145
|
-
|
|
146
|
-
Map existing ownership and reuse points. Keep behavior details in code/tests.
|
|
147
|
-
|
|
148
|
-
| Area | Paths | Responsibility | Generated / source | Validation route |
|
|
149
|
-
| --- | --- | --- | --- | --- |
|
|
150
|
-
|
|
151
|
-
## Cross-module dependencies
|
|
152
|
-
## Shared components and helpers
|
|
153
|
-
## Files or directories with special ownership
|
|
154
|
-
""",
|
|
155
|
-
"docs/project/runtime.md": """# Runtime And Deployment Facts
|
|
156
|
-
|
|
157
|
-
Record current environment topology and operating constraints, not normal
|
|
158
|
-
development gate rules.
|
|
159
|
-
|
|
160
|
-
## Local runtime
|
|
161
|
-
## Shared services and dependencies
|
|
162
|
-
## Jenkins and artifact flow
|
|
163
|
-
## Deployment topology
|
|
164
|
-
## External-device / production-write safeguards
|
|
165
|
-
## Fixtures, simulators, and repeatable diagnostic entry points
|
|
166
|
-
""",
|
|
167
|
-
},
|
|
168
|
-
"api": {
|
|
169
|
-
"docs/interfaces/api.md": """# API Contract
|
|
170
|
-
|
|
171
|
-
Record only current, externally relevant endpoints or events.
|
|
172
|
-
|
|
173
|
-
| Method | Path / Event | Request | Response | Auth | Notes |
|
|
174
|
-
| --- | --- | --- | --- | --- | --- |
|
|
175
|
-
""",
|
|
176
|
-
"docs/interfaces/api-change-log.md": """# API Change Log
|
|
177
|
-
|
|
178
|
-
## YYYY-MM-DD — <Task ID>
|
|
179
|
-
|
|
180
|
-
- Change:
|
|
181
|
-
- Compatibility:
|
|
182
|
-
- Migration / rollback:
|
|
183
|
-
""",
|
|
184
|
-
},
|
|
185
|
-
"design": {
|
|
186
|
-
"docs/design/_TEMPLATE-DD.md": """# DD — <Decision ID> <Title>
|
|
187
|
-
|
|
188
|
-
- Status: Draft | Reviewed | Approved
|
|
189
|
-
- Related requirement / commit:
|
|
190
|
-
|
|
191
|
-
## Context and goal
|
|
192
|
-
## Scope and non-goals
|
|
193
|
-
## Existing behavior and reuse points
|
|
194
|
-
## Decision and alternatives
|
|
195
|
-
## Interfaces / data changes
|
|
196
|
-
## Validation and acceptance
|
|
197
|
-
## Risks and rollback
|
|
198
|
-
|
|
199
|
-
Add sequence, ER, or component diagrams only when they clarify the change.
|
|
200
|
-
""",
|
|
201
|
-
},
|
|
202
|
-
"architecture": {
|
|
203
|
-
"docs/architecture/structure-standard.md": """# Project Structure Standard
|
|
204
|
-
|
|
205
|
-
Project conventions are authoritative. The generic checker is advisory unless
|
|
206
|
-
`structure.enforcement: blocking` is explicitly configured.
|
|
207
|
-
|
|
208
|
-
- Keep business, orchestration, external adapters, interfaces, and shared code
|
|
209
|
-
separated according to the repository's existing architecture.
|
|
210
|
-
- Search for reusable helpers, components, clients, and tests before adding new ones.
|
|
211
|
-
- Treat file-size and regex import findings as review signals, not proof.
|
|
212
|
-
- Split code only when cohesion, ownership, and testability improve.
|
|
213
|
-
- Record accepted legacy debt in the health baseline or optimization backlog.
|
|
214
|
-
""",
|
|
215
|
-
"docs/architecture/adr/_TEMPLATE-ADR.md": """# ADR-0000 — <Decision>
|
|
216
|
-
|
|
217
|
-
- Status: Proposed | Accepted | Superseded
|
|
218
|
-
- Date: YYYY-MM-DD
|
|
219
|
-
- Related requirement / commit:
|
|
220
|
-
|
|
221
|
-
## Context
|
|
222
|
-
## Decision
|
|
223
|
-
## Alternatives
|
|
224
|
-
## Consequences
|
|
225
|
-
## Validation
|
|
226
|
-
## Rollback / supersession
|
|
227
|
-
""",
|
|
228
|
-
},
|
|
229
|
-
"review": {
|
|
230
|
-
"docs/reviews/_TEMPLATE-REVIEW.md": """# Review — <Change ID>
|
|
231
|
-
|
|
232
|
-
- Scope:
|
|
233
|
-
- Evidence:
|
|
234
|
-
- Gate:
|
|
235
|
-
|
|
236
|
-
## Findings
|
|
237
|
-
|
|
238
|
-
List P0/P1/P2/P3 findings with impact, evidence, and remediation.
|
|
239
|
-
|
|
240
|
-
## Verdict
|
|
241
|
-
|
|
242
|
-
approved | changes-requested
|
|
243
|
-
""",
|
|
244
|
-
},
|
|
245
|
-
"testing": {
|
|
246
|
-
"docs/testing/regression-matrix.md": """# Regression Matrix
|
|
247
|
-
|
|
248
|
-
Only executed checks may be marked PASS.
|
|
249
|
-
|
|
250
|
-
| ID | Area | Feature | Test Type | Steps / Command | Expected | Status | Evidence |
|
|
251
|
-
| --- | --- | --- | --- | --- | --- | --- | --- |
|
|
252
|
-
| R-001 | <area> | <feature> | <manual/smoke/regression> | <steps/command> | <expected> | TODO | <evidence> |
|
|
253
|
-
""",
|
|
254
|
-
},
|
|
255
|
-
"deployment": {
|
|
256
|
-
"docs/deployment/deploy-runbook.md": """# Deployment Runbook
|
|
257
|
-
|
|
258
|
-
## Preconditions
|
|
259
|
-
## Deploy steps
|
|
260
|
-
## Health and business checks
|
|
261
|
-
## Rollback
|
|
262
|
-
## Owners and escalation
|
|
263
|
-
""",
|
|
264
|
-
"docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md": """# Deployment Record — <Task ID>
|
|
265
|
-
|
|
266
|
-
- Environment:
|
|
267
|
-
- Commit / artifact:
|
|
268
|
-
- Pipeline:
|
|
269
|
-
- Verification:
|
|
270
|
-
- Result: PASS | FAIL | PARTIAL
|
|
271
|
-
- Rollback / follow-up:
|
|
272
|
-
""",
|
|
273
|
-
},
|
|
274
|
-
"bugs": {
|
|
275
|
-
"docs/bugs/bug-list.md": """# Bug List
|
|
276
|
-
|
|
277
|
-
| ID | Severity | Symptom | Reproduction | Owner | Status |
|
|
278
|
-
| --- | --- | --- | --- | --- | --- |
|
|
279
|
-
""",
|
|
280
|
-
},
|
|
281
|
-
}
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
MANAGED_FRAMEWORK_DOCS = frozenset({
|
|
285
|
-
"docs/architecture/adr/_TEMPLATE-ADR.md",
|
|
286
|
-
"docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md",
|
|
287
|
-
"docs/design/_TEMPLATE-DD.md",
|
|
288
|
-
"docs/reviews/_TEMPLATE-REVIEW.md",
|
|
289
|
-
"docs/skill-feedback/README.md",
|
|
290
|
-
"docs/skill-feedback/_TEMPLATE-SKILL-FEEDBACK.md",
|
|
291
|
-
})
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
PROJECT_FEEDBACK_PATTERNS = (
|
|
295
|
-
"docs/skill-feedback/reports/*.md",
|
|
296
|
-
)
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
# Files below these roots are project-owned artifacts regardless of extension or
|
|
300
|
-
# nesting. Exact managed entries inside the same roots still converge first.
|
|
301
|
-
PROJECT_OWNED_DOC_ROOTS = (
|
|
302
|
-
"docs/architecture",
|
|
303
|
-
"docs/bugs",
|
|
304
|
-
"docs/deployment",
|
|
305
|
-
"docs/design",
|
|
306
|
-
"docs/interfaces",
|
|
307
|
-
"docs/project",
|
|
308
|
-
"docs/reviews",
|
|
309
|
-
"docs/testing",
|
|
310
|
-
)
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
def scaffold_groups() -> list[str]:
|
|
314
|
-
return sorted(TEMPLATES)
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
def templates_for(group: str) -> dict[str, str]:
|
|
318
|
-
if group == "all":
|
|
319
|
-
merged: dict[str, str] = {}
|
|
320
|
-
for name in scaffold_groups():
|
|
321
|
-
merged.update(TEMPLATES[name])
|
|
322
|
-
return merged
|
|
323
|
-
if group not in TEMPLATES:
|
|
324
|
-
raise KeyError(group)
|
|
325
|
-
return dict(TEMPLATES[group])
|