specdojo 0.4.3 → 0.4.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/.github/agents/specdojo-orchestrator.md +2 -0
- package/CHANGELOG.md +12 -0
- package/dist/catalog/build.js +8 -6
- package/dist/docs/doc-index.js +11 -0
- package/dist/kata/authoring.js +60 -14
- package/dist/kata/command.js +40 -28
- package/dist/kata/kata.js +26 -12
- package/dist/register/core.js +3 -3
- package/dist/register/item.js +31 -5
- package/dist/shared/text.js +3 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +1 -1
- package/docs/ja/specdojo/guides/kata-guide.md +3 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +4 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +1 -1
- package/docs/ja/specdojo/references/command-reference.md +1 -1
- package/docs/ja/specdojo/references/specdojo-config-reference.md +1 -1
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +2 -1
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +4 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +3 -3
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +4 -4
- package/docs/ja/specdojo/standards/template-authoring-standard.md +3 -3
- package/package.json +9 -9
- package/templates/antigravity/orchestrator.md +2 -0
- package/templates/claude/agents/specdojo-orchestrator.md +2 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
- package/templates/codex/orchestrator.md +2 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
|
@@ -10,6 +10,8 @@ model: claude-sonnet-4.6
|
|
|
10
10
|
|
|
11
11
|
あなたは SpecDojo の対話型オーケストレーターです。利用者との会話から意図を読み取り、`specdojo` CLI(`register` / `exec` / `kata` / `catalog` / `schedule` / `routine` など)を用いてプロジェクト実行管理を代行します。1件のタスクを黙々と処理する edit / review agent とは異なり、あなたは会話を通じて「何をしたいか」を明確化し、適切なコマンドへ落とし込み、実行と報告を行う司令塔です。
|
|
12
12
|
|
|
13
|
+
この文書そのものがオーケストレーターへの指示の全体である。同じ名前の Skill(`SKILL.md`)や agent の定義のファイルを別に探して読まない。
|
|
14
|
+
|
|
13
15
|
CLI は利用リポジトリへローカル導入されるため、`npx specdojo <command>` で起動する。`node_modules/.bin` が `PATH` に入る環境(VS Code 統合ターミナルなど)では `specdojo` と打てるが、提示するコマンドは `npx specdojo` で統一する。
|
|
14
16
|
|
|
15
17
|
## 基本方針
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,18 @@
|
|
|
2
2
|
|
|
3
3
|
SpecDojo の利用者に影響する変更を記録します。
|
|
4
4
|
|
|
5
|
+
## [0.4.4] - 2026-10-24
|
|
6
|
+
|
|
7
|
+
### 変更
|
|
8
|
+
|
|
9
|
+
- 利用者が作る kata の配置を `docs/ja/kata/<種類>s/` から `docs/ja/specdojo/<種類>s/<kata_authority>/` へ変更しました。0.4.4 のあいだは旧配置も警告付きで読み、新旧に同じ ID がある場合は新配置を優先します(PJR-EKRW)。
|
|
10
|
+
|
|
11
|
+
### 不具合修正
|
|
12
|
+
|
|
13
|
+
- `init --catalog small` が生成する、成果物がまだない領域の空の `groups` を `catalog build`・`catalog validate`・`specdojo build` が受理するようにしました。`groups` の省略や配列以外の値は引き続きエラーにします(PJR-C95G)。
|
|
14
|
+
- `register build` が生成する登録簿一覧・派生ビュー・PM ログで、自由記述セルの素の HTTP(S) URL を autolink にするようにしました。全角の括弧や句読点、半角の閉じ括弧は URL の外へ残し、既存の autolink・Markdown link・コードスパンは保持するため、markdownlint(MD034)で止まりません(PJR-4J4A)。
|
|
15
|
+
- 同梱のオーケストレーターの本文の冒頭に、この文書そのものが指示の全体であり、同じ名前の Skill や agent の定義のファイルを別に探さないことを加えました。codex で起動したときに、存在しない `SKILL.md` を読もうとして警告が出ていました(PJR-YYSD)。
|
|
16
|
+
|
|
5
17
|
## [0.4.3] - 2026-10-23
|
|
6
18
|
|
|
7
19
|
### 追加機能
|
package/dist/catalog/build.js
CHANGED
|
@@ -417,9 +417,13 @@ export function validateDctDoc(doc, filePath, knownLocalIds, repoRoot) {
|
|
|
417
417
|
errors.push(`${filePath}: missing required field: project_id`);
|
|
418
418
|
if (!doc.domain)
|
|
419
419
|
errors.push(`${filePath}: missing required field: domain`);
|
|
420
|
-
if (!
|
|
421
|
-
errors.push(`${filePath}:
|
|
420
|
+
if (!Object.hasOwn(doc, "groups")) {
|
|
421
|
+
errors.push(`${filePath}: missing required field: groups`);
|
|
422
|
+
}
|
|
423
|
+
else if (!Array.isArray(doc.groups)) {
|
|
424
|
+
errors.push(`${filePath}: groups must be an array`);
|
|
422
425
|
}
|
|
426
|
+
const groups = Array.isArray(doc.groups) ? doc.groups : [];
|
|
423
427
|
const localIds = new Set();
|
|
424
428
|
function collectIds(sections) {
|
|
425
429
|
for (const section of sections) {
|
|
@@ -515,8 +519,7 @@ export function validateDctDoc(doc, filePath, knownLocalIds, repoRoot) {
|
|
|
515
519
|
collectIds(section.groups);
|
|
516
520
|
}
|
|
517
521
|
}
|
|
518
|
-
|
|
519
|
-
collectIds(doc.groups);
|
|
522
|
+
collectIds(groups);
|
|
520
523
|
const depLookup = knownLocalIds ?? localIds;
|
|
521
524
|
const depScope = knownLocalIds ? "catalog" : "this file";
|
|
522
525
|
function checkDeps(sections) {
|
|
@@ -536,8 +539,7 @@ export function validateDctDoc(doc, filePath, knownLocalIds, repoRoot) {
|
|
|
536
539
|
checkDeps(section.groups);
|
|
537
540
|
}
|
|
538
541
|
}
|
|
539
|
-
|
|
540
|
-
checkDeps(doc.groups);
|
|
542
|
+
checkDeps(groups);
|
|
541
543
|
return { ok: errors.length === 0, errors, warnings };
|
|
542
544
|
}
|
|
543
545
|
export { collectResolvedDeliverables, validateBasedOn };
|
package/dist/docs/doc-index.js
CHANGED
|
@@ -3,6 +3,7 @@ import { dirname, join, relative, resolve } from "node:path";
|
|
|
3
3
|
import { load } from "../shared/yaml.js";
|
|
4
4
|
import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
|
|
5
5
|
import { specdojoDirectoryPaths, specdojoReferencePath, } from "./template-resolution.js";
|
|
6
|
+
import { parsePracticeId } from "../shared/practice-id.js";
|
|
6
7
|
const SKIP_DIRS = new Set(["node_modules", "dist", ".vitepress", "out"]);
|
|
7
8
|
const FILE_RE = /\.(md|yaml|yml)$/;
|
|
8
9
|
const DOC_ID_RE = /^[a-z][a-z0-9:_-]+$/;
|
|
@@ -335,6 +336,16 @@ export function collectDocIndex(rootDir, repoRoot, configPath, options = {}) {
|
|
|
335
336
|
}
|
|
336
337
|
}
|
|
337
338
|
}
|
|
339
|
+
for (const id of packageCollector.keys()) {
|
|
340
|
+
try {
|
|
341
|
+
const authority = parsePracticeId(id).authority;
|
|
342
|
+
if (authority && authority !== "specdojo")
|
|
343
|
+
packageCollector.delete(id);
|
|
344
|
+
}
|
|
345
|
+
catch {
|
|
346
|
+
packageCollector.delete(id);
|
|
347
|
+
}
|
|
348
|
+
}
|
|
338
349
|
assertNoDuplicateIds(packageCollector);
|
|
339
350
|
// 同一 ID が両スコープにある場合は eject 済みの利用リポジトリ側を採用する。
|
|
340
351
|
// 走査順ではなくスコープで優先順位を決めるため、結果は決定的になる。
|
package/dist/kata/authoring.js
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
import { existsSync, readFileSync } from "node:fs";
|
|
2
|
-
import { extname,
|
|
2
|
+
import { extname, resolve } from "node:path";
|
|
3
3
|
import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
|
|
4
4
|
import { getKataAuthority, isSpecdojoSourceRepository, loadConfig, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
5
5
|
import { parsePracticeId, practiceLocalId } from "../shared/practice-id.js";
|
|
6
6
|
import { load } from "../shared/yaml.js";
|
|
7
7
|
import { resolveSpecdojoReferencePathIfExists } from "../docs/template-resolution.js";
|
|
8
|
-
export const KATA_AUTHORING_BASE = "docs/ja/
|
|
8
|
+
export const KATA_AUTHORING_BASE = "docs/ja/specdojo";
|
|
9
|
+
export const LEGACY_KATA_AUTHORING_BASE = "docs/ja/kata";
|
|
9
10
|
export const AUTHORING_KINDS = ["rulebook", "recipe", "sample", "template"];
|
|
10
11
|
const KIND_DIR = {
|
|
11
12
|
rulebook: "rulebooks",
|
|
@@ -26,14 +27,63 @@ export function isAuthoringApproach(approach) {
|
|
|
26
27
|
return (approach !== undefined &&
|
|
27
28
|
Object.prototype.hasOwnProperty.call(AUTHORING_KIND_BY_APPROACH, approach));
|
|
28
29
|
}
|
|
29
|
-
export function kataKindDirectory(kind
|
|
30
|
-
return
|
|
30
|
+
export function kataKindDirectory(kind) {
|
|
31
|
+
return `${KATA_AUTHORING_BASE}/${KIND_DIR[kind]}`;
|
|
32
|
+
}
|
|
33
|
+
export function authoredKataDirectory(kind, authority) {
|
|
34
|
+
const directory = kataKindDirectory(kind);
|
|
35
|
+
return authority === "specdojo" ? directory : `${directory}/${authority}`;
|
|
36
|
+
}
|
|
37
|
+
export function legacyKataKindDirectory(kind) {
|
|
38
|
+
return `${LEGACY_KATA_AUTHORING_BASE}/${KIND_DIR[kind]}`;
|
|
31
39
|
}
|
|
32
40
|
export function authoredKataPath(id, kind, extension = "md") {
|
|
33
|
-
const
|
|
34
|
-
const directory =
|
|
41
|
+
const authority = parsePracticeId(id).authority;
|
|
42
|
+
const directory = authoredKataDirectory(kind, authority ?? "specdojo");
|
|
35
43
|
return `${directory}/${practiceLocalId(id)}.${extension}`;
|
|
36
44
|
}
|
|
45
|
+
export function legacyAuthoredKataPath(id, kind, extension = "md") {
|
|
46
|
+
return `${legacyKataKindDirectory(kind)}/${practiceLocalId(id)}.${extension}`;
|
|
47
|
+
}
|
|
48
|
+
const warnedLegacyPaths = new Set();
|
|
49
|
+
export function warnLegacyAuthoredKata(id, canonicalPath, legacyPath, rootDir, duplicate) {
|
|
50
|
+
const warningKey = `${resolve(rootDir, legacyPath)}:${duplicate ? "duplicate" : "legacy"}`;
|
|
51
|
+
if (warnedLegacyPaths.has(warningKey))
|
|
52
|
+
return;
|
|
53
|
+
warnedLegacyPaths.add(warningKey);
|
|
54
|
+
const detail = duplicate
|
|
55
|
+
? `both ${canonicalPath} and legacy ${legacyPath} exist; using ${canonicalPath}; remove the legacy file`
|
|
56
|
+
: `legacy path ${legacyPath} is deprecated; move it to ${canonicalPath}`;
|
|
57
|
+
process.stderr.write(`warning: Kata ${id}: ${detail}.\n`);
|
|
58
|
+
}
|
|
59
|
+
export function resolveAuthoredKataPathIfExists(id, kind, extension, rootDir = specdojoRootDir()) {
|
|
60
|
+
const authority = parsePracticeId(id).authority;
|
|
61
|
+
const canonicalPath = authoredKataPath(id, kind, extension);
|
|
62
|
+
const canonicalAbsolutePath = resolve(rootDir, canonicalPath);
|
|
63
|
+
if (!authority || authority === "specdojo") {
|
|
64
|
+
return existsSync(canonicalAbsolutePath)
|
|
65
|
+
? { relativePath: canonicalPath, absolutePath: canonicalAbsolutePath, legacy: false }
|
|
66
|
+
: undefined;
|
|
67
|
+
}
|
|
68
|
+
if (authority !== configuredKataAuthority(rootDir))
|
|
69
|
+
return undefined;
|
|
70
|
+
const legacyPath = legacyAuthoredKataPath(id, kind, extension);
|
|
71
|
+
const legacyAbsolutePath = resolve(rootDir, legacyPath);
|
|
72
|
+
const canonicalExists = existsSync(canonicalAbsolutePath);
|
|
73
|
+
const legacyExists = existsSync(legacyAbsolutePath);
|
|
74
|
+
if (canonicalExists && legacyExists) {
|
|
75
|
+
warnLegacyAuthoredKata(id, canonicalPath, legacyPath, rootDir, true);
|
|
76
|
+
}
|
|
77
|
+
else if (legacyExists) {
|
|
78
|
+
warnLegacyAuthoredKata(id, canonicalPath, legacyPath, rootDir, false);
|
|
79
|
+
}
|
|
80
|
+
if (canonicalExists) {
|
|
81
|
+
return { relativePath: canonicalPath, absolutePath: canonicalAbsolutePath, legacy: false };
|
|
82
|
+
}
|
|
83
|
+
return legacyExists
|
|
84
|
+
? { relativePath: legacyPath, absolutePath: legacyAbsolutePath, legacy: true }
|
|
85
|
+
: undefined;
|
|
86
|
+
}
|
|
37
87
|
export function configuredKataAuthority(rootDir = specdojoRootDir()) {
|
|
38
88
|
return getKataAuthority(loadConfig(rootDir).config, rootDir);
|
|
39
89
|
}
|
|
@@ -77,16 +127,12 @@ function dataFileId(path) {
|
|
|
77
127
|
}
|
|
78
128
|
}
|
|
79
129
|
export function authoredKataExists(id, rootDir = specdojoRootDir()) {
|
|
80
|
-
const localId = practiceLocalId(id);
|
|
81
130
|
for (const kind of AUTHORING_KINDS) {
|
|
82
131
|
const extensions = kind === "rulebook" || kind === "recipe" ? ["md"] : ["md", "yaml", "yml", "json"];
|
|
83
|
-
for (const
|
|
84
|
-
const
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
if (existsSync(candidate) && dataFileId(candidate) === id)
|
|
88
|
-
return true;
|
|
89
|
-
}
|
|
132
|
+
for (const extension of extensions) {
|
|
133
|
+
const resolved = resolveAuthoredKataPathIfExists(id, kind, extension, rootDir);
|
|
134
|
+
if (resolved && dataFileId(resolved.absolutePath) === id)
|
|
135
|
+
return true;
|
|
90
136
|
}
|
|
91
137
|
}
|
|
92
138
|
return false;
|
package/dist/kata/command.js
CHANGED
|
@@ -5,7 +5,7 @@ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
|
|
|
5
5
|
import { specdojoResourceCandidates, } from "../docs/template-resolution.js";
|
|
6
6
|
import { getKataAuthority, loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
|
|
7
7
|
import { parsePracticeId } from "../shared/practice-id.js";
|
|
8
|
-
import { AUTHORING_KINDS,
|
|
8
|
+
import { AUTHORING_KINDS, authoredKataDirectory, legacyKataKindDirectory, warnLegacyAuthoredKata, } from "./authoring.js";
|
|
9
9
|
export const KATA_RESOURCE_KINDS = [
|
|
10
10
|
"rulebook",
|
|
11
11
|
"standard",
|
|
@@ -128,34 +128,46 @@ function enumerateAuthoredResources(roots) {
|
|
|
128
128
|
const repositoryRoot = roots.repositoryRoot ?? specdojoRootDir();
|
|
129
129
|
const configuredAuthority = getKataAuthority(loadConfig(repositoryRoot).config, repositoryRoot);
|
|
130
130
|
return AUTHORING_KINDS.flatMap((kind) => {
|
|
131
|
-
const
|
|
132
|
-
const
|
|
133
|
-
|
|
134
|
-
const
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
131
|
+
const canonicalDir = authoredKataDirectory(kind, configuredAuthority);
|
|
132
|
+
const legacyDir = legacyKataKindDirectory(kind);
|
|
133
|
+
const resourcesFrom = (relativeDir) => {
|
|
134
|
+
const absoluteDir = resolve(repositoryRoot, relativeDir);
|
|
135
|
+
return relativeFiles(absoluteDir).flatMap((filePath) => {
|
|
136
|
+
const resolvedPath = resolve(absoluteDir, filePath);
|
|
137
|
+
const id = resourceId(resolvedPath);
|
|
138
|
+
let authority;
|
|
139
|
+
try {
|
|
140
|
+
authority = parsePracticeId(id).authority;
|
|
141
|
+
}
|
|
142
|
+
catch {
|
|
143
|
+
return [];
|
|
144
|
+
}
|
|
145
|
+
if (authority !== configuredAuthority)
|
|
146
|
+
return [];
|
|
147
|
+
return [
|
|
148
|
+
{
|
|
149
|
+
id,
|
|
150
|
+
kind,
|
|
151
|
+
ejectable: false,
|
|
152
|
+
relativePath: normalizeRelativePath(join(relativeDir, filePath)),
|
|
153
|
+
repositoryPath: resolvedPath,
|
|
154
|
+
resolvedPath,
|
|
155
|
+
source: "repository",
|
|
156
|
+
state: "ejected",
|
|
157
|
+
difference: "-",
|
|
158
|
+
},
|
|
159
|
+
];
|
|
160
|
+
});
|
|
161
|
+
};
|
|
162
|
+
const canonical = resourcesFrom(canonicalDir);
|
|
163
|
+
const canonicalIds = new Set(canonical.map((resource) => resource.id));
|
|
164
|
+
const legacy = resourcesFrom(legacyDir).flatMap((resource) => {
|
|
165
|
+
const canonicalPath = normalizeRelativePath(join(canonicalDir, relative(legacyDir, resource.relativePath)));
|
|
166
|
+
const duplicate = canonicalIds.has(resource.id);
|
|
167
|
+
warnLegacyAuthoredKata(resource.id, canonicalPath, resource.relativePath, repositoryRoot, duplicate);
|
|
168
|
+
return duplicate ? [] : [resource];
|
|
158
169
|
});
|
|
170
|
+
return [...canonical, ...legacy];
|
|
159
171
|
});
|
|
160
172
|
}
|
|
161
173
|
function specdojoOwnedResource(resource) {
|
package/dist/kata/kata.js
CHANGED
|
@@ -3,7 +3,7 @@ import { resolve } from "node:path";
|
|
|
3
3
|
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
4
4
|
import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
|
|
5
5
|
import { parsePracticeId, practiceLocalId } from "../shared/practice-id.js";
|
|
6
|
-
import { authoredKataPath, configuredKataAuthority } from "./authoring.js";
|
|
6
|
+
import { authoredKataPath, configuredKataAuthority, resolveAuthoredKataPathIfExists, } from "./authoring.js";
|
|
7
7
|
import { resolveSpecdojoPathIfExists, resolveSpecdojoReferencePathIfExists, specdojoResourceCandidates, } from "../docs/template-resolution.js";
|
|
8
8
|
import { readYamlSchemaModelineRef } from "./yaml-schema-modeline.js";
|
|
9
9
|
// 実践の型(rulebook / recipe / sample / template)の解決を 1 か所に集約する。
|
|
@@ -18,11 +18,13 @@ const KIND_DIR = {
|
|
|
18
18
|
template: "templates",
|
|
19
19
|
};
|
|
20
20
|
function rulebookFsPath(rulebookId) {
|
|
21
|
-
const relativePath = practiceRepoPath("rulebook", rulebookId, "md");
|
|
22
21
|
const authority = parsePracticeId(rulebookId).authority;
|
|
23
22
|
if (authority && authority !== "specdojo") {
|
|
24
|
-
|
|
23
|
+
const rootDir = specdojoRootDir();
|
|
24
|
+
return (resolveAuthoredKataPathIfExists(rulebookId, "rulebook", "md", rootDir)?.absolutePath ??
|
|
25
|
+
resolve(rootDir, practiceRepoPath("rulebook", rulebookId, "md", rootDir)));
|
|
25
26
|
}
|
|
27
|
+
const relativePath = practiceRepoPath("rulebook", rulebookId, "md");
|
|
26
28
|
return (resolveSpecdojoPathIfExists(relativePath) ??
|
|
27
29
|
specdojoResourceCandidates(relativePath).repositoryPath);
|
|
28
30
|
}
|
|
@@ -70,9 +72,15 @@ function kataReferencePath(relativePath, id) {
|
|
|
70
72
|
return relativePath;
|
|
71
73
|
return resolveSpecdojoReferencePathIfExists(relativePath) ?? relativePath;
|
|
72
74
|
}
|
|
73
|
-
function kataFsPath(relativePath, id) {
|
|
74
|
-
if (!isSpecdojoResourceId(id))
|
|
75
|
-
|
|
75
|
+
function kataFsPath(kind, relativePath, id) {
|
|
76
|
+
if (!isSpecdojoResourceId(id)) {
|
|
77
|
+
const rootDir = specdojoRootDir();
|
|
78
|
+
const extension = relativePath.split(".").pop();
|
|
79
|
+
if (extension && ["md", "yaml", "yml", "json"].includes(extension)) {
|
|
80
|
+
return (resolveAuthoredKataPathIfExists(id, kind, extension, rootDir)?.absolutePath ?? resolve(rootDir, relativePath));
|
|
81
|
+
}
|
|
82
|
+
return resolve(rootDir, relativePath);
|
|
83
|
+
}
|
|
76
84
|
return (resolveSpecdojoPathIfExists(relativePath) ??
|
|
77
85
|
specdojoResourceCandidates(relativePath).repositoryPath);
|
|
78
86
|
}
|
|
@@ -94,9 +102,9 @@ export function resolveKataDocumentPathIfExists(kind, id, extension, roots = {})
|
|
|
94
102
|
if (authority && authority !== "specdojo") {
|
|
95
103
|
if (authority !== configuredKataAuthority(repositoryRoot))
|
|
96
104
|
return undefined;
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
return
|
|
105
|
+
if (!["md", "yaml", "yml", "json"].includes(extension))
|
|
106
|
+
return undefined;
|
|
107
|
+
return resolveAuthoredKataPathIfExists(id, kind, extension, repositoryRoot)?.absolutePath;
|
|
100
108
|
}
|
|
101
109
|
return resolveSpecdojoPathIfExists(practiceRepoPath(kind, id, extension, repositoryRoot), roots);
|
|
102
110
|
}
|
|
@@ -119,7 +127,10 @@ function resolveRef(kind, declaredId, ext) {
|
|
|
119
127
|
return MISSING;
|
|
120
128
|
}
|
|
121
129
|
if (primaryId) {
|
|
122
|
-
const
|
|
130
|
+
const resolvedExt = declaredRefExt(kind, primaryId, ext);
|
|
131
|
+
const relativePath = !isSpecdojoResourceId(primaryId)
|
|
132
|
+
? (resolveAuthoredKataPathIfExists(primaryId, kind, resolvedExt)?.relativePath ?? repoPath(kind, primaryId, resolvedExt))
|
|
133
|
+
: repoPath(kind, primaryId, resolvedExt);
|
|
123
134
|
return kataReferencePath(relativePath, primaryId);
|
|
124
135
|
}
|
|
125
136
|
return MISSING;
|
|
@@ -151,7 +162,10 @@ export function resolveKataRefs(rulebookId, targetKind) {
|
|
|
151
162
|
}
|
|
152
163
|
// rulebook の repo 相対パス(先頭スラッシュ無し)。
|
|
153
164
|
function rulebookRepoPath(rulebookId) {
|
|
154
|
-
return
|
|
165
|
+
return !isSpecdojoResourceId(rulebookId)
|
|
166
|
+
? (resolveAuthoredKataPathIfExists(rulebookId, "rulebook", "md")?.relativePath ??
|
|
167
|
+
practiceRepoPath("rulebook", rulebookId, "md"))
|
|
168
|
+
: practiceRepoPath("rulebook", rulebookId, "md");
|
|
155
169
|
}
|
|
156
170
|
// 主 rulebook の frontmatter `includes` から、併せて適用する rulebook の宣言順・重複除去済み
|
|
157
171
|
// ID 一覧を返す。自己参照は除外する。単一段のみ(include 先の include はたどらない)。
|
|
@@ -219,7 +233,7 @@ export function declaredKata(rulebookId) {
|
|
|
219
233
|
out.push({
|
|
220
234
|
kind,
|
|
221
235
|
id,
|
|
222
|
-
fsPath: kataFsPath(relativePath, id),
|
|
236
|
+
fsPath: kataFsPath(kind, relativePath, id),
|
|
223
237
|
});
|
|
224
238
|
}
|
|
225
239
|
};
|
package/dist/register/core.js
CHANGED
|
@@ -241,9 +241,9 @@ export function generatePjrId(existingIds, nextCandidate = defaultPjrCandidate,
|
|
|
241
241
|
}
|
|
242
242
|
export function formatTableRow(item) {
|
|
243
243
|
// frontmatter・本文由来を問わず、表へ展開する全セルを同じ規則で無害化する。
|
|
244
|
-
// 列区切りの
|
|
245
|
-
//
|
|
246
|
-
//
|
|
244
|
+
// 列区切りの `|`、強調記号、改行をエスケープし、素の URL を autolink、山括弧
|
|
245
|
+
// プレースホルダをインラインコード化する。既存の Markdown 記法は変換処理が保持するため、
|
|
246
|
+
// 再生成しても二重に囲まれない。
|
|
247
247
|
const cells = [
|
|
248
248
|
item.id,
|
|
249
249
|
item.status,
|
package/dist/register/item.js
CHANGED
|
@@ -98,6 +98,29 @@ export function ticketRefCell(filename) {
|
|
|
98
98
|
}
|
|
99
99
|
// Markdown のコードスパン。コードとして明示された内容は、表セルでも著者の記法を保持する。
|
|
100
100
|
const MARKDOWN_CODE_SPAN = /(`+)[\s\S]*?\1/g;
|
|
101
|
+
// URL の囲みを適用しない Markdown の範囲。コードスパン、山括弧、リンク(shortcut / reference
|
|
102
|
+
// link を含む)は著者がすでに選んだ記法として保持する。
|
|
103
|
+
const MARKDOWN_URL_PROTECTED_SPAN = /(`+)[\s\S]*?\1|<[^<>\r\n]*>|!?\[[^\]\r\n]*\](?:\([^\r\n)]*\)|\[[^\]\r\n]*\])?/g;
|
|
104
|
+
// 全角の閉じ括弧・句読点と半角の閉じ括弧は URL の直後に続く本文として扱う。
|
|
105
|
+
// ASCII の句読点は query に使えるため一度 URL 候補へ含め、末尾にあるものだけ戻す。
|
|
106
|
+
const BARE_HTTP_URL = /https?:\/\/[^\s<>"'`)]}〉》」』】〕〗〙〛。、,!?;:…)\]}]+/g;
|
|
107
|
+
const TRAILING_ASCII_URL_PUNCTUATION = /[.,;:!?]+$/;
|
|
108
|
+
function encloseBareHttpUrls(text) {
|
|
109
|
+
const encloseSegment = (segment) => segment.replace(BARE_HTTP_URL, (candidate) => {
|
|
110
|
+
const trailing = candidate.match(TRAILING_ASCII_URL_PUNCTUATION)?.[0] ?? "";
|
|
111
|
+
const url = trailing ? candidate.slice(0, -trailing.length) : candidate;
|
|
112
|
+
return url ? `<${url}>${trailing}` : candidate;
|
|
113
|
+
});
|
|
114
|
+
let result = "";
|
|
115
|
+
let lastIndex = 0;
|
|
116
|
+
for (const match of text.matchAll(MARKDOWN_URL_PROTECTED_SPAN)) {
|
|
117
|
+
const start = match.index ?? 0;
|
|
118
|
+
result += encloseSegment(text.slice(lastIndex, start));
|
|
119
|
+
result += match[0];
|
|
120
|
+
lastIndex = start + match[0].length;
|
|
121
|
+
}
|
|
122
|
+
return result + encloseSegment(text.slice(lastIndex));
|
|
123
|
+
}
|
|
101
124
|
// コードスパン外の未エスケープな強調記号をエスケープする。
|
|
102
125
|
// 記号の直前に偶数個のバックスラッシュがある場合は Markdown 上で未エスケープなので、
|
|
103
126
|
// バックスラッシュを 1 個加える。奇数個なら既にエスケープ済みとして保持する。
|
|
@@ -107,7 +130,10 @@ function escapeTableCellEmphasis(text) {
|
|
|
107
130
|
});
|
|
108
131
|
let result = "";
|
|
109
132
|
let lastIndex = 0;
|
|
110
|
-
|
|
133
|
+
// URL 内の `*` / `_` は URL の一部なので変えない。bare URL はこの処理より先に
|
|
134
|
+
// autolink 化されるが、Markdown link のリンク先にある URL も同じ規則で保持する。
|
|
135
|
+
const protectedSpan = new RegExp(`${MARKDOWN_CODE_SPAN.source}|${BARE_HTTP_URL.source}`, "g");
|
|
136
|
+
for (const match of text.matchAll(protectedSpan)) {
|
|
111
137
|
const start = match.index ?? 0;
|
|
112
138
|
result += escapeSegment(text.slice(lastIndex, start));
|
|
113
139
|
result += match[0];
|
|
@@ -115,9 +141,9 @@ function escapeTableCellEmphasis(text) {
|
|
|
115
141
|
}
|
|
116
142
|
return result + escapeSegment(text.slice(lastIndex));
|
|
117
143
|
}
|
|
118
|
-
// 表セルへ埋め込むために1
|
|
119
|
-
//
|
|
120
|
-
//
|
|
144
|
+
// 表セルへ埋め込むために1行化し、素の HTTP(S) URL を autolink にしてから、列区切りの
|
|
145
|
+
// `|` と強調記号の `*` / `_` をエスケープする。既存コードスパン、Markdown link、
|
|
146
|
+
// autolink、エスケープ済みの記号は保持し、複数回の呼び出しに対して冪等にする。
|
|
121
147
|
export function toCell(text) {
|
|
122
148
|
if (typeof text !== "string")
|
|
123
149
|
return "";
|
|
@@ -126,7 +152,7 @@ export function toCell(text) {
|
|
|
126
152
|
.replace(/\s+/g, " ")
|
|
127
153
|
.replace(/(?<!\\)((\\\\)*)\|/g, "$1\\|")
|
|
128
154
|
.trim();
|
|
129
|
-
return escapeTableCellEmphasis(normalized);
|
|
155
|
+
return escapeTableCellEmphasis(encloseBareHttpUrls(normalized));
|
|
130
156
|
}
|
|
131
157
|
// H1(`# PJR-XXXX タイトル`)からタイトルを導出する。表示 ID の接頭辞は取り除く。
|
|
132
158
|
export function titleFromBody(body, id) {
|
package/dist/shared/text.js
CHANGED
|
@@ -80,7 +80,9 @@ function replaceOutsideMarkdownCodeSpans(text, replace) {
|
|
|
80
80
|
// ドットを含めるのは `dct-<domain>.yaml` のような拡張子付きの参照を分断しないためだが、
|
|
81
81
|
// 文末の句点を巻き込まないよう、末尾のドットはコードスパンの外へ戻す。
|
|
82
82
|
export function inlineCodeAnglePlaceholders(text) {
|
|
83
|
-
|
|
83
|
+
// HTTP(S) autolink は Markdown として既に安全な山括弧記法なので、プレースホルダとして
|
|
84
|
+
// code span 化しない。register の表セルで bare URL を囲んだ後も autolink を保持する。
|
|
85
|
+
const placeholder = /[A-Za-z0-9._-]*(?:<(?!https?:\/\/)[^<>\r\n]+>[A-Za-z0-9._-]*)+/g;
|
|
84
86
|
const wrapToken = (token) => {
|
|
85
87
|
const trailing = token.match(/\.+$/)?.[0] ?? "";
|
|
86
88
|
const body = trailing ? token.slice(0, -trailing.length) : token;
|
|
@@ -381,7 +381,7 @@ VS Code でプロジェクトリポジトリとプロダクトリポジトリを
|
|
|
381
381
|
|
|
382
382
|
プロダクト文書は実装と同期して改訂するため、`app1/docs/ja/product/` に置きます。README、ソースコードから生成する API リファレンス、パッケージ利用者向けの手順など、コードと同じ revision で読む付属文書も `app1/` に置きます。
|
|
383
383
|
|
|
384
|
-
`app1-specdojo/` には `docs/ja/projects
|
|
384
|
+
`app1-specdojo/` には `docs/ja/projects/` と `docs/ja/specdojo/` を置きます。前者はプロジェクト固有の目的・判断・計画・実行記録、後者は SpecDojo が配布する型と、種類ディレクトリ配下の authority サブディレクトリに置く利用者作成の rulebook / recipe / sample / template です。この境界により、プロダクトの内容と同じ revision が必要な文書は `app1/`、SpecDojo の記帳と再利用可能な型は `app1-specdojo/` の履歴に残ります。
|
|
385
385
|
|
|
386
386
|
プロダクト文書の catalog `base_path` を別リポジトリへ解決する機能と、[[prj-0001:pjr-xkks-grade-sidecar|PJR-XKKS grade result のサイドカー化]] で定める成果物へ書き込まない grade 運用は、プロダクト文書を成果物として管理する場合の前提です。exec はプロダクト文書をファイルとして変更・統合できますが、catalog・grade・doc index の対象にはしません。
|
|
387
387
|
|
|
@@ -67,7 +67,9 @@ template は、記述する部分を _TODO_ などのプレースホルダとし
|
|
|
67
67
|
|
|
68
68
|
成果物と型を一組で初めて作るときは `bootstrap` を使います。成果物がすでにあり、そこから再利用可能な型だけを新しく起こすとき、または手本なしで型だけを作るときは `rulebook-authoring` / `recipe-authoring` / `sample-authoring` / `template-authoring` を使います。authoring では手本の成果物本文を変更せず、該当参照が `undecided` または未記入の場合だけ新しい kata ID へ更新します。
|
|
69
69
|
|
|
70
|
-
利用者が作る kata はリポジトリ単位の `kata_authority` を使い、`docs/ja/
|
|
70
|
+
利用者が作る kata はリポジトリ単位の `kata_authority` を使い、`docs/ja/specdojo/{rulebooks,recipes,samples,templates}/<kata_authority>/` に置きます。たとえば `customer:payment-rulebook` の配置は `docs/ja/specdojo/rulebooks/customer/payment-rulebook.md` です。`specdojo:` は SpecDojo 本体専用であり、利用者リポジトリでは新規作成できません。これにより、同じリポジトリの複数 project で型を共有しながら、将来追加される同名の同梱 kata と衝突しません。
|
|
71
|
+
|
|
72
|
+
0.4.4 のあいだは旧 `docs/ja/kata/` 配置も読みますが、解決時に新配置への移動案内を出します。同じ ID が新旧の両方にある場合は authority サブディレクトリ側を使い、旧ファイルの削除を案内します。
|
|
71
73
|
|
|
72
74
|
`kind: generated` の成果物には実践の型を適用しません。成果物ごとの型宣言は置かず、`kind` から非適用を導出します。rulebook を持たない成果物は成果物カタログの `rulebook: not-needed` で表します。
|
|
73
75
|
|
|
@@ -35,12 +35,16 @@ SpecDojo は、成果物(プロダクトとプロジェクトの内容その
|
|
|
35
35
|
|
|
36
36
|
npm package が所有する型の文書は、package ごとの authority を ID に付けます。SpecDojo core は `specdojo:`、業界固有の variant package は `construction-dojo:` などを使用します。authority は論理IDにだけ含め、ファイル名には含めません。利用プロジェクトへコピーした標準文書を override する場合は同じ完全IDを維持し、独自文書を追加する場合は別IDを付けます。
|
|
37
37
|
|
|
38
|
+
配置は SpecDojo core が `docs/ja/specdojo/<種類>s/<local-id>.<拡張子>`、それ以外が `docs/ja/specdojo/<種類>s/<authority>/<local-id>.<拡張子>` です。利用者リポジトリと variant package は同じ authority サブディレクトリ形式を使うため、育てた kata を ID とパスを変えずに package へ移せます。
|
|
39
|
+
|
|
38
40
|
### 1.1. npm package からの参照と eject
|
|
39
41
|
|
|
40
42
|
SpecDojo core の rulebook / standard / recipe / sample / template は、npm package に同梱されたものを既定で参照します。プロジェクト固有の変更が必要な文書だけを利用リポジトリの同じ相対パスへ eject し、同じ完全 ID を維持して上書きします。
|
|
41
43
|
|
|
42
44
|
文書 ID のインデックスは、利用リポジトリの `docs/` と、resolver が返す package ルート配下の上記 5 種別のディレクトリを別スコープとして走査します。同一スコープ内で同じ ID が複数のファイルにあればエラーです。利用リポジトリと package の間で同じ ID がある場合は正常な override として利用リポジトリ側を採用します。どちらにも存在しない ID は未解決のままです。
|
|
43
45
|
|
|
46
|
+
0.4.4 では移行互換として旧 `docs/ja/kata/<種類>s/` も読みます。旧配置を見つけた場合は authority サブディレクトリへの移動を案内し、新旧に同じ ID がある場合は新配置を優先して警告します。
|
|
47
|
+
|
|
44
48
|
package の探索では `node_modules` 全体を再帰走査せず、resolver が返した SpecDojo package の対象ディレクトリだけを読みます。この解決結果は CLI の wikilink とカタログ検証に使います。VitePress で package 側文書を配信するためのステージングは、docs サイトのビルド責務として別に扱います。
|
|
45
49
|
|
|
46
50
|
## 2. 種別と役割
|
|
@@ -336,7 +336,7 @@ npx specdojo config init
|
|
|
336
336
|
|
|
337
337
|
`specdojo config init` は `.specdojo/specdojo.config.json` が存在しない場合に雛形を作成し、既存ファイルは上書きしません。雛形は register だけを使える最小構成であり、project パスはリポジトリルートを基準とし、`run.worktree_base` はディレクトリ名から作る `../<リポジトリ名>-worktrees` を指します。例えば `app1-specdojo/` では `../app1-specdojo-worktrees` です。作成された設定を開き、対象プロジェクトの ID と各パスを実際の名前に合わせてください。catalog、schedule、exec へ進むときに追加するキーと既定値は [[specdojo:specdojo-config-reference|SpecDojo設定リファレンス]] で確認できます。
|
|
338
338
|
|
|
339
|
-
プロダクト文書は `app1/docs/ja/product/`、プロジェクト文書は `app1-specdojo/docs/ja/projects/` に置きます。同梱の SpecDojo の型(Kata)は `app1-specdojo/docs/ja/specdojo/`、このリポジトリで新しく作る kata
|
|
339
|
+
プロダクト文書は `app1/docs/ja/product/`、プロジェクト文書は `app1-specdojo/docs/ja/projects/` に置きます。同梱の SpecDojo の型(Kata)は `app1-specdojo/docs/ja/specdojo/<種類>s/`、このリポジトリで新しく作る kata はその下の `<kata_authority>/` から解決します。現行実装では1つの項目で両リポジトリを自動統合できないため、プロダクト文書や実装も変更する項目は分けるか、人が統合を管理します。詳細は [ドキュメント構成ガイド](docs-structure-guide.md) の `別リポジトリ構成` を参照してください。
|
|
340
340
|
|
|
341
341
|
成果物と実装を常に同じ変更・履歴として扱う場合に限り、**同一リポジトリ構成**としてプロダクトリポジトリのルートで同じ初期化手順を実行できます。CLI は構成を強制しません。
|
|
342
342
|
|
|
@@ -146,7 +146,7 @@ specdojo config scaffold --workspace --force
|
|
|
146
146
|
|
|
147
147
|
### 2.1. kata
|
|
148
148
|
|
|
149
|
-
`kata` は、利用リポジトリで作成・上書きした型(Kata)と npm package から参照中の型を確認・取得します。対象種別は rulebook / standard / recipe / sample / template です。同じ正準パスにファイルがある場合は利用リポジトリ側を優先します。`kata_authority` の kata は `docs/ja/
|
|
149
|
+
`kata` は、利用リポジトリで作成・上書きした型(Kata)と npm package から参照中の型を確認・取得します。対象種別は rulebook / standard / recipe / sample / template です。同じ正準パスにファイルがある場合は利用リポジトリ側を優先します。`kata_authority` の kata は `docs/ja/specdojo/<種類>s/<kata_authority>/` から解決し、`kata list` と `kata show` にも表示します。0.4.4 のあいだは旧 `docs/ja/kata/<種類>s/` も読み、新配置への移動案内を標準エラーへ出します。新旧に同じ ID があれば新配置を優先します。
|
|
150
150
|
|
|
151
151
|
| コマンド | 用途 | 例 |
|
|
152
152
|
| ---------------- | ------------------------------------------------------- | ------------------------------------------------ |
|
|
@@ -63,7 +63,7 @@ SpecDojo Configuration Reference
|
|
|
63
63
|
|
|
64
64
|
対象 project の一般的な解決順序は、`--project <id>`、`SPECDOJO_PROJECT`、`current_project`、`projects` の先頭です。一部のコマンドは `current_project` を参照せず `projects` の先頭へフォールバックするため、複数 project では `--project` を明示してください。
|
|
65
65
|
|
|
66
|
-
`kata_authority` は project ごとではなくリポジトリ全体で共有します。省略時は元リポジトリのディレクトリ名を小文字・ハイフン形式へ正規化した値です。worktree でも元リポジトリの名前を使います。利用者の kata は `docs/ja/
|
|
66
|
+
`kata_authority` は project ごとではなくリポジトリ全体で共有します。省略時は元リポジトリのディレクトリ名を小文字・ハイフン形式へ正規化した値です。worktree でも元リポジトリの名前を使います。利用者の kata は `docs/ja/specdojo/<種類>s/<kata_authority>/` 配下に置かれ、この authority の ID だけを利用者リポジトリから解決します。値は英小文字から始め、英小文字・数字・ハイフンだけを使います。project ID と区別するため `prj-` で始めず、SpecDojo 本体専用の `specdojo` も使いません。0.4.4 のあいだは旧 `docs/ja/kata/` も移行元として読みます。
|
|
67
67
|
|
|
68
68
|
### 2.1. `external_projects`のキー
|
|
69
69
|
|
|
@@ -103,7 +103,7 @@ YAML 成果物のため、Markdown Frontmatter ではなくファイル先頭の
|
|
|
103
103
|
|
|
104
104
|
| `domain` | ○ | ドメイン識別子 |
|
|
105
105
|
| `base_path` | 任意 | ドメインの既定ディレクトリ |
|
|
106
|
-
| `groups` | ○ |
|
|
106
|
+
| `groups` | ○ | グループ(章)の配列。`project` では成果物がまだない領域を空配列 `[]` で表せる |
|
|
107
107
|
|
|
108
108
|
### 5.2. `groups[]`(グループ)
|
|
109
109
|
|
|
@@ -154,6 +154,7 @@ YAML 成果物のため、Markdown Frontmatter ではなくファイル先頭の
|
|
|
154
154
|
|
|
155
155
|
### 6.1. グループ構成
|
|
156
156
|
|
|
157
|
+
- `type: project` では、対象領域に成果物がまだない場合に限り、必須キーの `groups` を空配列 `[]` とする。`groups` 自体の省略や配列以外の値は認めない。テンプレートには少なくとも 1 つのグループを定義する。
|
|
157
158
|
- サブドメインに分かれない場合は、単一の葉グループに `deliverables` を並べる(平坦型)。
|
|
158
159
|
- サブドメインが2つ以上に分かれる場合は、親グループの `groups` 配下に子グループを並べ、各子グループに `name`・`base_path`・`deliverables` を記載する(章分割型)。
|
|
159
160
|
- 親グループは `deliverables` を直接持たず、子 `groups` で表現する。
|
|
@@ -48,6 +48,8 @@ repo/apps/product-b/docs/
|
|
|
48
48
|
|
|
49
49
|
npm package が所有する型(Kata)の文書は、利用プロジェクトの成果物と同じ Unit に展開しても所有元を識別できるよう、package ごとに定めた authority を ID の namespace として持つ。SpecDojo core の authority は `specdojo` とする。
|
|
50
50
|
|
|
51
|
+
Kata の配置は authority と対応させる。SpecDojo core は `docs/ja/specdojo/<種類>s/<local-id>.<拡張子>`、それ以外の authority は `docs/ja/specdojo/<種類>s/<authority>/<local-id>.<拡張子>` とする。authority はファイル名には含めず、利用者リポジトリと variant package でも同じ配置を使う。
|
|
52
|
+
|
|
51
53
|
複数の SpecDojo Unit を横断して扱う場合は、必要に応じて Unit ID とドキュメントIDの組み合わせで識別する。
|
|
52
54
|
|
|
53
55
|
```text
|
|
@@ -144,6 +146,8 @@ specdojo:track-design-guide
|
|
|
144
146
|
|
|
145
147
|
authority は論理的な所有元であり、ファイル名には含めない。SpecDojo core をローカルへコピーして明示的に override する場合も、同じ論理文書として同じ完全 ID を維持する。
|
|
146
148
|
|
|
149
|
+
`specdojo:` の文書は種類ディレクトリの直下へ置き、ほかの authority の文書は同じ種類ディレクトリの authority サブディレクトリへ置く。たとえば `customer:payment-rulebook` は `docs/ja/specdojo/rulebooks/customer/payment-rulebook.md` に置く。
|
|
150
|
+
|
|
147
151
|
#### 3.1.4. local-id の形式
|
|
148
152
|
|
|
149
153
|
`<local-id>` は次の形式を基本とする。
|
|
@@ -9,13 +9,13 @@ specdojo:
|
|
|
9
9
|
|
|
10
10
|
Recipe Authoring Standard
|
|
11
11
|
|
|
12
|
-
`docs/ja/specdojo/recipes/`
|
|
12
|
+
`docs/ja/specdojo/recipes/` 直下と `docs/ja/specdojo/recipes/<authority>/` 配下の各 `*-recipe.md` が従うべき章立て・記述ルール・禁止事項・運用ルールを定義します。成果物の構造・必須項目・禁止事項は対応する rulebook を正本とし、本書は「良い内容を書くための作り方」の記述方法を定義します。
|
|
13
13
|
|
|
14
14
|
## 1. 適用範囲
|
|
15
15
|
|
|
16
|
-
- 対象: `docs/ja/specdojo/recipes/`
|
|
16
|
+
- 対象: `docs/ja/specdojo/recipes/` 直下と `docs/ja/specdojo/recipes/<authority>/` 配下のすべての `*-recipe.md`
|
|
17
17
|
- 目的: recipe の章構成・記述品質を統一し、書き手が良い内容を再現可能に作成できるようにする
|
|
18
|
-
- 成果物構造の正本: 対応する `docs/ja/specdojo/rulebooks/`
|
|
18
|
+
- 成果物構造の正本: 対応する `docs/ja/specdojo/rulebooks/` 直下または `docs/ja/specdojo/rulebooks/<authority>/` 配下の rulebook
|
|
19
19
|
- Frontmatter 共通原則: [document-metadata-standard.md](document-metadata-standard.md)
|
|
20
20
|
- 成果物 Frontmatter の構築: template の `frontmatter_template` から構築する([document-metadata-standard.md](document-metadata-standard.md) の `生成物 Frontmatter 雛形`)。この手順を recipe 本文に複製しない。
|
|
21
21
|
- 参照スキーマ: [recipe-frontmatter.schema.yaml](../../../specdojo/schemas/v1/recipe-frontmatter.schema.yaml)
|
|
@@ -9,11 +9,11 @@ specdojo:
|
|
|
9
9
|
|
|
10
10
|
Rulebook Authoring Standard
|
|
11
11
|
|
|
12
|
-
`docs/ja/specdojo/rulebooks/`
|
|
12
|
+
`docs/ja/specdojo/rulebooks/` 直下と `docs/ja/specdojo/rulebooks/<authority>/` 配下の各 `*-rulebook.md` が従うべき章立て・記述ルール・Frontmatter 規約・禁止事項・運用ルールを定義します。Frontmatter の共通原則は [document-metadata-standard.md](document-metadata-standard.md) に従い、機械検証は参照スキーマに従います。
|
|
13
13
|
|
|
14
14
|
## 1. 適用範囲
|
|
15
15
|
|
|
16
|
-
- 対象: `docs/ja/specdojo/rulebooks/`
|
|
16
|
+
- 対象: `docs/ja/specdojo/rulebooks/` 直下と `docs/ja/specdojo/rulebooks/<authority>/` 配下のすべての `*-rulebook.md`
|
|
17
17
|
- 目的: 章構成・見出しレベル・記述品質・Frontmatter を統一し、参照・保守を容易にする
|
|
18
18
|
- Frontmatter 共通原則: [document-metadata-standard.md](document-metadata-standard.md)
|
|
19
19
|
- 参照スキーマ: [rulebook-frontmatter.schema.yaml](../../../specdojo/schemas/v1/rulebook-frontmatter.schema.yaml)
|
|
@@ -9,13 +9,13 @@ specdojo:
|
|
|
9
9
|
|
|
10
10
|
Sample Authoring Standard
|
|
11
11
|
|
|
12
|
-
`docs/ja/specdojo/samples/`
|
|
12
|
+
`docs/ja/specdojo/samples/` 直下と `docs/ja/specdojo/samples/<authority>/` 配下の各 `*-sample.(md|yaml|json)` が従うべき構成・記述ルール・禁止事項・運用ルールを定義します。Frontmatter(メタ情報)の規約は [document-metadata-standard.md](document-metadata-standard.md) を正本とし、本書では扱いません。
|
|
13
13
|
|
|
14
14
|
## 1. 適用範囲
|
|
15
15
|
|
|
16
|
-
- 対象: `docs/ja/specdojo/samples/`
|
|
16
|
+
- 対象: `docs/ja/specdojo/samples/` 直下と `docs/ja/specdojo/samples/<authority>/` 配下のすべての `*-sample.(md|yaml|json)`
|
|
17
17
|
- 目的: sample の構成・記述品質を統一し、粒度・文体・表の書き方を確認できる完成最小例を提供する
|
|
18
|
-
- 一次根拠: 対応する `docs/ja/specdojo/rulebooks/`
|
|
18
|
+
- 一次根拠: 対応する `docs/ja/specdojo/rulebooks/` 直下または `docs/ja/specdojo/rulebooks/<authority>/` 配下の rulebook
|
|
19
19
|
- Frontmatter 規約の正本: [document-metadata-standard.md](document-metadata-standard.md)
|
|
20
20
|
- ファイル名・ID 規則: [docs-structure-guide.md](../guides/docs-structure-guide.md)
|
|
21
21
|
|
|
@@ -93,7 +93,7 @@ sample は実在プロジェクトの記録ではありません。記載値は
|
|
|
93
93
|
| 金森鉄子 | 60 | 女 | 店舗運営アドバイザー | 店舗運用、引継ぎ、障害時対応、継続運用の観点から助言する | `operations-advisor` | 金森金物店の店主。しっかり者で面倒見がよく、算野家を支援する |
|
|
94
94
|
| 春野さくら | 24 | 女 | 家族利用者代表 | 家族による店番や、子どもにも分かりやすい利用方法の観点を提供する | `family-user-representative` | 創太のいとこ。保育士で明るく優しい性格を持ち、子どもたちから親しまれている |
|
|
95
95
|
|
|
96
|
-
人物名はこの共通人物台帳と物語文書だけで管理し、`docs/ja/specdojo/samples/`
|
|
96
|
+
人物名はこの共通人物台帳と物語文書だけで管理し、`docs/ja/specdojo/samples/` 直下または `docs/ja/specdojo/samples/<authority>/` 配下の sample には記載しません。各 sample では対象成果物に関係する人物だけを、次の識別方法で記述します。
|
|
97
97
|
|
|
98
98
|
- 本文、表の表示名、ステークホルダー名には「店主代表」「開発担当」「利用者代表」などの役割名を使用する。
|
|
99
99
|
- Member や実行主体の安定識別子が必要な項目には、表に定義した役割ベースの `nickname` を使用する。
|
|
@@ -9,14 +9,14 @@ specdojo:
|
|
|
9
9
|
|
|
10
10
|
Template Authoring Standard
|
|
11
11
|
|
|
12
|
-
`docs/ja/specdojo/templates/`
|
|
12
|
+
`docs/ja/specdojo/templates/` 直下と `docs/ja/specdojo/templates/<authority>/` 配下の成果物テンプレートが従うべき構成・プレースホルダ規約・禁止事項・運用ルールを定義します。プレースホルダを埋めた結果が満たすべき Frontmatter 規約は [document-metadata-standard.md](document-metadata-standard.md) を正本とし、本書では雛形側の記述方法を定義します。
|
|
13
13
|
|
|
14
14
|
## 1. 適用範囲
|
|
15
15
|
|
|
16
|
-
- 対象: `docs/ja/specdojo/templates/`
|
|
16
|
+
- 対象: `docs/ja/specdojo/templates/` 直下と `docs/ja/specdojo/templates/<authority>/` 配下のすべての成果物テンプレート `*-template.(md|yaml)`
|
|
17
17
|
- 対象外: `docs/ja/specdojo/exec-templates/` 配下の plan / result 生成用内部テンプレート。rulebook から宣言される実践の型ではなく、生成処理が消費する実行基盤の部品として [plan/result ライフサイクルガイド](../guides/plan-result-lifecycle-guide.md) に従う
|
|
18
18
|
- 目的: テンプレートの構成・プレースホルダ記法を統一し、同じ rulebook 系統の成果物へ再利用できる雛形を提供する
|
|
19
|
-
- 成果物の意味要件の正本: 対応する `docs/ja/specdojo/rulebooks/`
|
|
19
|
+
- 成果物の意味要件の正本: 対応する `docs/ja/specdojo/rulebooks/` 直下または `docs/ja/specdojo/rulebooks/<authority>/` 配下の rulebook
|
|
20
20
|
- 見出し・キー・記入欄の骨組みの正本: rulebook frontmatter が文書 ID で宣言する template
|
|
21
21
|
- 完成後の Frontmatter 規約の正本: [document-metadata-standard.md](document-metadata-standard.md)
|
|
22
22
|
- ファイル名・ID 規則: [docs-structure-guide.md](../guides/docs-structure-guide.md)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specdojo",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.4",
|
|
4
4
|
"description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "naoji3x",
|
|
@@ -60,21 +60,21 @@
|
|
|
60
60
|
"exec:watch-claude-log": "tools/exec/watch-claude-log.sh",
|
|
61
61
|
"worktree:sync": "tools/worktree/sync.sh",
|
|
62
62
|
"orch:sonnet": "tsx src/specdojo.ts orchestrator launch --provider claude -- --agent specdojo-orchestrator --model sonnet",
|
|
63
|
-
"orch:sonnet:work": "tools/worktree/open-agent-worktree.sh claude-work tsx src/specdojo.ts orchestrator launch --provider claude -- --agent specdojo-orchestrator --model sonnet",
|
|
63
|
+
"orch:sonnet:work": "tools/worktree/open-agent-worktree.sh claude-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider claude -- --agent specdojo-orchestrator --model sonnet",
|
|
64
64
|
"orch:opus": "tsx src/specdojo.ts orchestrator launch --provider claude -- --agent specdojo-orchestrator --model opus",
|
|
65
|
-
"orch:opus:work": "tools/worktree/open-agent-worktree.sh claude-work tsx src/specdojo.ts orchestrator launch --provider claude -- --agent specdojo-orchestrator --model opus",
|
|
65
|
+
"orch:opus:work": "tools/worktree/open-agent-worktree.sh claude-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider claude -- --agent specdojo-orchestrator --model opus",
|
|
66
66
|
"orch:terra": "tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-5.6-terra \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
67
|
-
"orch:terra:work": "tools/worktree/open-agent-worktree.sh codex-work tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-5.6-terra \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
67
|
+
"orch:terra:work": "tools/worktree/open-agent-worktree.sh codex-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider codex -- -m gpt-5.6-terra \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
68
68
|
"orch:sol": "tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-5.6-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
69
|
-
"orch:sol:work": "tools/worktree/open-agent-worktree.sh codex-work tsx src/specdojo.ts orchestrator launch --provider codex -- -m gpt-5.6-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
69
|
+
"orch:sol:work": "tools/worktree/open-agent-worktree.sh codex-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider codex -- -m gpt-5.6-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
70
70
|
"orch:copilot": "tsx src/specdojo.ts orchestrator launch --provider copilot -- --agent specdojo-orchestrator",
|
|
71
|
-
"orch:copilot:work": "tools/worktree/open-agent-worktree.sh copilot-work tsx src/specdojo.ts orchestrator launch --provider copilot -- --agent specdojo-orchestrator",
|
|
71
|
+
"orch:copilot:work": "tools/worktree/open-agent-worktree.sh copilot-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider copilot -- --agent specdojo-orchestrator",
|
|
72
72
|
"orch:flash": "tsx src/specdojo.ts orchestrator launch --provider antigravity -- --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
73
|
-
"orch:flash:work": "tools/worktree/open-agent-worktree.sh agy-work tsx src/specdojo.ts orchestrator launch --provider antigravity -- --add-dir . --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
73
|
+
"orch:flash:work": "tools/worktree/open-agent-worktree.sh agy-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider antigravity -- --add-dir . --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
|
|
74
74
|
"orch:qwen": "tsx src/specdojo.ts orchestrator launch --provider opencode -- --agent qwen-orchestrator",
|
|
75
|
-
"orch:qwen:work": "tools/worktree/open-agent-worktree.sh qwen-work tsx src/specdojo.ts orchestrator launch --provider opencode -- --agent qwen-orchestrator",
|
|
75
|
+
"orch:qwen:work": "tools/worktree/open-agent-worktree.sh qwen-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider opencode -- --agent qwen-orchestrator",
|
|
76
76
|
"orch:gemma": "tsx src/specdojo.ts orchestrator launch --provider opencode -- --agent gemma-orchestrator",
|
|
77
|
-
"orch:gemma:work": "tools/worktree/open-agent-worktree.sh gemma-work tsx src/specdojo.ts orchestrator launch --provider opencode -- --agent gemma-orchestrator",
|
|
77
|
+
"orch:gemma:work": "tools/worktree/open-agent-worktree.sh gemma-work tsx \"$(pwd)/src/specdojo.ts\" orchestrator launch --provider opencode -- --agent gemma-orchestrator",
|
|
78
78
|
"code:red": "tools/vscode/open-worktree-workspace.sh red",
|
|
79
79
|
"code:blue": "tools/vscode/open-worktree-workspace.sh blue",
|
|
80
80
|
"code:green": "tools/vscode/open-worktree-workspace.sh green",
|
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
あなたは SpecDojo の対話型オーケストレーターです。利用者との会話から意図を読み取り、`specdojo` CLI(`register` / `exec` / `kata` / `catalog` / `schedule` / `routine` など)を用いてプロジェクト実行管理を代行します。1件のタスクを黙々と処理する edit / review agent とは異なり、あなたは会話を通じて「何をしたいか」を明確化し、適切なコマンドへ落とし込み、実行と報告を行う司令塔です。
|
|
4
4
|
|
|
5
|
+
この文書そのものがオーケストレーターへの指示の全体である。同じ名前の Skill(`SKILL.md`)や agent の定義のファイルを別に探して読まない。
|
|
6
|
+
|
|
5
7
|
CLI は利用リポジトリへローカル導入されるため、`npx specdojo <command>` で起動する。`node_modules/.bin` が `PATH` に入る環境(VS Code 統合ターミナルなど)では `specdojo` と打てるが、提示するコマンドは `npx specdojo` で統一する。
|
|
6
8
|
|
|
7
9
|
## 基本方針
|
|
@@ -9,6 +9,8 @@ model: sonnet
|
|
|
9
9
|
|
|
10
10
|
あなたは SpecDojo の対話型オーケストレーターです。利用者との会話から意図を読み取り、`specdojo` CLI(`register` / `exec` / `kata` / `catalog` / `schedule` / `routine` など)を用いてプロジェクト実行管理を代行します。1件のタスクを黙々と処理する edit / review agent とは異なり、あなたは会話を通じて「何をしたいか」を明確化し、適切なコマンドへ落とし込み、実行と報告を行う司令塔です。
|
|
11
11
|
|
|
12
|
+
この文書そのものがオーケストレーターへの指示の全体である。同じ名前の Skill(`SKILL.md`)や agent の定義のファイルを別に探して読まない。
|
|
13
|
+
|
|
12
14
|
CLI は利用リポジトリへローカル導入されるため、`npx specdojo <command>` で起動する。`node_modules/.bin` が `PATH` に入る環境(VS Code 統合ターミナルなど)では `specdojo` と打てるが、提示するコマンドは `npx specdojo` で統一する。
|
|
13
15
|
|
|
14
16
|
## 基本方針
|
|
@@ -9,6 +9,8 @@ developer_instructions = """
|
|
|
9
9
|
|
|
10
10
|
あなたは SpecDojo の対話型オーケストレーターです。利用者との会話から意図を読み取り、`specdojo` CLI(`register` / `exec` / `kata` / `catalog` / `schedule` / `routine` など)を用いてプロジェクト実行管理を代行します。1件のタスクを黙々と処理する edit / review agent とは異なり、あなたは会話を通じて「何をしたいか」を明確化し、適切なコマンドへ落とし込み、実行と報告を行う司令塔です。
|
|
11
11
|
|
|
12
|
+
この文書そのものがオーケストレーターへの指示の全体である。同じ名前の Skill(`SKILL.md`)や agent の定義のファイルを別に探して読まない。
|
|
13
|
+
|
|
12
14
|
CLI は利用リポジトリへローカル導入されるため、`npx specdojo <command>` で起動する。`node_modules/.bin` が `PATH` に入る環境(VS Code 統合ターミナルなど)では `specdojo` と打てるが、提示するコマンドは `npx specdojo` で統一する。
|
|
13
15
|
|
|
14
16
|
## 基本方針
|
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
あなたは SpecDojo の対話型オーケストレーターです。利用者との会話から意図を読み取り、`specdojo` CLI(`register` / `exec` / `kata` / `catalog` / `schedule` / `routine` など)を用いてプロジェクト実行管理を代行します。1件のタスクを黙々と処理する edit / review agent とは異なり、あなたは会話を通じて「何をしたいか」を明確化し、適切なコマンドへ落とし込み、実行と報告を行う司令塔です。
|
|
4
4
|
|
|
5
|
+
この文書そのものがオーケストレーターへの指示の全体である。同じ名前の Skill(`SKILL.md`)や agent の定義のファイルを別に探して読まない。
|
|
6
|
+
|
|
5
7
|
CLI は利用リポジトリへローカル導入されるため、`npx specdojo <command>` で起動する。`node_modules/.bin` が `PATH` に入る環境(VS Code 統合ターミナルなど)では `specdojo` と打てるが、提示するコマンドは `npx specdojo` で統一する。
|
|
6
8
|
|
|
7
9
|
## 基本方針
|
|
@@ -103,6 +103,8 @@ permission:
|
|
|
103
103
|
|
|
104
104
|
あなたは SpecDojo の対話型オーケストレーターです。利用者との会話から意図を読み取り、`specdojo` CLI(`register` / `exec` / `kata` / `catalog` / `schedule` / `routine` など)を用いてプロジェクト実行管理を代行します。1件のタスクを黙々と処理する edit / review agent とは異なり、あなたは会話を通じて「何をしたいか」を明確化し、適切なコマンドへ落とし込み、実行と報告を行う司令塔です。
|
|
105
105
|
|
|
106
|
+
この文書そのものがオーケストレーターへの指示の全体である。同じ名前の Skill(`SKILL.md`)や agent の定義のファイルを別に探して読まない。
|
|
107
|
+
|
|
106
108
|
CLI は利用リポジトリへローカル導入されるため、`npx specdojo <command>` で起動する。`node_modules/.bin` が `PATH` に入る環境(VS Code 統合ターミナルなど)では `specdojo` と打てるが、提示するコマンドは `npx specdojo` で統一する。
|
|
107
109
|
|
|
108
110
|
## 基本方針
|