aimship 0.0.0-stage → 0.1.0-preview.7
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 +33 -0
- package/LICENSE +21 -0
- package/README.md +89 -2
- package/README.zh-CN.md +90 -0
- package/bin/aimship.mjs +17 -0
- package/docs/cli.md +82 -0
- package/docs/examples.md +5 -0
- package/docs/guide.md +277 -0
- package/docs/guide.zh-CN.md +277 -0
- package/docs/installation.md +24 -0
- package/lib/cli.mjs +171 -0
- package/lib/documents.mjs +155 -0
- package/lib/install.mjs +363 -0
- package/lib/io.mjs +55 -0
- package/lib/migrate.mjs +77 -0
- package/lib/state.mjs +276 -0
- package/lib/view.mjs +69 -0
- package/package.json +43 -4
- package/skills/aimship/SKILL.md +19 -0
- package/skills/aimship/agents/openai.yaml +6 -0
- package/skills/aimship/references/artifact-map.json +163 -0
- package/skills/aimship/references/core.md +88 -0
- package/skills/aimship/references/document-patterns.md +39 -0
- package/skills/aimship/references/hosts.md +17 -0
- package/skills/aimship/references/recovery.md +21 -0
- package/skills/aimship/references/sources-and-changes.md +34 -0
- package/skills/aimship/references/stages/contract.md +23 -0
- package/skills/aimship/references/stages/diagnose.md +25 -0
- package/skills/aimship/references/stages/frame.md +23 -0
- package/skills/aimship/references/stages/handoff.md +23 -0
- package/skills/aimship/references/stages/implement.md +25 -0
- package/skills/aimship/references/stages/plan.md +23 -0
- package/skills/aimship/references/stages/prototype.md +23 -0
- package/skills/aimship/references/stages/requirements.md +23 -0
- package/skills/aimship/references/stages/review.md +23 -0
- package/skills/aimship/references/stages/scope.md +23 -0
- package/skills/aimship/references/stages/tech-design.md +25 -0
- package/skills/aimship/references/stages/test-design.md +23 -0
- package/skills/aimship/references/stages/verify.md +25 -0
- package/skills/aimship/references/templates/change-log.md +14 -0
- package/skills/aimship/references/templates/diagnosis.md +39 -0
- package/skills/aimship/references/templates/handoff.md +34 -0
- package/skills/aimship/references/templates/plan.md +34 -0
- package/skills/aimship/references/templates/prd.md +39 -0
- package/skills/aimship/references/templates/review.md +19 -0
- package/skills/aimship/references/templates/scope.md +39 -0
- package/skills/aimship/references/templates/tech-design.md +39 -0
- package/skills/aimship/references/templates/testing.md +34 -0
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# handoff
|
|
2
|
+
|
|
3
|
+
Delivery: <deliveryId from init>; document revision: <revision>.
|
|
4
|
+
|
|
5
|
+
<a id="goals"></a>
|
|
6
|
+
## Current goal comparison
|
|
7
|
+
|
|
8
|
+
REQ/AC and actual results, including explicit goal changes. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
9
|
+
|
|
10
|
+
<a id="artifacts"></a>
|
|
11
|
+
## Artifacts, repositories and versions
|
|
12
|
+
|
|
13
|
+
Links, actual checkout/worktree, branch/commit and uncommitted paths; no Git uses file digests. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
14
|
+
|
|
15
|
+
<a id="usage"></a>
|
|
16
|
+
## Usage
|
|
17
|
+
|
|
18
|
+
Actual commands and entry points. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
19
|
+
|
|
20
|
+
<a id="results"></a>
|
|
21
|
+
## Review and verification
|
|
22
|
+
|
|
23
|
+
Scopes, versions, results and evidence. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
24
|
+
|
|
25
|
+
<a id="limits"></a>
|
|
26
|
+
## Limitations and remaining work
|
|
27
|
+
|
|
28
|
+
Unverified work and recovery conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
29
|
+
|
|
30
|
+
<a id="outcomes"></a>
|
|
31
|
+
## Acceptance, integration, release and continuation
|
|
32
|
+
|
|
33
|
+
Independent facts; prepared version is not a release. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
34
|
+
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# plan
|
|
2
|
+
|
|
3
|
+
Delivery: <deliveryId from init>; document revision: <revision>.
|
|
4
|
+
|
|
5
|
+
<a id="basis"></a>
|
|
6
|
+
## Implementation basis and scope
|
|
7
|
+
|
|
8
|
+
Current requirements, design, contracts and actual repositories. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
9
|
+
|
|
10
|
+
<a id="batches"></a>
|
|
11
|
+
## Batches and dependencies
|
|
12
|
+
|
|
13
|
+
B ID, goal, dependencies and integration arrangement. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
14
|
+
|
|
15
|
+
<a id="tasks"></a>
|
|
16
|
+
## Tasks and completion criteria
|
|
17
|
+
|
|
18
|
+
TASK, batch, REQ/AC or risk, repository ID, file/module, planned change, completion criteria, status, artifact ref. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
19
|
+
|
|
20
|
+
<a id="validation"></a>
|
|
21
|
+
## Review and independent verification arrangement
|
|
22
|
+
|
|
23
|
+
Each batch review, overall review then independent verification; no per-batch full test gates. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
24
|
+
|
|
25
|
+
<a id="execution"></a>
|
|
26
|
+
## Task status and execution records
|
|
27
|
+
|
|
28
|
+
Actual changes and object versions by TASK/B; preserve original plan and distinguish pre-existing changes. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
29
|
+
|
|
30
|
+
<a id="remaining"></a>
|
|
31
|
+
## Deviations, blockers and remaining work
|
|
32
|
+
|
|
33
|
+
Unfinished effects and recovery, not a second stage ledger. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
34
|
+
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# prd
|
|
2
|
+
|
|
3
|
+
Delivery: <deliveryId from init>; document revision: <revision>.
|
|
4
|
+
|
|
5
|
+
<a id="info"></a>
|
|
6
|
+
## Document information and sources
|
|
7
|
+
|
|
8
|
+
Identify this delivery, revision and adopted inputs. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
9
|
+
|
|
10
|
+
<a id="goals"></a>
|
|
11
|
+
## Background, goals and non-goals
|
|
12
|
+
|
|
13
|
+
Separate known facts, requirements and assumptions. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
14
|
+
|
|
15
|
+
<a id="scope"></a>
|
|
16
|
+
## Scope, engineering objects and endpoint
|
|
17
|
+
|
|
18
|
+
Included/excluded work, repository IDs, authorization and endpoint. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
19
|
+
|
|
20
|
+
<a id="requirements"></a>
|
|
21
|
+
## Requirements and behavior
|
|
22
|
+
|
|
23
|
+
REQ, type, actor/object, trigger/precondition, behavior, observable result, boundaries/errors, source and AC. Shared business rules, access control (even one role), performance and reliability need independent identity when independently testable. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
24
|
+
|
|
25
|
+
<a id="states"></a>
|
|
26
|
+
## States, interaction and recovery
|
|
27
|
+
|
|
28
|
+
Allowed transitions, terminal states, errors and recovery; say why inapplicable. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
29
|
+
|
|
30
|
+
<a id="acceptance"></a>
|
|
31
|
+
## Acceptance criteria
|
|
32
|
+
|
|
33
|
+
AC, requirement reference, condition, operation, decidable expected result. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
34
|
+
|
|
35
|
+
<a id="arrangement"></a>
|
|
36
|
+
## Dependencies, questions and stage arrangement
|
|
37
|
+
|
|
38
|
+
Selected order, artifact locations/reuse, dependencies, Q with impact/status/decision source. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
39
|
+
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# review
|
|
2
|
+
|
|
3
|
+
Delivery: <deliveryId from init>; document revision: <revision>.
|
|
4
|
+
|
|
5
|
+
<a id="basis"></a>
|
|
6
|
+
## Review basis and scope
|
|
7
|
+
|
|
8
|
+
Exact repositories/objects, baseline and differences. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
9
|
+
|
|
10
|
+
<a id="reviews"></a>
|
|
11
|
+
## Review records
|
|
12
|
+
|
|
13
|
+
REV, batch/overall/repair scope, TASK/REQ/AC, reviewer/date, findings, dispositions and recheck conclusions. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
14
|
+
|
|
15
|
+
<a id="conclusion"></a>
|
|
16
|
+
## Open findings and current conclusion
|
|
17
|
+
|
|
18
|
+
Preserve historical findings and old object basis; review is not execution. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
19
|
+
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# scope
|
|
2
|
+
|
|
3
|
+
Delivery: <deliveryId from init>; document revision: <revision>.
|
|
4
|
+
|
|
5
|
+
<a id="info"></a>
|
|
6
|
+
## Document information and source versions
|
|
7
|
+
|
|
8
|
+
Delivery identity and adopted versions. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
9
|
+
|
|
10
|
+
<a id="goals"></a>
|
|
11
|
+
## Goal, engineering objects and endpoint
|
|
12
|
+
|
|
13
|
+
Actual repository IDs, authorized objects and endpoint. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
14
|
+
|
|
15
|
+
<a id="adoption"></a>
|
|
16
|
+
## Source mapping and adopted scope
|
|
17
|
+
|
|
18
|
+
Source/version/original ID or section, adoption decision, requirement reference, AC and gaps; do not copy the full PRD. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
19
|
+
|
|
20
|
+
<a id="exclusions"></a>
|
|
21
|
+
## Exclusions and constraints
|
|
22
|
+
|
|
23
|
+
Explicitly delimit this commission. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
24
|
+
|
|
25
|
+
<a id="decisions"></a>
|
|
26
|
+
## Conflicts, gaps and supplementary decisions
|
|
27
|
+
|
|
28
|
+
Preserve sources; identify decision authority and pending source updates. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
29
|
+
|
|
30
|
+
<a id="acceptance"></a>
|
|
31
|
+
## Acceptance basis
|
|
32
|
+
|
|
33
|
+
AC, requirement/source identity, conditions, actions and expected results. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
34
|
+
|
|
35
|
+
<a id="arrangement"></a>
|
|
36
|
+
## Authorization, questions and stage arrangement
|
|
37
|
+
|
|
38
|
+
Selected order, artifact locations/reuse, permissions and open Q. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
39
|
+
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# tech-design
|
|
2
|
+
|
|
3
|
+
Delivery: <deliveryId from init>; document revision: <revision>.
|
|
4
|
+
|
|
5
|
+
<a id="basis"></a>
|
|
6
|
+
## Basis and engineering context
|
|
7
|
+
|
|
8
|
+
Current requirements and actual engineering constraints. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
9
|
+
|
|
10
|
+
<a id="architecture"></a>
|
|
11
|
+
## Architecture and key flows
|
|
12
|
+
|
|
13
|
+
Ordered explanation or diagram of the important flow. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
14
|
+
|
|
15
|
+
<a id="modules"></a>
|
|
16
|
+
## Modules and interaction implementation
|
|
17
|
+
|
|
18
|
+
Repository ID, responsibility, actual path, new/change, requirement refs; entry/state/data flow for interaction. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
19
|
+
|
|
20
|
+
<a id="data"></a>
|
|
21
|
+
## Data, interfaces and SQL
|
|
22
|
+
|
|
23
|
+
Structures, indexes, consistency, contract authority, database type/version/schema basis, SQL order and execution boundary. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
24
|
+
|
|
25
|
+
<a id="errors"></a>
|
|
26
|
+
## Errors and nonfunctional design
|
|
27
|
+
|
|
28
|
+
Recovery, access, performance, observability, cache/messages when relevant. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
29
|
+
|
|
30
|
+
<a id="risks"></a>
|
|
31
|
+
## Tradeoffs and risks
|
|
32
|
+
|
|
33
|
+
Reasons, alternatives, compatibility and technical risks. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
34
|
+
|
|
35
|
+
<a id="coverage"></a>
|
|
36
|
+
## Requirement coverage and questions
|
|
37
|
+
|
|
38
|
+
REQ/AC to module/operation/SQL section and unresolved Q. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
39
|
+
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# testing
|
|
2
|
+
|
|
3
|
+
Delivery: <deliveryId from init>; document revision: <revision>.
|
|
4
|
+
|
|
5
|
+
<a id="basis"></a>
|
|
6
|
+
## Basis and scope
|
|
7
|
+
|
|
8
|
+
Current AC and risks; adopted cases location/version if verify-only. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
9
|
+
|
|
10
|
+
<a id="environment"></a>
|
|
11
|
+
## Environment, data and execution conditions
|
|
12
|
+
|
|
13
|
+
Tools, permissions, commands and unavailable conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
14
|
+
|
|
15
|
+
<a id="cases"></a>
|
|
16
|
+
## Test cases
|
|
17
|
+
|
|
18
|
+
TC, case version, REQ/AC or risk, type/level, preconditions, operations, concrete expected result, method/entry. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
19
|
+
|
|
20
|
+
<a id="coverage"></a>
|
|
21
|
+
## Coverage and verification arrangement
|
|
22
|
+
|
|
23
|
+
AC, requirements, TC, gaps and execution group/order. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
24
|
+
|
|
25
|
+
<a id="runs"></a>
|
|
26
|
+
## Execution and retest records
|
|
27
|
+
|
|
28
|
+
RUN, TC@version, exact code/build or document object, command/operation, assertions, actual results and evidence. Not executed until actually run; append failures/retests. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
29
|
+
|
|
30
|
+
<a id="conclusion"></a>
|
|
31
|
+
## Defects, current conclusion and remaining work
|
|
32
|
+
|
|
33
|
+
Separate passed, failed, blocked and unexecuted; explain applicability after change. Replace guidance with actual content; explain inapplicability, never prefill a result.
|
|
34
|
+
|