aimship 0.0.0-stage → 0.1.0-preview.4
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/CONTRIBUTING.md +11 -0
- package/LICENSE +21 -0
- package/README.md +44 -2
- package/README.zh-CN.md +45 -0
- package/bin/aimship.mjs +17 -0
- package/docs/cli.md +62 -0
- package/docs/guide.md +59 -0
- package/docs/installation.md +117 -0
- package/lib/cli.mjs +159 -0
- package/lib/install.mjs +363 -0
- package/lib/io.mjs +55 -0
- package/lib/state.mjs +210 -0
- package/package.json +42 -4
- package/skills/aimship/SKILL.md +19 -0
- package/skills/aimship/agents/openai.yaml +6 -0
- package/skills/aimship/references/core.md +84 -0
- package/skills/aimship/references/document-patterns.md +19 -0
- package/skills/aimship/references/hosts.md +15 -0
- package/skills/aimship/references/recovery.md +13 -0
- package/skills/aimship/references/sources-and-changes.md +28 -0
- package/skills/aimship/references/stages/contract.md +19 -0
- package/skills/aimship/references/stages/diagnose.md +19 -0
- package/skills/aimship/references/stages/frame.md +19 -0
- package/skills/aimship/references/stages/handoff.md +19 -0
- package/skills/aimship/references/stages/implement.md +19 -0
- package/skills/aimship/references/stages/plan.md +19 -0
- package/skills/aimship/references/stages/prototype.md +19 -0
- package/skills/aimship/references/stages/requirements.md +19 -0
- package/skills/aimship/references/stages/review.md +19 -0
- package/skills/aimship/references/stages/scope.md +19 -0
- package/skills/aimship/references/stages/tech-design.md +19 -0
- package/skills/aimship/references/stages/test-design.md +19 -0
- package/skills/aimship/references/stages/verify.md +19 -0
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Design interaction
|
|
2
|
+
|
|
3
|
+
## Basis
|
|
4
|
+
|
|
5
|
+
Read current requirements, applicable design conventions and any supplied prototype or UI images.
|
|
6
|
+
|
|
7
|
+
## Work and result
|
|
8
|
+
|
|
9
|
+
Describe or build the relevant flow, screens, key loading/empty/error/success and permission states, feedback and responsive behavior where relevant. Link each part to its requirement. Visually inspect/operate actual HTML when claiming layout or interaction validation, with available tools.
|
|
10
|
+
|
|
11
|
+
## Continue when
|
|
12
|
+
|
|
13
|
+
The relevant interactions and states are clear and consistent with current requirements. A saved image or HTML source is not evidence of visual inspection.
|
|
14
|
+
|
|
15
|
+
## Decisions and blockers
|
|
16
|
+
|
|
17
|
+
Missing visual/browser tools require an explicit unverified scope. Resolve contradictory behavior through requirements/Scope; do not silently alter external prototypes.
|
|
18
|
+
|
|
19
|
+
Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Define requirements
|
|
2
|
+
|
|
3
|
+
## Basis
|
|
4
|
+
|
|
5
|
+
Read the preserved original input, problem findings, adopted material and current decisions.
|
|
6
|
+
|
|
7
|
+
## Work and result
|
|
8
|
+
|
|
9
|
+
Write the current requirements, important rules, normal/error/boundary behavior, constraints and observable acceptance criteria. Include context and scope, not just a checklist. Link sources; external material is adopted through Scope rather than rewritten.
|
|
10
|
+
|
|
11
|
+
## Continue when
|
|
12
|
+
|
|
13
|
+
The requirements are adequate for the commissioned next work and material ambiguities affecting it are resolved. Reuse adequate requirements without claiming they were newly produced.
|
|
14
|
+
|
|
15
|
+
## Decisions and blockers
|
|
16
|
+
|
|
17
|
+
Ask for business behavior, compatibility or endpoint choices that cannot be inferred. Do not invent user acceptance.
|
|
18
|
+
|
|
19
|
+
Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Review actual changes
|
|
2
|
+
|
|
3
|
+
## Basis
|
|
4
|
+
|
|
5
|
+
Read the applicable requirements, design/contract, batch or overall scope and exact change objects.
|
|
6
|
+
|
|
7
|
+
## Work and result
|
|
8
|
+
|
|
9
|
+
Fix the object basis before review: commit plus relevant working differences/untracked paths, or document sections and digests/old excerpts. Check consistency, defects, omissions and scope. Record findings, dispositions and reviewer source. Batch review precedes next batch; overall review checks integration after all batches. Single-batch review may cover both explicitly.
|
|
10
|
+
|
|
11
|
+
## Continue when
|
|
12
|
+
|
|
13
|
+
The agreed scope has actually been examined and issues blocking progression are resolved or handled by an explicit change. Keep old conclusions for their old objects.
|
|
14
|
+
|
|
15
|
+
## Decisions and blockers
|
|
16
|
+
|
|
17
|
+
Do not replace an agreed human review with agent review. Review cannot be reported as a running test; unrelated work need not be re-reviewed.
|
|
18
|
+
|
|
19
|
+
Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Align this delivery
|
|
2
|
+
|
|
3
|
+
## Basis
|
|
4
|
+
|
|
5
|
+
Read the user commission, current/adopted requirements, source versions and proposed engineering objects.
|
|
6
|
+
|
|
7
|
+
## Work and result
|
|
8
|
+
|
|
9
|
+
Record this goal, included/excluded requirements, source mappings, endpoint, authorization boundaries and acceptance. Explain external conflicts and adoption decisions. After associating or changing code scope, use the [recorded-overlap check](../core.md#independent-deliveries-and-recorded-overlap). Record actual checkout locations and read-only versus intended write scope. Agree the ordered stages based on gaps; keep stage progress only in state. Self-owned requirements may carry this information.
|
|
10
|
+
|
|
11
|
+
## Continue when
|
|
12
|
+
|
|
13
|
+
The goal, authority and scope are clear enough for the selected next work, with relevant decisions resolved or dependent work held.
|
|
14
|
+
|
|
15
|
+
## Decisions and blockers
|
|
16
|
+
|
|
17
|
+
Material conflicting sources or uncertain authority needs clarification; format differences alone do not. Never choose source priority by filename or date.
|
|
18
|
+
|
|
19
|
+
Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Design the implementation
|
|
2
|
+
|
|
3
|
+
## Basis
|
|
4
|
+
|
|
5
|
+
Read current requirements/Scope, relevant engineering instructions, architecture, schema and diagnosis.
|
|
6
|
+
|
|
7
|
+
## Work and result
|
|
8
|
+
|
|
9
|
+
Choose an approach with concrete components, dependencies, errors/recovery, compatibility and tradeoffs. Link authoritative contracts instead of duplicating them. For database changes create separate delivery-local SQL and explain dialect/version, existing schema basis, conditions and sequence. Do not edit migration files or execute SQL without that commission.
|
|
10
|
+
|
|
11
|
+
## Continue when
|
|
12
|
+
|
|
13
|
+
The design can guide the agreed next work and correctness-affecting issues have a clear disposition. Explain the approach and outstanding choices to the user.
|
|
14
|
+
|
|
15
|
+
## Decisions and blockers
|
|
16
|
+
|
|
17
|
+
Missing schema/dialect or material compatibility/data decisions block dependent design claims. An explicitly revised conceptual-design endpoint must retain these limitations.
|
|
18
|
+
|
|
19
|
+
Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Design verification
|
|
2
|
+
|
|
3
|
+
## Basis
|
|
4
|
+
|
|
5
|
+
Read current acceptance criteria, constraints, design/contracts, independent SQL and identified risks.
|
|
6
|
+
|
|
7
|
+
## Work and result
|
|
8
|
+
|
|
9
|
+
Map each goal/risk to observable checks: normal behavior, relevant errors/boundaries and regression. Identify commands/tools, environment, accounts/data and authorization needs. Preserve checks whose conditions are absent; distinguish what must be verified from what can run now.
|
|
10
|
+
|
|
11
|
+
## Continue when
|
|
12
|
+
|
|
13
|
+
The goal and material risks have appropriate checks and missing execution conditions are explicit. Simple checklists may share a later report.
|
|
14
|
+
|
|
15
|
+
## Decisions and blockers
|
|
16
|
+
|
|
17
|
+
Missing tools or execution authority do not justify deleting a valid case. Clarify acceptance omissions through current requirements rather than measuring only test count.
|
|
18
|
+
|
|
19
|
+
Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Execute verification
|
|
2
|
+
|
|
3
|
+
## Basis
|
|
4
|
+
|
|
5
|
+
Read current acceptance criteria, the verification plan, actual reviewed results and execution conditions.
|
|
6
|
+
|
|
7
|
+
## Work and result
|
|
8
|
+
|
|
9
|
+
Execute the agreed checks on identified objects. Preserve commands/operations, environment/data, expected assertions, actual results and sufficient evidence. Separate pass/fail/not-run/unknown. On defects repair the affected implementation, review the repair, then retest affected cases; append the new result and retain the old failure.
|
|
10
|
+
|
|
11
|
+
## Continue when
|
|
12
|
+
|
|
13
|
+
The agreed execution work is accounted for with traceable results. This run can end with failure or gaps; that does not make the development goal met.
|
|
14
|
+
|
|
15
|
+
## Decisions and blockers
|
|
16
|
+
|
|
17
|
+
Unavailable environment or authority stays explicit with a recovery action. Do not lower criteria, skip assertions or mark a case passed because a command exited successfully.
|
|
18
|
+
|
|
19
|
+
Use [the shared core](../core.md) for state, evidence and continuation rules. Record meaningful results in an artifact or referenced section; a file alone is not completion.
|