specdojo 0.2.1 → 0.3.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/.github/agents/specdojo-orchestrator.md +165 -0
- package/CHANGELOG.md +298 -0
- package/README.md +92 -42
- package/dist/agent-response.js +20 -0
- package/dist/agent.js +4 -4
- package/dist/build-command.js +28 -8
- package/dist/catalog-build-references.js +144 -0
- package/dist/catalog-build-render.js +144 -0
- package/dist/catalog-build.js +13 -290
- package/dist/catalog-generate.js +6 -9
- package/dist/catalog-plan-generate.js +2 -2
- package/dist/catalog-plan.js +6 -6
- package/dist/catalog-scaffold.js +4 -4
- package/dist/catalog.js +2 -2
- package/dist/dashboard-exec-records.js +105 -0
- package/dist/dashboard-routines.js +255 -0
- package/dist/dashboard-shared.js +14 -0
- package/dist/dashboard-timeline.js +175 -0
- package/dist/dashboard.js +31 -444
- package/dist/deliverable-trash.js +3 -3
- package/dist/devcontainer-command.js +43 -0
- package/dist/devcontainer-scaffold.js +165 -0
- package/dist/doc-index.js +3 -3
- package/dist/exec-agent-config.js +107 -9
- package/dist/exec-agent-git-state.js +18 -0
- package/dist/exec-agent-protected-config.js +46 -8
- package/dist/exec-commands.js +557 -0
- package/dist/exec-core.js +457 -0
- package/dist/exec-evidence.js +254 -11
- package/dist/exec-handoff.js +336 -0
- package/dist/exec-parent-validation.js +317 -43
- package/dist/exec-pipeline-state.js +74 -9
- package/dist/exec-plans-core.js +693 -0
- package/dist/exec-plans-generation.js +206 -0
- package/dist/exec-plans-storage.js +131 -0
- package/dist/exec-plans.js +3 -1016
- package/dist/exec-protection-handoff.js +43 -2
- package/dist/exec-provider-scaffold.js +247 -15
- package/dist/exec-register-resume.js +65 -19
- package/dist/exec-register.js +9 -3
- package/dist/exec-repo-integration-git.js +23 -0
- package/dist/exec-repo-integration-sync.js +264 -0
- package/dist/exec-repo-integration.js +534 -0
- package/dist/exec-repo-trace.js +182 -0
- package/dist/exec-reporter-output.js +206 -0
- package/dist/exec-reporter.js +525 -248
- package/dist/exec-results.js +103 -71
- package/dist/exec-run-agent-pipeline.js +256 -0
- package/dist/exec-run-agent.js +531 -0
- package/dist/exec-run-in-place.js +541 -0
- package/dist/exec-run-job.js +717 -0
- package/dist/exec-run-lifecycle-commands.js +522 -0
- package/dist/exec-run-lock.js +110 -107
- package/dist/exec-run-mode-shared.js +140 -0
- package/dist/exec-run-register-command.js +244 -0
- package/dist/exec-run-register-core.js +386 -0
- package/dist/exec-run-register-mode.js +206 -0
- package/dist/exec-run-register-resume.js +393 -0
- package/dist/exec-run-register-state.js +322 -0
- package/dist/exec-run-register-worktree.js +509 -0
- package/dist/exec-run-schedule-mode.js +294 -0
- package/dist/exec-run-schedule-prepare.js +353 -0
- package/dist/exec-run-schedule-task.js +572 -0
- package/dist/exec-run-shared.js +399 -0
- package/dist/exec-run.js +11 -4953
- package/dist/exec-shared.js +9 -2
- package/dist/exec-slot-lock.js +242 -0
- package/dist/exec-task-repos.js +415 -0
- package/dist/exec-trial-commands.js +558 -0
- package/dist/exec-trial-core.js +371 -0
- package/dist/exec-trial.js +2 -895
- package/dist/exec-worktree-command.js +87 -43
- package/dist/exec-worktree-ops-commit.js +707 -0
- package/dist/exec-worktree-ops-lifecycle.js +292 -0
- package/dist/exec-worktree-ops-merge.js +303 -0
- package/dist/exec-worktree-ops.js +3 -847
- package/dist/exec-worktree.js +146 -31
- package/dist/exec.js +2 -999
- package/dist/frontmatter-namespace.js +2 -2
- package/dist/grade-apply.js +734 -0
- package/dist/grade-command-apply.js +250 -0
- package/dist/grade-command-inspect.js +138 -0
- package/dist/grade-command-plan.js +101 -0
- package/dist/grade-command-shared.js +68 -0
- package/dist/grade-core.js +307 -0
- package/dist/grade-markdown.js +274 -0
- package/dist/grade-pipeline-state.js +184 -0
- package/dist/grade-plan.js +507 -0
- package/dist/grade-result.js +133 -5
- package/dist/grade-target-discovery.js +265 -0
- package/dist/grade-targets.js +432 -0
- package/dist/grade.js +14 -2451
- package/dist/init-command.js +443 -0
- package/dist/job-definition.js +670 -0
- package/dist/job.js +64 -578
- package/dist/kata-command.js +2 -2
- package/dist/orchestrator.js +213 -0
- package/dist/register-command-types.js +1 -0
- package/dist/register-core.js +363 -0
- package/dist/register-create-commands.js +245 -0
- package/dist/register-event-merge.js +169 -0
- package/dist/register-events.js +4 -4
- package/dist/register-item.js +13 -7
- package/dist/register-maintenance-commands.js +187 -0
- package/dist/register-migration.js +268 -0
- package/dist/register-renumber.js +314 -0
- package/dist/register-transition-commands.js +248 -0
- package/dist/register-update.js +230 -0
- package/dist/register-views.js +256 -0
- package/dist/register.js +175 -1975
- package/dist/review-grade.js +252 -0
- package/dist/review-plan.js +114 -4
- package/dist/review-types.js +40 -1
- package/dist/routine-definition.js +401 -0
- package/dist/routine.js +73 -402
- package/dist/schedule-approach.js +2 -2
- package/dist/schedule-build.js +2 -2
- package/dist/schedule-strategy-generate-document.js +273 -0
- package/dist/schedule-strategy-generate-scope.js +199 -0
- package/dist/schedule-strategy-generate.js +9 -473
- package/dist/schedule.js +19 -6
- package/dist/specdojo-config.js +465 -20
- package/dist/specdojo-gitignore.js +135 -0
- package/dist/specdojo.js +6 -0
- package/dist/viewpoint-document-kinds-check.js +128 -0
- package/dist/yaml-pages.js +4 -4
- package/dist/yaml.js +28 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
- package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
- package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
- package/docs/ja/specdojo/guides/exec-config-guide.md +93 -49
- package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
- package/docs/ja/specdojo/guides/kata-guide.md +4 -4
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +45 -22
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
- package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
- package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
- package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
- package/docs/ja/specdojo/guides/review-guide.md +195 -158
- package/docs/ja/specdojo/guides/routine-operation-guide.md +75 -10
- package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
- package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
- package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
- package/docs/ja/specdojo/guides/waza-guide.md +15 -2
- package/docs/ja/specdojo/index.md +2 -2
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
- package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
- package/docs/ja/specdojo/references/command-reference.md +335 -92
- package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
- package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
- package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
- package/docs/ja/specdojo/samples/bps-sample.md +74 -21
- package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
- package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
- package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
- package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
- package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
- package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
- package/docs/ja/specdojo/templates/bps-template.md +91 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
- package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
- package/package.json +17 -12
- package/templates/antigravity/README.md +29 -4
- package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
- package/templates/antigravity/exec-defaults-snippet.yaml +10 -7
- package/templates/antigravity/orchestrator.md +18 -7
- package/templates/antigravity/settings.global.json +55 -0
- package/templates/claude/agents/claude-executor.md +14 -0
- package/templates/claude/agents/claude-reporter.md +16 -0
- package/templates/claude/agents/specdojo-orchestrator.md +18 -7
- package/templates/claude/settings.edit.json +27 -1
- package/templates/codex/README.md +5 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
- package/templates/codex/orchestrator.md +18 -7
- package/templates/copilot/README.md +7 -5
- package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
- package/templates/devcontainer/devcontainer.json +27 -0
- package/templates/devcontainer/emacs/init.el +88 -0
- package/templates/devcontainer/post-create.sh +62 -0
- package/templates/init-agent-members.yaml +200 -0
- package/templates/init-exec-defaults.yaml +74 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
# GitHub Copilot CLI
|
|
2
|
-
#
|
|
1
|
+
# GitHub Copilot CLI agent 定義のスニペット。
|
|
2
|
+
# members の要素をリポジトリ共通の .specdojo/agent-members.yaml へコピーして使う。
|
|
3
|
+
# project ごとの pm-members.yaml は人間専用なので、agent は記載しない。
|
|
3
4
|
# 起動コマンドは member には書かず、.specdojo/exec-defaults.yaml の
|
|
4
5
|
# providers.copilot.command_template で定義する(exec-defaults-snippet.yaml を参照)。
|
|
5
6
|
# 設計の背景は exec-config-guide.md の
|
|
6
7
|
# 「agent 権限とプロンプトインジェクション対策」を参照。
|
|
7
8
|
|
|
9
|
+
version: 1
|
|
8
10
|
members:
|
|
9
11
|
- nickname: copilot-edit-agent
|
|
10
12
|
disabled: true
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "specdojo-agent-env",
|
|
3
|
+
"image": "mcr.microsoft.com/devcontainers/typescript-node:22",
|
|
4
|
+
"remoteUser": "node",
|
|
5
|
+
"init": true,
|
|
6
|
+
"workspaceMount": "source=${localWorkspaceFolder}/..,target=/workspaces/specdojo-workspace,type=bind,consistency=cached",
|
|
7
|
+
"workspaceFolder": "/workspaces/specdojo-workspace/${localWorkspaceFolderBasename}",
|
|
8
|
+
"features": {
|
|
9
|
+
"ghcr.io/devcontainers/features/common-utils:2": {
|
|
10
|
+
"installZsh": false,
|
|
11
|
+
"upgradePackages": false
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"mounts": [
|
|
15
|
+
"source=specdojo-git,target=/home/node/.config/git,type=volume",
|
|
16
|
+
"source=specdojo-gh,target=/home/node/.config/gh,type=volume"
|
|
17
|
+
],
|
|
18
|
+
"containerEnv": {
|
|
19
|
+
"GIT_CONFIG_GLOBAL": "/home/node/.config/git/config"
|
|
20
|
+
},
|
|
21
|
+
"postCreateCommand": "bash .devcontainer/post-create.sh",
|
|
22
|
+
"customizations": {
|
|
23
|
+
"vscode": {
|
|
24
|
+
"extensions": []
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
;;; init.el --- SpecDojo Dev Container Emacs defaults -*- lexical-binding: t; -*-
|
|
2
|
+
|
|
3
|
+
;;; Commentary:
|
|
4
|
+
;; A dependency-free starting point for terminal Emacs in a generated Dev Container.
|
|
5
|
+
;; Every section is intentionally independent so that users can change or remove it.
|
|
6
|
+
|
|
7
|
+
;;; Code:
|
|
8
|
+
|
|
9
|
+
;; Use UTF-8 for files, the terminal, and subprocess communication.
|
|
10
|
+
(set-language-environment "UTF-8")
|
|
11
|
+
(prefer-coding-system 'utf-8-unix)
|
|
12
|
+
(set-default-coding-systems 'utf-8-unix)
|
|
13
|
+
(set-terminal-coding-system 'utf-8-unix)
|
|
14
|
+
(set-keyboard-coding-system 'utf-8-unix)
|
|
15
|
+
|
|
16
|
+
;; Make C-h delete backward. Help remains available on C-x ? and <f1>.
|
|
17
|
+
(global-set-key (kbd "C-h") #'delete-backward-char)
|
|
18
|
+
(global-set-key (kbd "C-x ?") help-map)
|
|
19
|
+
|
|
20
|
+
;; Show line numbers and highlight the parenthesis matching the one at point.
|
|
21
|
+
(global-display-line-numbers-mode 1)
|
|
22
|
+
(show-paren-mode 1)
|
|
23
|
+
|
|
24
|
+
;; Keep backup and auto-save data under ~/.local/share/emacs, outside the worktree.
|
|
25
|
+
(let ((backup-directory (expand-file-name "~/.local/share/emacs/backups/"))
|
|
26
|
+
(auto-save-directory (expand-file-name "~/.local/share/emacs/auto-save/")))
|
|
27
|
+
(unless noninteractive
|
|
28
|
+
(make-directory backup-directory t)
|
|
29
|
+
(make-directory auto-save-directory t))
|
|
30
|
+
(setq backup-directory-alist `(("." . ,backup-directory))
|
|
31
|
+
auto-save-file-name-transforms `((".*" ,auto-save-directory t))
|
|
32
|
+
auto-save-list-file-prefix (expand-file-name ".saves-" auto-save-directory)))
|
|
33
|
+
|
|
34
|
+
;; Enable mouse reporting when Emacs is running in a terminal.
|
|
35
|
+
(when (and (not window-system) (fboundp 'xterm-mouse-mode))
|
|
36
|
+
(xterm-mouse-mode 1))
|
|
37
|
+
|
|
38
|
+
;; Provide dependency-free major modes for file types whose richer modes normally need packages
|
|
39
|
+
;; or tree-sitter grammars. These modes retain basic built-in editing and syntax support.
|
|
40
|
+
(define-derived-mode specdojo-typescript-mode js-mode "TypeScript"
|
|
41
|
+
"Edit TypeScript using Emacs's built-in JavaScript syntax support.")
|
|
42
|
+
(define-derived-mode specdojo-markdown-mode text-mode "Markdown"
|
|
43
|
+
"Edit Markdown using Emacs's built-in text editing support.")
|
|
44
|
+
(define-derived-mode specdojo-yaml-mode conf-mode "YAML"
|
|
45
|
+
"Edit YAML using Emacs's built-in configuration-file support.")
|
|
46
|
+
|
|
47
|
+
;; Select the dependency-free modes for TypeScript, Markdown, and YAML files.
|
|
48
|
+
(add-to-list 'auto-mode-alist '("\\.tsx?\\'" . specdojo-typescript-mode))
|
|
49
|
+
(add-to-list 'auto-mode-alist '("\\.md\\'" . specdojo-markdown-mode))
|
|
50
|
+
(add-to-list 'auto-mode-alist '("\\.ya?ml\\'" . specdojo-yaml-mode))
|
|
51
|
+
|
|
52
|
+
;; Tell the built-in Eglot client which bundled language server belongs to each mode.
|
|
53
|
+
(with-eval-after-load 'eglot
|
|
54
|
+
(add-to-list 'eglot-server-programs
|
|
55
|
+
'((specdojo-typescript-mode :language-id "typescript")
|
|
56
|
+
. ("typescript-language-server" "--stdio")))
|
|
57
|
+
(add-to-list 'eglot-server-programs
|
|
58
|
+
'(specdojo-markdown-mode . ("marksman" "server")))
|
|
59
|
+
(add-to-list 'eglot-server-programs
|
|
60
|
+
'(specdojo-yaml-mode . ("yaml-language-server" "--stdio"))))
|
|
61
|
+
|
|
62
|
+
;; Start Eglot only when the matching server executable exists. A startup failure is reported as
|
|
63
|
+
;; a message and leaves the buffer available for normal editing.
|
|
64
|
+
(defun specdojo-eglot-ensure-if-available ()
|
|
65
|
+
"Start Eglot when the language server for the current buffer is installed."
|
|
66
|
+
(let ((server (alist-get major-mode
|
|
67
|
+
'((specdojo-typescript-mode . "typescript-language-server")
|
|
68
|
+
(specdojo-markdown-mode . "marksman")
|
|
69
|
+
(specdojo-yaml-mode . "yaml-language-server")
|
|
70
|
+
(sh-mode . "bash-language-server")))))
|
|
71
|
+
(when (and server (executable-find server))
|
|
72
|
+
(condition-case error-data
|
|
73
|
+
(progn
|
|
74
|
+
(require 'eglot)
|
|
75
|
+
(eglot-ensure))
|
|
76
|
+
(error
|
|
77
|
+
(message "SpecDojo: Eglot did not start: %s"
|
|
78
|
+
(error-message-string error-data)))))))
|
|
79
|
+
|
|
80
|
+
;; Connect supported TypeScript, Markdown, YAML, and shell buffers to their LSP servers.
|
|
81
|
+
(dolist (hook '(specdojo-typescript-mode-hook
|
|
82
|
+
specdojo-markdown-mode-hook
|
|
83
|
+
specdojo-yaml-mode-hook
|
|
84
|
+
sh-mode-hook))
|
|
85
|
+
(add-hook hook #'specdojo-eglot-ensure-if-available))
|
|
86
|
+
|
|
87
|
+
(provide 'init)
|
|
88
|
+
;;; init.el ends here
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
set -euo pipefail
|
|
3
|
+
|
|
4
|
+
# Some installers place binaries under ~/.local/bin.
|
|
5
|
+
if [ -d "${HOME}/.local/bin" ]; then
|
|
6
|
+
export PATH="${HOME}/.local/bin:${PATH}"
|
|
7
|
+
fi
|
|
8
|
+
|
|
9
|
+
# Docker creates named volume mount points as root when the image lacks them. Hand them back to
|
|
10
|
+
# the container user before git config and agent installers write into them.
|
|
11
|
+
for dir in \
|
|
12
|
+
"${HOME}/.config" \
|
|
13
|
+
"${HOME}/.config/git" \
|
|
14
|
+
"${HOME}/.claude" \
|
|
15
|
+
"${HOME}/.codex" \
|
|
16
|
+
"${HOME}/.config/gh" \
|
|
17
|
+
"${HOME}/.config/opencode" \
|
|
18
|
+
"${HOME}/.local/share/opencode" \
|
|
19
|
+
"${HOME}/.config/antigravity"; do
|
|
20
|
+
if [ -d "$dir" ]; then
|
|
21
|
+
sudo chown -R "$(id -u):$(id -g)" "$dir"
|
|
22
|
+
fi
|
|
23
|
+
done
|
|
24
|
+
|
|
25
|
+
# Include the host ~/.gitconfig copied by Dev Containers at the top of the volume-backed global
|
|
26
|
+
# config, so identity and other host settings take effect while container-specific settings written
|
|
27
|
+
# below still win. A missing include file is ignored by git.
|
|
28
|
+
HOST_GIT_CONFIG="${HOME}/.gitconfig"
|
|
29
|
+
GIT_CONFIG_FILE="${GIT_CONFIG_GLOBAL:-}"
|
|
30
|
+
if [ -n "$GIT_CONFIG_FILE" ] && [ "$GIT_CONFIG_FILE" != "$HOST_GIT_CONFIG" ]; then
|
|
31
|
+
touch "$GIT_CONFIG_FILE"
|
|
32
|
+
include_paths="$(git config --file "$GIT_CONFIG_FILE" --get-all include.path || true)"
|
|
33
|
+
if ! printf '%s\n' "$include_paths" | grep -qxF "$HOST_GIT_CONFIG"; then
|
|
34
|
+
tmp="$(mktemp "${GIT_CONFIG_FILE}.XXXXXX")"
|
|
35
|
+
{ printf '[include]\n\tpath = %s\n' "$HOST_GIT_CONFIG"; cat "$GIT_CONFIG_FILE"; } >"$tmp"
|
|
36
|
+
chmod 600 "$tmp"
|
|
37
|
+
mv "$tmp" "$GIT_CONFIG_FILE"
|
|
38
|
+
fi
|
|
39
|
+
fi
|
|
40
|
+
|
|
41
|
+
WORKSPACE_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
|
|
42
|
+
WORKSPACE_PARENT="$(dirname "$WORKSPACE_DIR")"
|
|
43
|
+
SAFE_DIRECTORY_SCOPE="${WORKSPACE_PARENT}/*"
|
|
44
|
+
|
|
45
|
+
# Trust repositories and worktrees under the mounted workspace parent. Keep entries unique to avoid
|
|
46
|
+
# unbounded growth across rebuilds.
|
|
47
|
+
SAFE_DIRS="$(git config --global --get-all safe.directory 2>/dev/null || true)"
|
|
48
|
+
if [ -n "$SAFE_DIRS" ]; then
|
|
49
|
+
git config --global --unset-all safe.directory || true
|
|
50
|
+
while IFS= read -r dir; do
|
|
51
|
+
[ -n "$dir" ] || continue
|
|
52
|
+
git config --global --add safe.directory "$dir"
|
|
53
|
+
done < <(printf '%s\n%s\n%s\n' "$SAFE_DIRS" "$WORKSPACE_DIR" "$SAFE_DIRECTORY_SCOPE" | awk '!seen[$0]++')
|
|
54
|
+
else
|
|
55
|
+
git config --global --add safe.directory "$WORKSPACE_DIR"
|
|
56
|
+
git config --global --add safe.directory "$SAFE_DIRECTORY_SCOPE"
|
|
57
|
+
fi
|
|
58
|
+
|
|
59
|
+
git config --global core.quotepath false
|
|
60
|
+
git config --global core.autocrlf input
|
|
61
|
+
|
|
62
|
+
npm install
|
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
# yaml-language-server: $schema=../docs/specdojo/schemas/v1/agent-members.schema.yaml
|
|
2
|
+
# Agent definitions used by `specdojo init --exec`.
|
|
3
|
+
# The init command selects only the members whose provider was requested.
|
|
4
|
+
version: 1
|
|
5
|
+
members:
|
|
6
|
+
- nickname: claude-executor
|
|
7
|
+
display_name: Claude Executor
|
|
8
|
+
email: null
|
|
9
|
+
roles: []
|
|
10
|
+
type: agent
|
|
11
|
+
provider: claude
|
|
12
|
+
mode: edit
|
|
13
|
+
stage_role: executor
|
|
14
|
+
capabilities: [web_search]
|
|
15
|
+
proficiency: normal
|
|
16
|
+
priority: 2
|
|
17
|
+
persona: task-executor
|
|
18
|
+
scheduler_strategy: critical-first
|
|
19
|
+
- nickname: claude-review-executor
|
|
20
|
+
display_name: Claude Review Executor
|
|
21
|
+
email: null
|
|
22
|
+
roles: []
|
|
23
|
+
type: agent
|
|
24
|
+
provider: claude
|
|
25
|
+
mode: review
|
|
26
|
+
stage_role: executor
|
|
27
|
+
capabilities: [web_search]
|
|
28
|
+
proficiency: normal
|
|
29
|
+
priority: 2
|
|
30
|
+
persona: multi-viewpoint-reviewer
|
|
31
|
+
scheduler_strategy: fifo
|
|
32
|
+
- nickname: claude-reporter
|
|
33
|
+
display_name: Claude Reporter
|
|
34
|
+
email: null
|
|
35
|
+
roles: []
|
|
36
|
+
type: agent
|
|
37
|
+
provider: claude
|
|
38
|
+
mode: report
|
|
39
|
+
stage_role: reporter
|
|
40
|
+
capabilities: []
|
|
41
|
+
proficiency: normal
|
|
42
|
+
priority: 2
|
|
43
|
+
persona: execution-reporter
|
|
44
|
+
scheduler_strategy: fifo
|
|
45
|
+
|
|
46
|
+
- nickname: codex-executor
|
|
47
|
+
display_name: Codex Executor
|
|
48
|
+
email: null
|
|
49
|
+
roles: []
|
|
50
|
+
type: agent
|
|
51
|
+
provider: codex
|
|
52
|
+
mode: edit
|
|
53
|
+
stage_role: executor
|
|
54
|
+
capabilities: [web_search]
|
|
55
|
+
proficiency: normal
|
|
56
|
+
priority: 1
|
|
57
|
+
persona: task-executor
|
|
58
|
+
scheduler_strategy: critical-first
|
|
59
|
+
- nickname: codex-review-executor
|
|
60
|
+
display_name: Codex Review Executor
|
|
61
|
+
email: null
|
|
62
|
+
roles: []
|
|
63
|
+
type: agent
|
|
64
|
+
provider: codex
|
|
65
|
+
mode: review
|
|
66
|
+
stage_role: executor
|
|
67
|
+
capabilities: [web_search]
|
|
68
|
+
proficiency: normal
|
|
69
|
+
priority: 1
|
|
70
|
+
persona: multi-viewpoint-reviewer
|
|
71
|
+
scheduler_strategy: fifo
|
|
72
|
+
- nickname: codex-reporter
|
|
73
|
+
display_name: Codex Reporter
|
|
74
|
+
email: null
|
|
75
|
+
roles: []
|
|
76
|
+
type: agent
|
|
77
|
+
provider: codex
|
|
78
|
+
stage_role: reporter
|
|
79
|
+
capabilities: []
|
|
80
|
+
proficiency: normal
|
|
81
|
+
priority: 1
|
|
82
|
+
persona: execution-reporter
|
|
83
|
+
scheduler_strategy: fifo
|
|
84
|
+
|
|
85
|
+
- nickname: opencode-executor
|
|
86
|
+
display_name: OpenCode Executor
|
|
87
|
+
email: null
|
|
88
|
+
roles: []
|
|
89
|
+
type: agent
|
|
90
|
+
provider: opencode
|
|
91
|
+
mode: edit
|
|
92
|
+
stage_role: executor
|
|
93
|
+
capabilities: [web_search]
|
|
94
|
+
proficiency: normal
|
|
95
|
+
priority: 3
|
|
96
|
+
persona: task-executor
|
|
97
|
+
scheduler_strategy: critical-first
|
|
98
|
+
- nickname: opencode-review-executor
|
|
99
|
+
display_name: OpenCode Review Executor
|
|
100
|
+
email: null
|
|
101
|
+
roles: []
|
|
102
|
+
type: agent
|
|
103
|
+
provider: opencode
|
|
104
|
+
mode: review
|
|
105
|
+
stage_role: executor
|
|
106
|
+
capabilities: [web_search]
|
|
107
|
+
proficiency: normal
|
|
108
|
+
priority: 3
|
|
109
|
+
persona: multi-viewpoint-reviewer
|
|
110
|
+
scheduler_strategy: fifo
|
|
111
|
+
- nickname: opencode-reporter
|
|
112
|
+
display_name: OpenCode Reporter
|
|
113
|
+
email: null
|
|
114
|
+
roles: []
|
|
115
|
+
type: agent
|
|
116
|
+
provider: opencode
|
|
117
|
+
stage_role: reporter
|
|
118
|
+
capabilities: []
|
|
119
|
+
proficiency: normal
|
|
120
|
+
priority: 3
|
|
121
|
+
persona: execution-reporter
|
|
122
|
+
scheduler_strategy: fifo
|
|
123
|
+
|
|
124
|
+
- nickname: agy-executor
|
|
125
|
+
display_name: Antigravity Executor
|
|
126
|
+
email: null
|
|
127
|
+
roles: []
|
|
128
|
+
type: agent
|
|
129
|
+
provider: antigravity
|
|
130
|
+
mode: edit
|
|
131
|
+
stage_role: executor
|
|
132
|
+
capabilities: [web_search]
|
|
133
|
+
proficiency: normal
|
|
134
|
+
priority: 4
|
|
135
|
+
persona: task-executor
|
|
136
|
+
scheduler_strategy: critical-first
|
|
137
|
+
- nickname: agy-review-executor
|
|
138
|
+
display_name: Antigravity Review Executor
|
|
139
|
+
email: null
|
|
140
|
+
roles: []
|
|
141
|
+
type: agent
|
|
142
|
+
provider: antigravity
|
|
143
|
+
mode: review
|
|
144
|
+
stage_role: executor
|
|
145
|
+
capabilities: [web_search]
|
|
146
|
+
proficiency: normal
|
|
147
|
+
priority: 4
|
|
148
|
+
persona: multi-viewpoint-reviewer
|
|
149
|
+
scheduler_strategy: fifo
|
|
150
|
+
- nickname: agy-reporter
|
|
151
|
+
display_name: Antigravity Reporter
|
|
152
|
+
email: null
|
|
153
|
+
roles: []
|
|
154
|
+
type: agent
|
|
155
|
+
provider: antigravity
|
|
156
|
+
stage_role: reporter
|
|
157
|
+
capabilities: []
|
|
158
|
+
proficiency: normal
|
|
159
|
+
priority: 4
|
|
160
|
+
persona: execution-reporter
|
|
161
|
+
scheduler_strategy: fifo
|
|
162
|
+
|
|
163
|
+
- nickname: copilot-executor
|
|
164
|
+
display_name: Copilot Executor
|
|
165
|
+
email: null
|
|
166
|
+
roles: []
|
|
167
|
+
type: agent
|
|
168
|
+
provider: copilot
|
|
169
|
+
mode: edit
|
|
170
|
+
stage_role: executor
|
|
171
|
+
capabilities: []
|
|
172
|
+
proficiency: normal
|
|
173
|
+
priority: 5
|
|
174
|
+
persona: task-executor
|
|
175
|
+
scheduler_strategy: critical-first
|
|
176
|
+
- nickname: copilot-review-executor
|
|
177
|
+
display_name: Copilot Review Executor
|
|
178
|
+
email: null
|
|
179
|
+
roles: []
|
|
180
|
+
type: agent
|
|
181
|
+
provider: copilot
|
|
182
|
+
mode: review
|
|
183
|
+
stage_role: executor
|
|
184
|
+
capabilities: []
|
|
185
|
+
proficiency: normal
|
|
186
|
+
priority: 5
|
|
187
|
+
persona: multi-viewpoint-reviewer
|
|
188
|
+
scheduler_strategy: fifo
|
|
189
|
+
- nickname: copilot-reporter
|
|
190
|
+
display_name: Copilot Reporter
|
|
191
|
+
email: null
|
|
192
|
+
roles: []
|
|
193
|
+
type: agent
|
|
194
|
+
provider: copilot
|
|
195
|
+
stage_role: reporter
|
|
196
|
+
capabilities: []
|
|
197
|
+
proficiency: normal
|
|
198
|
+
priority: 5
|
|
199
|
+
persona: execution-reporter
|
|
200
|
+
scheduler_strategy: fifo
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# yaml-language-server: $schema=../docs/specdojo/schemas/v1/exec-defaults.schema.yaml
|
|
2
|
+
# Runtime defaults used by `specdojo init --exec`.
|
|
3
|
+
# The init command keeps only the selected provider blocks.
|
|
4
|
+
pipeline:
|
|
5
|
+
parent_validations:
|
|
6
|
+
- lint-ts
|
|
7
|
+
- lint-fm
|
|
8
|
+
- lint-md
|
|
9
|
+
- test-integration
|
|
10
|
+
- validate-schema
|
|
11
|
+
- typecheck
|
|
12
|
+
- test-unit
|
|
13
|
+
run:
|
|
14
|
+
register_execution: worktree
|
|
15
|
+
rate_limit_detection:
|
|
16
|
+
exit_codes: []
|
|
17
|
+
stderr_patterns: [rate limit, "429"]
|
|
18
|
+
rate_limit_policy:
|
|
19
|
+
cooldown_seconds:
|
|
20
|
+
rate_limit: 900
|
|
21
|
+
on_non_critical:
|
|
22
|
+
action: skip
|
|
23
|
+
on_critical:
|
|
24
|
+
action: try_next
|
|
25
|
+
retry:
|
|
26
|
+
max_attempts: 3
|
|
27
|
+
initial_wait_seconds: 60
|
|
28
|
+
backoff_multiplier: 3
|
|
29
|
+
max_wait_seconds: 600
|
|
30
|
+
on_exhausted: block
|
|
31
|
+
providers:
|
|
32
|
+
claude:
|
|
33
|
+
command_template: "claude -p --verbose --agent {nickname} --settings .specdojo/claude/settings.{mode}.json"
|
|
34
|
+
rate_limit_detection:
|
|
35
|
+
stderr_patterns: [rate limit, "429", overloaded, session limit]
|
|
36
|
+
codex:
|
|
37
|
+
command_template: >-
|
|
38
|
+
codex exec --ephemeral --sandbox workspace-write -c approval_policy="never"
|
|
39
|
+
-c sandbox_workspace_write.network_access=false --model {model}
|
|
40
|
+
-c model_reasoning_effort="{effort}"
|
|
41
|
+
command_params:
|
|
42
|
+
by_proficiency:
|
|
43
|
+
normal: { model: gpt-5.6-terra, effort: medium }
|
|
44
|
+
expert: { model: gpt-5.6-sol, effort: high }
|
|
45
|
+
rate_limit_detection:
|
|
46
|
+
stderr_patterns: [rate limit, "429", session limit, weekly limit, usage limit]
|
|
47
|
+
opencode:
|
|
48
|
+
command_template: "opencode run --agent {nickname}"
|
|
49
|
+
max_concurrency: 1
|
|
50
|
+
rate_limit_detection:
|
|
51
|
+
exit_codes: []
|
|
52
|
+
stderr_patterns: [timeout, connection refused, out of memory, model is loading]
|
|
53
|
+
antigravity:
|
|
54
|
+
# 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
|
|
55
|
+
# expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
|
|
56
|
+
command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
|
|
57
|
+
command_params:
|
|
58
|
+
by_proficiency:
|
|
59
|
+
normal: { model: gemini-3.8-flash-medium }
|
|
60
|
+
expert: { model: gemini-3.8-flash-high }
|
|
61
|
+
rate_limit_detection:
|
|
62
|
+
stderr_patterns: [rate limit, "429", quota, RESOURCE_EXHAUSTED]
|
|
63
|
+
copilot:
|
|
64
|
+
command_template: >-
|
|
65
|
+
copilot -p "$(cat)" --no-color --no-ask-user --model auto
|
|
66
|
+
--no-remote --no-remote-export --disable-builtin-mcps
|
|
67
|
+
--allow-tool write --allow-tool 'shell(git status)' --allow-tool 'shell(git diff)'
|
|
68
|
+
--allow-tool 'shell(git log)' --allow-tool 'shell(git show)'
|
|
69
|
+
--allow-tool 'shell(npm run)' --allow-tool 'shell(npm test)'
|
|
70
|
+
--allow-tool 'shell(specdojo:*)' --deny-tool 'shell(git add)'
|
|
71
|
+
--deny-tool 'shell(git commit)' --deny-tool 'shell(git push)'
|
|
72
|
+
--deny-tool 'shell(git reset)'
|
|
73
|
+
rate_limit_detection:
|
|
74
|
+
stderr_patterns: [rate limit, "429", quota, premium request]
|
|
@@ -57,16 +57,17 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
57
57
|
- コマンドは「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、実行するコマンドを提示して利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
|
|
58
58
|
- 破壊的変更や `git push` は行わない。
|
|
59
59
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
60
|
-
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。
|
|
60
|
+
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
61
61
|
- 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
|
|
62
62
|
- commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
|
|
63
63
|
- register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
|
|
64
64
|
- 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
|
|
65
65
|
- `exec run` は現在ブランチを統合先にするため、実行前に対象 project の `develop` にいることを確認する。
|
|
66
66
|
- exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
|
|
67
|
-
- commit メッセージは subject を日本語で書き、conventional commit の type と scope
|
|
67
|
+
- commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」を日本語で書き、関連する登録簿項目があれば `Refs: <project-id>:<PJR-XXXX>`(例: `Refs: prj-0001:PJR-36QG`)を記載する。項目ごとに 1 行とし、過去の commit の書式は書き換えない。
|
|
68
68
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
69
69
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
70
|
+
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
70
71
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
71
72
|
- 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
|
|
72
73
|
- タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
|
|
@@ -126,28 +127,38 @@ type は次のように使い分ける。
|
|
|
126
127
|
| `question` | 判断を保留し、後で決める | `decided` |
|
|
127
128
|
| `risk` | 将来の不確実性 | `done` |
|
|
128
129
|
| `change-request` | 合意済み範囲の変更要求 | `done` |
|
|
129
|
-
| `note` | 記録として残す観測・分析 |
|
|
130
|
+
| `note` | 記録として残す観測・分析 | なし |
|
|
130
131
|
|
|
131
|
-
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic`
|
|
132
|
+
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
132
133
|
|
|
133
134
|
```bash
|
|
134
135
|
npx specdojo register add --project <project-id> \
|
|
135
136
|
--type todo --title "<title>" --description "<description>" \
|
|
136
|
-
--priority high --owner DEV --due <YYYY-MM-DD>
|
|
137
|
+
--topic <topic> --priority high --owner DEV --due <YYYY-MM-DD>
|
|
137
138
|
```
|
|
138
139
|
|
|
140
|
+
起票の前に、会話から type・タイトル・説明・優先度・担当・期限を読み取る。読み取れたものは推奨値として示し、足りないものだけを質問する。担当と期限は会話で確定していなければ推測で埋めず、「未定のまま起票する」か「値を決める」かを利用者に選んでもらう。
|
|
141
|
+
|
|
142
|
+
起票後は、個票の `_TODO_`(`概要` / `完了条件` / `作業内容` など)に入れる内容の案を、会話で確かめた事実だけから作って示す。承認を得てから個票へ書き込み、`register build` で一覧を更新する。事実が足りない箇所は `_TODO_` のまま残し、何が足りないかを伝える。
|
|
143
|
+
|
|
139
144
|
起票後は個票を開き、`概要` / `完了条件` / `作業内容` を埋める。**完了条件は exec plan の入力になる**ため、検証可能な形で書く。曖昧なまま実行へ流すと、agent が意図と違う範囲を実装する。
|
|
140
145
|
|
|
141
146
|
状態遷移は次で行う。`exec run --register` を使う場合、`start` と `review` は runner が自動で記帳するため手で打たない。
|
|
142
147
|
|
|
148
|
+
記帳は `--commit` を付けて行う。`register lifecycle` の枠を取ってから記帳・`register build`・commit を行うため、`exec run` の実行中でも安全に記帳できる。commit 対象は、そのコマンドが変更した個票とイベントだけになる。
|
|
149
|
+
|
|
143
150
|
```bash
|
|
144
151
|
npx specdojo register close --project <project-id> --id <PJR-XXXX> \
|
|
145
|
-
--conclusion "<結論>" --by <actor> --reason "<理由>"
|
|
146
|
-
|
|
152
|
+
--conclusion "<結論>" --by <actor> --reason "<理由>" \
|
|
153
|
+
--commit -m "docs(register <PJR-XXXX>): <日本語の subject>"
|
|
147
154
|
```
|
|
148
155
|
|
|
156
|
+
`-m` の本文には、commit メッセージの方針(「なぜ」と `Refs: <project-id>:<PJR-XXXX>`)を守って書く。`register add` / `update` / `reject` / `defer` / `reopen` も同じく `--commit` を使う。
|
|
157
|
+
|
|
149
158
|
`decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
|
|
150
159
|
|
|
160
|
+
`note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
|
|
161
|
+
|
|
151
162
|
## 実践の型(kata)の扱い
|
|
152
163
|
|
|
153
164
|
rulebook・standard・recipe・sample・template は、既定では npm package(`node_modules/specdojo`)から参照する。利用リポジトリへコピーされていないのが正常である。
|