phasegate 0.335.0 → 0.341.0

package/scripts/harness/regression-suite/infrastructure/adapters/vitest-test-runner-adapter.ts

@@ -1,7 +1,10 @@
 // @layer infrastructure
-import { execSync } from 'node:child_process';
+// @unit regression-suite
+// @work-item-id WI-384
+import { execFileSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
+import { execPath } from 'node:process';
 import { KRequirementTest } from '../../domain/value-objects/k-requirement-test.js';
 import { GngConditionTest } from '../../domain/value-objects/gng-condition-test.js';
 import { AgentIndependenceTest } from '../../domain/value-objects/agent-independence-test.js';
@@ -65,8 +68,15 @@ export class VitestTestRunnerAdapter implements TestRunnerPort {
 
       const testPattern = hasUnitTests ? unitTestDir : unitIntegrationDir;
       try {
-        execSync(
-          `npx tsx node_modules/vitest/vitest.mjs run --config scripts/harness/__tests__/vitest.config.ts "${testPattern}"`,
+        execFileSync(
+          execPath,
+          [
+            'node_modules/vitest/vitest.mjs',
+            'run',
+            '--config',
+            'scripts/harness/__tests__/vitest.config.ts',
+            testPattern,
+          ],
           { cwd: this.rootDir, stdio: 'pipe', timeout: 60_000 },
         );
         unitResults.set(unit, true);

package/scripts/harness/setup/skill-deployer.ts

@@ -10,6 +10,8 @@
 
 import { promises as fs } from "node:fs";
 import { dirname, join } from "node:path";
+import { getBundledSkillsForSet, SKILL_CATEGORIES, type SkillCategory, type SkillSet } from "../installation/application/bundled-skill-selection.js";
+export { SKILL_CATEGORIES, type SkillCategory, type SkillSet } from "../installation/application/bundled-skill-selection.js";
 
 const HARNESS_VERSION_FILE = ".harness-version";
 const SKILLS_SOURCE_DIR = "skills";
@@ -25,52 +27,8 @@ const DEFAULT_FOLDER_RULES_DOC = join("docs", "folder_management_rules.md");
 
 // ── Skill Category Map ──
 
-export type SkillCategory = "core" | "aidlc" | "utility" | "guidance";
-export type SkillSet = "core" | "all";
-
-export const SKILL_CATEGORIES: Record<SkillCategory, readonly string[]> = {
-  core: [
-    "cascade-updater",
-    "codebase-mapper",
-    "consistency-checker",
-    "doc-health-checker",
-    "engineering-perspective",
-    "implementation-readiness-checker",
-    "test-coverage-checker",
-  ],
-  aidlc: [
-    "domain-designer",
-    "environment-designer",
-    "it-test-designer",
-    "it-test-logic-designer",
-    "logical-designer",
-    "mock-designer",
-    "product-architect",
-    "quick-implementor",
-    "scenario-test-designer",
-    "scenario-test-logic-designer",
-    "story-implementor",
-    "story-mapper",
-    "story-writer",
-    "uiux-designer",
-    "unit-designer",
-    "unit-test-designer",
-    "unit-test-logic-designer",
-  ],
-  utility: ["codex-delegator", "skill-creator"],
-  guidance: ["phasegate-toolkit-guide", "phasegate-config-doctor", "release-publisher"],
-} as const;
-
 export function getSkillsForSet(skillSet: SkillSet): string[] {
-  if (skillSet === "core") {
-    return [...SKILL_CATEGORIES.core];
-  }
-  return [
-    ...SKILL_CATEGORIES.core,
-    ...SKILL_CATEGORIES.aidlc,
-    ...SKILL_CATEGORIES.utility,
-    ...SKILL_CATEGORIES.guidance,
-  ];
+  return getBundledSkillsForSet(skillSet);
 }
 
 export function getCategoryForSkill(skillName: string): SkillCategory | null {

package/scripts/harness/skill-quality/application/dto/run-plan-checker-loop-output.ts

@@ -9,4 +9,5 @@ export interface RunPlanCheckerLoopOutput {
   readonly status: LoopStatus;
   readonly loopHistory: readonly LoopAttempt[];
   readonly escalationRequired: boolean;
+  readonly stopReason?: 'UNCHANGED_INPUT';
 }

package/scripts/harness/skill-quality/application/usecases/apply-cascade-update-usecase.ts

@@ -2,6 +2,7 @@
  * @layer application
  * @unit skill-quality
  * @work-item-id WI-192
+ * @work-item-id WI-220
  */
 import { CascadeUpdateResult } from '../../domain/value-objects/cascade-update-result.js';
 import type { CascadeUpdateService } from '../../domain/services/cascade-update-service.js';
@@ -21,6 +22,7 @@ export class ApplyCascadeUpdateUseCase {
     let updatedCount = 0;
     const appliedStoryIds: string[] = [];
     const errors: string[] = [];
+    const visitedFiles = new Set<string>();
 
     for (const target of targets) {
       try {
@@ -30,13 +32,16 @@ export class ApplyCascadeUpdateUseCase {
           : [target.filePath];
 
         for (const filePath of filePaths) {
+          if (visitedFiles.has(filePath)) continue;
+          visitedFiles.add(filePath);
           try {
             const content = await this.fileSystemPort.read(filePath);
-            // Append story-id tag if not already present
-            const updatedContent = content.includes(target.storyIdTag)
+            // This is exact tag presence, not proof of semantic reflection.
+            const updatedContent = target.hasAnnotationIn(content)
               ? content
-              : `${content}\n${target.storyIdTag}`;
-            if (!input.dryRun && updatedContent !== content) {
+              : `${content}\n${target.renderAnnotation(filePath)}`;
+            if (updatedContent === content) continue;
+            if (!input.dryRun) {
               await this.fileSystemPort.write(filePath, updatedContent);
             }
             updatedCount++;

package/scripts/harness/skill-quality/application/usecases/execute-tdd-cycle-usecase.ts

@@ -13,7 +13,8 @@ export class ExecuteTddCycleUseCase {
 
   async execute(input: ExecuteTddCycleInput): Promise<ExecuteTddCycleOutput> {
     const tddCycle = TddCycle.create(input.phase, input.passed);
-    const commitMessage = CommitMessage.create(input.unit, input.storyId, input.description);
+    const workItemId = /^WI-\d+$/.test(input.storyId) ? input.storyId : undefined;
+    const commitMessage = CommitMessage.create(input.unit, input.storyId, input.description, workItemId);
 
     const readiness = await this.atomicCommitService.execute(tddCycle, commitMessage);
 

package/scripts/harness/skill-quality/application/usecases/run-plan-checker-loop-usecase.ts

@@ -26,6 +26,14 @@ export class RunPlanCheckerLoopUseCase {
         revision: result.revision,
       });
       loop.addAttempt(attempt);
+      if (loop.status === 'RUNNING' && this.planCheckExecutorPort.supportsRetry === false) {
+        return {
+          status: 'FAILED_EXCEEDED',
+          loopHistory: loop.loopHistory,
+          escalationRequired: true,
+          stopReason: 'UNCHANGED_INPUT',
+        };
+      }
       attemptNumber++;
     }
 

package/scripts/harness/skill-quality/composition-root.ts

@@ -14,7 +14,7 @@ import { SkillStructureValidator } from './domain/services/skill-structure-valid
 
 // Infrastructure Adapters
 import { GitCommitExecutorAdapter } from './infrastructure/adapters/git-commit-executor-adapter.js';
-import { L1BiomeValidatorAdapter } from './infrastructure/adapters/l1-biome-validator-adapter.js';
+import { L1BiomeValidatorAdapter, type L1BiomeValidatorOptions } from './infrastructure/adapters/l1-biome-validator-adapter.js';
 import { L2ValidatorSystemAdapter } from './infrastructure/adapters/l2-validator-system-adapter.js';
 import { FileSystemLessonSourceReaderAdapter } from './infrastructure/adapters/file-system-lesson-source-reader-adapter.js';
 import { FileSystemLessonArtifactWriterAdapter } from './infrastructure/adapters/file-system-lesson-artifact-writer-adapter.js';
@@ -60,11 +60,18 @@ class NodeFileSystemAdapter implements FileSystemPort {
   }
 }
 
-export function createSkillQualityHandlers() {
+export interface SkillQualityHandlerOptions {
+  rootDir?: string;
+  l1Config?: L1BiomeValidatorOptions['config'];
+  validatorSystemConfig?: object;
+  failOnWarning?: boolean;
+}
+
+export function createSkillQualityHandlers(options: SkillQualityHandlerOptions = {}) {
   // Infrastructure
   const commitExecutorPort = new GitCommitExecutorAdapter();
-  const l1ValidatorPort = new L1BiomeValidatorAdapter();
-  const l2ValidatorPort = new L2ValidatorSystemAdapter();
+  const l1ValidatorPort = new L1BiomeValidatorAdapter({ rootDir: options.rootDir, config: options.l1Config });
+  const l2ValidatorPort = new L2ValidatorSystemAdapter({ config: options.validatorSystemConfig, failOnWarning: options.failOnWarning });
   const lessonSourceReaderPort = new FileSystemLessonSourceReaderAdapter();
   const lessonArtifactWriterPort = new FileSystemLessonArtifactWriterAdapter();
   const lessonArtifactSchemaPort = new AjvLessonArtifactSchemaAdapter();
@@ -87,6 +94,7 @@ export function createSkillQualityHandlers() {
   const checkCoverageUseCase = new CheckCoverageUseCase(requirementTestMatrixPort, coverageRunnerPort, configQueryPort);
   const runPlanCheckerLoopUseCase = new RunPlanCheckerLoopUseCase(
     {
+      supportsRetry: false,
       evaluate: async (planDocument: string) => {
         // チェックボックス形式（- [x] / - [ ]）でカバレッジを評価する
         const checked = (planDocument.match(/- \[x\]/gi) ?? []).length;
@@ -99,8 +107,7 @@ export function createSkillQualityHandlers() {
         const gaps = planDocument
           .split('\n')
           .filter((line) => /- \[ \]/.test(line))
-          .map((line) => line.replace(/^.*- \[ \]\s*/, '').trim())
-          .filter(Boolean);
+          .map((line) => line.replace(/^.*- \[ \]\s*/, '').trim() || '未記入のチェック項目');
         return { coverageRate, gaps, revision: `${checked}/${total}` };
       },
     }
@@ -114,7 +121,7 @@ export function createSkillQualityHandlers() {
   return {
     executeTddCycleHandler: new ExecuteTddCycleHandler(executeTddCycleUseCase),
     checkCoverageHandler: new CheckCoverageHandler(checkCoverageUseCase),
-    runPlanCheckerLoopHandler: new RunPlanCheckerLoopHandler(runPlanCheckerLoopUseCase),
+    runPlanCheckerLoopHandler: new RunPlanCheckerLoopHandler(runPlanCheckerLoopUseCase, fileSystemPort),
     collectLessonsHandler: new CollectLessonsHandler(collectLessonsUseCase, writeLessonArtifactUseCase),
     applyCascadeUpdateHandler: new ApplyCascadeUpdateHandler(applyCascadeUpdateUseCase),
     validateSkillStructureHandler: new ValidateSkillStructureHandler(validateSkillStructureUseCase),

package/scripts/harness/skill-quality/domain/ports/plan-check-executor-port.ts

@@ -11,5 +11,7 @@ export interface PlanCheckResult {
 }
 
 export interface PlanCheckExecutorPort {
+  /** False for deterministic evaluators; omitted preserves legacy retry behavior. */
+  readonly supportsRetry?: boolean;
   evaluate(planDocument: string, previousAttempts: readonly LoopAttempt[]): Promise<PlanCheckResult>;
 }

package/scripts/harness/skill-quality/domain/value-objects/cascade-update-target.ts

@@ -1,6 +1,7 @@
 /**
  * @layer domain
  * @unit skill-quality
+ * @work-item-id WI-220
  */
 import { SkillQualityError } from '../errors/skill-quality-error.js';
 
@@ -18,11 +19,24 @@ export class CascadeUpdateTarget {
     if (!filePath) {
       throw new SkillQualityError('EMPTY_FILE_PATH', 'filePath must be non-empty');
     }
-    const storyIdTag = `@story-id ${storyId}`;
+    const storyIdTag = `@${/^WI-\d+$/.test(storyId) ? 'work-item-id' : 'story-id'} ${storyId}`;
     return new CascadeUpdateTarget(filePath, storyIdTag);
   }
 
   equals(other: CascadeUpdateTarget): boolean {
     return this.filePath === other.filePath && this.storyIdTag === other.storyIdTag;
   }
+
+  renderAnnotation(filePath: string): string {
+    return /\.(?:[cm]?[jt]s|[jt]sx)$/i.test(filePath) ? `// ${this.storyIdTag}` : this.storyIdTag;
+  }
+
+  hasAnnotationIn(content: string): boolean {
+    const storyId = this.storyIdTag.slice(this.storyIdTag.indexOf(' ') + 1);
+    for (const match of content.matchAll(/@(?:story-id|issue-id|work-item-id)[ \t]+([^\r\n]+)/g)) {
+      const ids = match[1].replace(/-->.*$/, '').split(/[\s,]+/);
+      if (ids.includes(storyId)) return true;
+    }
+    return false;
+  }
 }

package/scripts/harness/skill-quality/infrastructure/adapters/l1-biome-validator-adapter.ts

@@ -5,12 +5,20 @@
 import type { L1ValidatorPort } from '../../domain/ports/l1-validator-port.js';
 import type { CommitMessage } from '../../domain/value-objects/commit-message.js';
 import type { ValidationViolation } from '../../domain/types/validation-violation.js';
+import type { BiomeAstEngineModuleOptions } from '../../../biome-ast-engine/composition-root.js';
+
+export interface L1BiomeValidatorOptions {
+  rootDir?: string;
+  config?: BiomeAstEngineModuleOptions;
+}
 
 export class L1BiomeValidatorAdapter implements L1ValidatorPort {
+  constructor(private readonly options: L1BiomeValidatorOptions = {}) {}
+
   async validate(_commitMessage: CommitMessage): Promise<readonly ValidationViolation[]> {
     try {
       const { createBiomeAstEngineModule } = await import('../../../biome-ast-engine/composition-root.js');
-      const mod = createBiomeAstEngineModule(process.cwd());
+      const mod = createBiomeAstEngineModule(this.options.rootDir ?? process.cwd(), this.options.config);
       const output = await mod.executeLintUseCase.execute({ targets: [] });
 
       return output.report.violations.map((violation) => ({

package/scripts/harness/skill-quality/infrastructure/adapters/l2-validator-system-adapter.ts

@@ -5,20 +5,36 @@
 import type { L2ValidatorPort } from '../../domain/ports/l2-validator-port.js';
 import type { CommitMessage } from '../../domain/value-objects/commit-message.js';
 import type { ValidationViolation } from '../../domain/types/validation-violation.js';
+import { isEffectivelyPassed } from '../../../validator-system/domain/services/effective-severity-policy.js';
+
+export interface L2ValidatorSystemOptions {
+  config?: object;
+  failOnWarning?: boolean;
+}
 
 export class L2ValidatorSystemAdapter implements L2ValidatorPort {
+  constructor(private readonly options: L2ValidatorSystemOptions = {}) {}
+
   async validate(_commitMessage: CommitMessage): Promise<readonly ValidationViolation[]> {
     try {
       const { createValidatorSystemModule } = await import('../../../validator-system/composition-root.js');
-      const mod = createValidatorSystemModule();
+      const mod = createValidatorSystemModule(this.options.config);
+      // Direct legacy callers keep warning-as-blocking unless explicitly configured.
+      const failOnWarning = this.options.failOnWarning ?? true;
       const report = await mod.runFullValidationUseCase.execute({
         targetPaths: [],
         unitName: '',
         currentPhase: '',
         includeL4: false,
+        failOnWarning,
       });
 
-      return report.allErrors.map((error) => ({
+      const blockingErrors = report.allErrors.filter((error) => {
+        const advisory = isEffectivelyPassed({ passed: false, errors: [error] }, failOnWarning);
+        if (advisory) console.warn(`[skill-quality] [${error.code}] ${error.message}`);
+        return !advisory;
+      });
+      return blockingErrors.map((error) => ({
         ruleId: error.code.toString(),
         message: error.message,
         location: '',

package/scripts/harness/skill-quality/presentation/handlers/apply-cascade-update-handler.ts

@@ -2,6 +2,7 @@
  * @layer presentation
  * @unit skill-quality
  * @work-item-id WI-192
+ * @work-item-id WI-220
  */
 import type { ApplyCascadeUpdateUseCase } from '../../application/usecases/apply-cascade-update-usecase.js';
 
@@ -20,12 +21,17 @@ export class ApplyCascadeUpdateHandler {
       if (args.format === 'json') {
         return {
           exitCode: output.errors.length > 0 ? 1 : 0,
-          message: JSON.stringify({ dryRun: args.dryRun === true, ...output }, null, 2),
+          message: JSON.stringify({
+            dryRun: args.dryRun === true,
+            ...output,
+            operation: 'traceability-tag-update',
+            semanticReviewPerformed: false,
+          }, null, 2),
         };
       }
       const tagsLine = output.appliedStoryIds.join(', ');
       const verb = args.dryRun ? 'Would update' : 'Updated';
-      let msg = `${verb} ${output.updatedCount} files with tags: ${tagsLine}`;
+      let msg = `${verb} ${output.updatedCount} files with tags: ${tagsLine}\nタグ追記のみです。意味レビューは未実施であり、設計内容の反映・承認を保証しません。`;
 
       if (output.errors.length > 0) {
         const errLines = output.errors.map((e) => `  - ${e}`).join('\n');

package/scripts/harness/skill-quality/presentation/handlers/execute-tdd-cycle-handler.ts

@@ -16,6 +16,7 @@ export class ExecuteTddCycleHandler {
   constructor(private readonly useCase: ExecuteTddCycleUseCase) {}
 
   async handle(args: ExecuteTddCycleArgs): Promise<{ exitCode: number; message: string }> {
+    const evidenceNotice = '\n注意: --passed は呼出元の申告です。このコマンドはテストを実行しません。';
     try {
       const output = await this.useCase.execute({
         unit: args.unit,
@@ -26,12 +27,12 @@ export class ExecuteTddCycleHandler {
       });
 
       if (output.ready) {
-        return { exitCode: 0, message: `Commit successful: ${output.committedMessage}` };
+        return { exitCode: 0, message: `Commit successful: ${output.committedMessage}${evidenceNotice}` };
       }
       const violationMessages = output.violations.map((v) => `  - [${v.ruleId}] ${v.message}`).join('\n');
-      return { exitCode: 1, message: `Validation failed:\n${violationMessages}` };
+      return { exitCode: 1, message: `Validation failed:\n${violationMessages}${evidenceNotice}` };
     } catch (err) {
-      return { exitCode: 2, message: `Error: ${err instanceof Error ? err.message : String(err)}` };
+      return { exitCode: 2, message: `Error: ${err instanceof Error ? err.message : String(err)}${evidenceNotice}` };
     }
   }
 }

package/scripts/harness/skill-quality/presentation/handlers/run-plan-checker-loop-handler.ts

@@ -3,6 +3,7 @@
  * @unit skill-quality
  */
 import type { RunPlanCheckerLoopUseCase } from '../../application/usecases/run-plan-checker-loop-usecase.js';
+import type { FileSystemPort } from '../../domain/ports/file-system-port.js';
 
 export interface RunPlanCheckerLoopArgs {
   planFile: string;
@@ -10,12 +11,15 @@ export interface RunPlanCheckerLoopArgs {
 }
 
 export class RunPlanCheckerLoopHandler {
-  constructor(private readonly useCase: RunPlanCheckerLoopUseCase) {}
+  constructor(
+    private readonly useCase: RunPlanCheckerLoopUseCase,
+    private readonly planReader?: Pick<FileSystemPort, 'read'>,
+  ) {}
 
   async handle(args: RunPlanCheckerLoopArgs): Promise<{ exitCode: number; message: string }> {
     try {
       const output = await this.useCase.execute({
-        planDocument: args.planFile,
+        planDocument: this.planReader ? await this.planReader.read(args.planFile) : args.planFile,
         storyId: args.storyId,
       });
 
@@ -24,9 +28,12 @@ export class RunPlanCheckerLoopHandler {
       ).join('\n');
 
       if (output.escalationRequired) {
-        return { exitCode: 1, message: `Plan check FAILED_EXCEEDED - escalation required\n${historyLines}` };
+        const guidance = output.stopReason === 'UNCHANGED_INPUT'
+          ? '\n同じ入力の再試行では改善しません。文書を修正するか判断を求めてください。'
+          : '';
+        return { exitCode: 1, message: `Plan check FAILED_EXCEEDED - escalation required\n${historyLines}${guidance}\nこの結果は設計の意味的承認ではありません。` };
       }
-      return { exitCode: 0, message: `Plan check PASSED\n${historyLines}` };
+      return { exitCode: 0, message: `Plan check PASSED\n${historyLines}\nこの結果は設計の意味的承認ではありません。` };
     } catch (err) {
       return { exitCode: 2, message: `Error: ${err instanceof Error ? err.message : String(err)}` };
     }

package/scripts/harness/traceability-model/infrastructure/parsers/work-item-frontmatter-parser.ts

@@ -31,6 +31,47 @@ const flowArrayPattern = (key: string): RegExp => new RegExp(`^\\s*${key}\\s*:\\
 const blockArrayPattern = (key: string): RegExp =>
   new RegExp(`^\\s*${key}\\s*:\\s*\\r?\\n((?:[ \\t]+-[ \\t]+.+\\r?\\n?)+)`, "m");
 
+/** Opt-in dependency diagnostics; existing metadata readers keep their old contract. */
+export function parseWorkItemDependencies(content: string): readonly string[] | undefined {
+  const body = FRONTMATTER_PATTERN.exec(content)?.[1];
+  if (body === undefined) return undefined;
+  const lines = body.split(/\r?\n/);
+  const headers = lines.flatMap((line, index) => /^[ \t]*depends_on[ \t]*:/.test(line) ? [index] : []);
+  if (headers.length === 0) return undefined;
+  const invalid = (reason: string): never => {
+    throw new WorkItemFrontmatterValidationError(`depends_on ${reason}`);
+  };
+  if (headers.length !== 1) return invalid('が重複しています');
+  if (!lines[headers[0]].startsWith('depends_on')) return invalid('はfrontmatter直下に指定してください');
+  const withoutComment = (value: string) => value.replace(/[ \t]+#.*$/, '').trim();
+  const declaration = withoutComment(lines[headers[0]].replace(/^[ \t]*depends_on[ \t]*:/, ''));
+  const continuation: string[] = [];
+  for (const line of lines.slice(headers[0] + 1)) {
+    if (line.trim() === '' || line.trimStart().startsWith('#')) continue;
+    if (/^[^\s:#][^:]*:/.test(line)) break;
+    continuation.push(line);
+  }
+  let values: string[];
+  if (declaration.startsWith('[') && declaration.endsWith(']')) {
+    if (continuation.length > 0) return invalid('のflow配列に続く行が不正です');
+    const inner = declaration.slice(1, -1).trim();
+    values = inner === '' ? [] : inner.split(',');
+  } else if (declaration === '') {
+    values = [];
+    for (const line of continuation) {
+      const item = /^[ \t]+-[ \t]+(.+)$/.exec(line);
+      if (!item) return invalid('はWI IDの配列で指定してください');
+      values.push(withoutComment(item[1]));
+    }
+    if (values.length === 0) return invalid('の空宣言には [] を指定してください');
+  } else {
+    return invalid('はWI IDの配列で指定してください');
+  }
+  const ids = values.map((value) => stripYamlQuotes(value.trim()));
+  if (ids.some((id) => !/^WI-\d+$/.test(id))) return invalid('に不正なWI IDまたは空項目があります');
+  return Object.freeze(ids);
+}
+
 export function parseWorkItemFrontmatter(content: string): WorkItemFrontmatter | null {
   const match = FRONTMATTER_PATTERN.exec(content);
   if (!match) return null;

package/skills/README.md

@@ -20,4 +20,11 @@
 
 ## 新しいスキルの追加
 
+### 利用者向けの選択
+
+<!-- @work-item-id WI-223 -->
+`phasegate install --skills consumer --dry-run`で本体メンテナー用の`release-publisher`と`skill-creator`を除く27件を確認できる。適用は`--apply`を明示する。既存の`core`は7件、`all`と省略時は29件のまま。reconcileは各配置先の`.harness-version`に記録したセットを維持する。セット変更だけで以前のスキルやユーザー作成スキルを削除しないため、既存allからの切替は削除移行ではない。
+
+配布カタログの正本は`installation/application/bundled-skill-selection.ts`の一箇所。consumerは言語非依存化済みという意味ではなく、Vitest/Playwright等の技術固有スキルは引き続き含まれる。
+
 新しいスキルを追加する場合は、この `skills` ディレクトリに直接追加してください。あわせて `docs/guide/skills-overview.md`、README の skill 数、必要なら `skills/phasegate-toolkit-guide/SKILL.md` の参照先を更新します。シンボリックリンクを通じて、対応エージェントから利用可能になります。<!-- @work-item-id WI-154 -->