@actrun_ai/tastekit-core 0.1.0
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/dist/compiler/compiler.d.ts +24 -0
- package/dist/compiler/compiler.d.ts.map +1 -0
- package/dist/compiler/compiler.js +153 -0
- package/dist/compiler/compiler.js.map +1 -0
- package/dist/compiler/constitution-compiler.d.ts +11 -0
- package/dist/compiler/constitution-compiler.d.ts.map +1 -0
- package/dist/compiler/constitution-compiler.js +154 -0
- package/dist/compiler/constitution-compiler.js.map +1 -0
- package/dist/compiler/derivation.d.ts +125 -0
- package/dist/compiler/derivation.d.ts.map +1 -0
- package/dist/compiler/derivation.js +109 -0
- package/dist/compiler/derivation.js.map +1 -0
- package/dist/compiler/guardrails-compiler.d.ts +11 -0
- package/dist/compiler/guardrails-compiler.d.ts.map +1 -0
- package/dist/compiler/guardrails-compiler.js +362 -0
- package/dist/compiler/guardrails-compiler.js.map +1 -0
- package/dist/compiler/index.d.ts +13 -0
- package/dist/compiler/index.d.ts.map +1 -0
- package/dist/compiler/index.js +13 -0
- package/dist/compiler/index.js.map +1 -0
- package/dist/compiler/memory-compiler.d.ts +12 -0
- package/dist/compiler/memory-compiler.d.ts.map +1 -0
- package/dist/compiler/memory-compiler.js +293 -0
- package/dist/compiler/memory-compiler.js.map +1 -0
- package/dist/compiler/playbook-compiler.d.ts +15 -0
- package/dist/compiler/playbook-compiler.d.ts.map +1 -0
- package/dist/compiler/playbook-compiler.js +1143 -0
- package/dist/compiler/playbook-compiler.js.map +1 -0
- package/dist/compiler/skills-compiler.d.ts +15 -0
- package/dist/compiler/skills-compiler.d.ts.map +1 -0
- package/dist/compiler/skills-compiler.js +203 -0
- package/dist/compiler/skills-compiler.js.map +1 -0
- package/dist/domains/development-agent/domain.d.ts +8 -0
- package/dist/domains/development-agent/domain.d.ts.map +1 -0
- package/dist/domains/development-agent/domain.js +35 -0
- package/dist/domains/development-agent/domain.js.map +1 -0
- package/dist/domains/development-agent/index.d.ts +3 -0
- package/dist/domains/development-agent/index.d.ts.map +1 -0
- package/dist/domains/development-agent/index.js +3 -0
- package/dist/domains/development-agent/index.js.map +1 -0
- package/dist/domains/development-agent/rubric.d.ts +13 -0
- package/dist/domains/development-agent/rubric.d.ts.map +1 -0
- package/dist/domains/development-agent/rubric.js +451 -0
- package/dist/domains/development-agent/rubric.js.map +1 -0
- package/dist/domains/development-agent/skills/code-review.d.ts +25 -0
- package/dist/domains/development-agent/skills/code-review.d.ts.map +1 -0
- package/dist/domains/development-agent/skills/code-review.js +146 -0
- package/dist/domains/development-agent/skills/code-review.js.map +1 -0
- package/dist/domains/development-agent/skills/debugging-issues.d.ts +25 -0
- package/dist/domains/development-agent/skills/debugging-issues.d.ts.map +1 -0
- package/dist/domains/development-agent/skills/debugging-issues.js +155 -0
- package/dist/domains/development-agent/skills/debugging-issues.js.map +1 -0
- package/dist/domains/development-agent/skills/documenting-code.d.ts +19 -0
- package/dist/domains/development-agent/skills/documenting-code.d.ts.map +1 -0
- package/dist/domains/development-agent/skills/documenting-code.js +92 -0
- package/dist/domains/development-agent/skills/documenting-code.js.map +1 -0
- package/dist/domains/development-agent/skills/index.d.ts +55 -0
- package/dist/domains/development-agent/skills/index.d.ts.map +1 -0
- package/dist/domains/development-agent/skills/index.js +19 -0
- package/dist/domains/development-agent/skills/index.js.map +1 -0
- package/dist/domains/development-agent/skills/refactor-plan.d.ts +19 -0
- package/dist/domains/development-agent/skills/refactor-plan.d.ts.map +1 -0
- package/dist/domains/development-agent/skills/refactor-plan.js +117 -0
- package/dist/domains/development-agent/skills/refactor-plan.js.map +1 -0
- package/dist/domains/development-agent/skills/writing-tests.d.ts +20 -0
- package/dist/domains/development-agent/skills/writing-tests.d.ts.map +1 -0
- package/dist/domains/development-agent/skills/writing-tests.js +93 -0
- package/dist/domains/development-agent/skills/writing-tests.js.map +1 -0
- package/dist/domains/general-agent/domain.d.ts +9 -0
- package/dist/domains/general-agent/domain.d.ts.map +1 -0
- package/dist/domains/general-agent/domain.js +36 -0
- package/dist/domains/general-agent/domain.js.map +1 -0
- package/dist/domains/general-agent/index.d.ts +4 -0
- package/dist/domains/general-agent/index.d.ts.map +1 -0
- package/dist/domains/general-agent/index.js +4 -0
- package/dist/domains/general-agent/index.js.map +1 -0
- package/dist/domains/general-agent/rubric.d.ts +8 -0
- package/dist/domains/general-agent/rubric.d.ts.map +1 -0
- package/dist/domains/general-agent/rubric.js +332 -0
- package/dist/domains/general-agent/rubric.js.map +1 -0
- package/dist/domains/general-agent/skills/context-synthesis.d.ts +19 -0
- package/dist/domains/general-agent/skills/context-synthesis.d.ts.map +1 -0
- package/dist/domains/general-agent/skills/context-synthesis.js +94 -0
- package/dist/domains/general-agent/skills/context-synthesis.js.map +1 -0
- package/dist/domains/general-agent/skills/index.d.ts +32 -0
- package/dist/domains/general-agent/skills/index.d.ts.map +1 -0
- package/dist/domains/general-agent/skills/index.js +11 -0
- package/dist/domains/general-agent/skills/index.js.map +1 -0
- package/dist/domains/general-agent/skills/task-orchestration.d.ts +19 -0
- package/dist/domains/general-agent/skills/task-orchestration.d.ts.map +1 -0
- package/dist/domains/general-agent/skills/task-orchestration.js +101 -0
- package/dist/domains/general-agent/skills/task-orchestration.js.map +1 -0
- package/dist/domains/index.d.ts +21 -0
- package/dist/domains/index.d.ts.map +1 -0
- package/dist/domains/index.js +37 -0
- package/dist/domains/index.js.map +1 -0
- package/dist/domains/types.d.ts +22 -0
- package/dist/domains/types.d.ts.map +1 -0
- package/dist/domains/types.js +2 -0
- package/dist/domains/types.js.map +1 -0
- package/dist/drift/consolidator.d.ts +47 -0
- package/dist/drift/consolidator.d.ts.map +1 -0
- package/dist/drift/consolidator.js +116 -0
- package/dist/drift/consolidator.js.map +1 -0
- package/dist/drift/detector.d.ts +79 -0
- package/dist/drift/detector.d.ts.map +1 -0
- package/dist/drift/detector.js +424 -0
- package/dist/drift/detector.js.map +1 -0
- package/dist/drift/index.d.ts +9 -0
- package/dist/drift/index.d.ts.map +1 -0
- package/dist/drift/index.js +9 -0
- package/dist/drift/index.js.map +1 -0
- package/dist/drift/proposal.d.ts +108 -0
- package/dist/drift/proposal.d.ts.map +1 -0
- package/dist/drift/proposal.js +2 -0
- package/dist/drift/proposal.js.map +1 -0
- package/dist/eval/index.d.ts +9 -0
- package/dist/eval/index.d.ts.map +1 -0
- package/dist/eval/index.js +9 -0
- package/dist/eval/index.js.map +1 -0
- package/dist/eval/judge.d.ts +33 -0
- package/dist/eval/judge.d.ts.map +1 -0
- package/dist/eval/judge.js +209 -0
- package/dist/eval/judge.js.map +1 -0
- package/dist/eval/replay.d.ts +23 -0
- package/dist/eval/replay.d.ts.map +1 -0
- package/dist/eval/replay.js +42 -0
- package/dist/eval/replay.js.map +1 -0
- package/dist/eval/runner.d.ts +35 -0
- package/dist/eval/runner.d.ts.map +1 -0
- package/dist/eval/runner.js +52 -0
- package/dist/eval/runner.js.map +1 -0
- package/dist/generators/agents-md-generator.d.ts +9 -0
- package/dist/generators/agents-md-generator.d.ts.map +1 -0
- package/dist/generators/agents-md-generator.js +71 -0
- package/dist/generators/agents-md-generator.js.map +1 -0
- package/dist/generators/blocks/domain-context.d.ts +7 -0
- package/dist/generators/blocks/domain-context.d.ts.map +1 -0
- package/dist/generators/blocks/domain-context.js +26 -0
- package/dist/generators/blocks/domain-context.js.map +1 -0
- package/dist/generators/blocks/drift-awareness.d.ts +6 -0
- package/dist/generators/blocks/drift-awareness.d.ts.map +1 -0
- package/dist/generators/blocks/drift-awareness.js +28 -0
- package/dist/generators/blocks/drift-awareness.js.map +1 -0
- package/dist/generators/blocks/evaluation-criteria.d.ts +7 -0
- package/dist/generators/blocks/evaluation-criteria.d.ts.map +1 -0
- package/dist/generators/blocks/evaluation-criteria.js +18 -0
- package/dist/generators/blocks/evaluation-criteria.js.map +1 -0
- package/dist/generators/blocks/guardrails.d.ts +6 -0
- package/dist/generators/blocks/guardrails.d.ts.map +1 -0
- package/dist/generators/blocks/guardrails.js +44 -0
- package/dist/generators/blocks/guardrails.js.map +1 -0
- package/dist/generators/blocks/identity.d.ts +6 -0
- package/dist/generators/blocks/identity.d.ts.map +1 -0
- package/dist/generators/blocks/identity.js +36 -0
- package/dist/generators/blocks/identity.js.map +1 -0
- package/dist/generators/blocks/memory-policy.d.ts +6 -0
- package/dist/generators/blocks/memory-policy.d.ts.map +1 -0
- package/dist/generators/blocks/memory-policy.js +34 -0
- package/dist/generators/blocks/memory-policy.js.map +1 -0
- package/dist/generators/blocks/playbook-index.d.ts +7 -0
- package/dist/generators/blocks/playbook-index.d.ts.map +1 -0
- package/dist/generators/blocks/playbook-index.js +14 -0
- package/dist/generators/blocks/playbook-index.js.map +1 -0
- package/dist/generators/blocks/session-rhythm.d.ts +6 -0
- package/dist/generators/blocks/session-rhythm.d.ts.map +1 -0
- package/dist/generators/blocks/session-rhythm.js +11 -0
- package/dist/generators/blocks/session-rhythm.js.map +1 -0
- package/dist/generators/blocks/skills-index.d.ts +6 -0
- package/dist/generators/blocks/skills-index.d.ts.map +1 -0
- package/dist/generators/blocks/skills-index.js +36 -0
- package/dist/generators/blocks/skills-index.js.map +1 -0
- package/dist/generators/blocks/tool-usage.d.ts +6 -0
- package/dist/generators/blocks/tool-usage.d.ts.map +1 -0
- package/dist/generators/blocks/tool-usage.js +31 -0
- package/dist/generators/blocks/tool-usage.js.map +1 -0
- package/dist/generators/blocks/vocabulary.d.ts +7 -0
- package/dist/generators/blocks/vocabulary.d.ts.map +1 -0
- package/dist/generators/blocks/vocabulary.js +27 -0
- package/dist/generators/blocks/vocabulary.js.map +1 -0
- package/dist/generators/claude-hooks-compat.d.ts +33 -0
- package/dist/generators/claude-hooks-compat.d.ts.map +1 -0
- package/dist/generators/claude-hooks-compat.js +322 -0
- package/dist/generators/claude-hooks-compat.js.map +1 -0
- package/dist/generators/claude-md-generator.d.ts +12 -0
- package/dist/generators/claude-md-generator.d.ts.map +1 -0
- package/dist/generators/claude-md-generator.js +60 -0
- package/dist/generators/claude-md-generator.js.map +1 -0
- package/dist/generators/index.d.ts +11 -0
- package/dist/generators/index.d.ts.map +1 -0
- package/dist/generators/index.js +11 -0
- package/dist/generators/index.js.map +1 -0
- package/dist/generators/soul-md-generator.d.ts +9 -0
- package/dist/generators/soul-md-generator.d.ts.map +1 -0
- package/dist/generators/soul-md-generator.js +104 -0
- package/dist/generators/soul-md-generator.js.map +1 -0
- package/dist/generators/types.d.ts +55 -0
- package/dist/generators/types.d.ts.map +1 -0
- package/dist/generators/types.js +7 -0
- package/dist/generators/types.js.map +1 -0
- package/dist/index.d.ts +19 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +20 -0
- package/dist/index.js.map +1 -0
- package/dist/interview/index.d.ts +11 -0
- package/dist/interview/index.d.ts.map +1 -0
- package/dist/interview/index.js +11 -0
- package/dist/interview/index.js.map +1 -0
- package/dist/interview/interviewer.d.ts +94 -0
- package/dist/interview/interviewer.d.ts.map +1 -0
- package/dist/interview/interviewer.js +516 -0
- package/dist/interview/interviewer.js.map +1 -0
- package/dist/interview/questions.d.ts +15 -0
- package/dist/interview/questions.d.ts.map +1 -0
- package/dist/interview/questions.js +86 -0
- package/dist/interview/questions.js.map +1 -0
- package/dist/interview/rubric.d.ts +265 -0
- package/dist/interview/rubric.d.ts.map +1 -0
- package/dist/interview/rubric.js +74 -0
- package/dist/interview/rubric.js.map +1 -0
- package/dist/interview/session.d.ts +9 -0
- package/dist/interview/session.d.ts.map +1 -0
- package/dist/interview/session.js +33 -0
- package/dist/interview/session.js.map +1 -0
- package/dist/interview/universal-rubric.d.ts +11 -0
- package/dist/interview/universal-rubric.d.ts.map +1 -0
- package/dist/interview/universal-rubric.js +165 -0
- package/dist/interview/universal-rubric.js.map +1 -0
- package/dist/llm/index.d.ts +8 -0
- package/dist/llm/index.d.ts.map +1 -0
- package/dist/llm/index.js +8 -0
- package/dist/llm/index.js.map +1 -0
- package/dist/llm/provider.d.ts +62 -0
- package/dist/llm/provider.d.ts.map +1 -0
- package/dist/llm/provider.js +24 -0
- package/dist/llm/provider.js.map +1 -0
- package/dist/llm/providers/anthropic.d.ts +18 -0
- package/dist/llm/providers/anthropic.d.ts.map +1 -0
- package/dist/llm/providers/anthropic.js +56 -0
- package/dist/llm/providers/anthropic.js.map +1 -0
- package/dist/llm/providers/ollama.d.ts +17 -0
- package/dist/llm/providers/ollama.d.ts.map +1 -0
- package/dist/llm/providers/ollama.js +45 -0
- package/dist/llm/providers/ollama.js.map +1 -0
- package/dist/llm/providers/openai.d.ts +19 -0
- package/dist/llm/providers/openai.d.ts.map +1 -0
- package/dist/llm/providers/openai.js +52 -0
- package/dist/llm/providers/openai.js.map +1 -0
- package/dist/llm/resolve.d.ts +11 -0
- package/dist/llm/resolve.d.ts.map +1 -0
- package/dist/llm/resolve.js +56 -0
- package/dist/llm/resolve.js.map +1 -0
- package/dist/mcp/binder.d.ts +28 -0
- package/dist/mcp/binder.d.ts.map +1 -0
- package/dist/mcp/binder.js +87 -0
- package/dist/mcp/binder.js.map +1 -0
- package/dist/mcp/client.d.ts +99 -0
- package/dist/mcp/client.d.ts.map +1 -0
- package/dist/mcp/client.js +196 -0
- package/dist/mcp/client.js.map +1 -0
- package/dist/mcp/index.d.ts +9 -0
- package/dist/mcp/index.d.ts.map +1 -0
- package/dist/mcp/index.js +9 -0
- package/dist/mcp/index.js.map +1 -0
- package/dist/mcp/inspector.d.ts +29 -0
- package/dist/mcp/inspector.d.ts.map +1 -0
- package/dist/mcp/inspector.js +44 -0
- package/dist/mcp/inspector.js.map +1 -0
- package/dist/schemas/bindings.d.ts +248 -0
- package/dist/schemas/bindings.d.ts.map +1 -0
- package/dist/schemas/bindings.js +34 -0
- package/dist/schemas/bindings.js.map +1 -0
- package/dist/schemas/constitution.d.ts +229 -0
- package/dist/schemas/constitution.d.ts.map +1 -0
- package/dist/schemas/constitution.js +47 -0
- package/dist/schemas/constitution.js.map +1 -0
- package/dist/schemas/evalpack.d.ts +322 -0
- package/dist/schemas/evalpack.d.ts.map +1 -0
- package/dist/schemas/evalpack.js +43 -0
- package/dist/schemas/evalpack.js.map +1 -0
- package/dist/schemas/guardrails.d.ts +171 -0
- package/dist/schemas/guardrails.d.ts.map +1 -0
- package/dist/schemas/guardrails.js +35 -0
- package/dist/schemas/guardrails.js.map +1 -0
- package/dist/schemas/index.d.ts +18 -0
- package/dist/schemas/index.d.ts.map +1 -0
- package/dist/schemas/index.js +18 -0
- package/dist/schemas/index.js.map +1 -0
- package/dist/schemas/memory.d.ts +277 -0
- package/dist/schemas/memory.d.ts.map +1 -0
- package/dist/schemas/memory.js +42 -0
- package/dist/schemas/memory.js.map +1 -0
- package/dist/schemas/playbook.d.ts +270 -0
- package/dist/schemas/playbook.d.ts.map +1 -0
- package/dist/schemas/playbook.js +52 -0
- package/dist/schemas/playbook.js.map +1 -0
- package/dist/schemas/skills.d.ts +320 -0
- package/dist/schemas/skills.d.ts.map +1 -0
- package/dist/schemas/skills.js +84 -0
- package/dist/schemas/skills.js.map +1 -0
- package/dist/schemas/trace.d.ts +126 -0
- package/dist/schemas/trace.d.ts.map +1 -0
- package/dist/schemas/trace.js +70 -0
- package/dist/schemas/trace.js.map +1 -0
- package/dist/schemas/trust.d.ts +142 -0
- package/dist/schemas/trust.d.ts.map +1 -0
- package/dist/schemas/trust.js +30 -0
- package/dist/schemas/trust.js.map +1 -0
- package/dist/schemas/validators.d.ts +26 -0
- package/dist/schemas/validators.d.ts.map +1 -0
- package/dist/schemas/validators.js +79 -0
- package/dist/schemas/validators.js.map +1 -0
- package/dist/schemas/workspace.d.ts +725 -0
- package/dist/schemas/workspace.d.ts.map +1 -0
- package/dist/schemas/workspace.js +119 -0
- package/dist/schemas/workspace.js.map +1 -0
- package/dist/skills/constraints.d.ts +19 -0
- package/dist/skills/constraints.d.ts.map +1 -0
- package/dist/skills/constraints.js +91 -0
- package/dist/skills/constraints.js.map +1 -0
- package/dist/skills/generator.d.ts +13 -0
- package/dist/skills/generator.d.ts.map +1 -0
- package/dist/skills/generator.js +126 -0
- package/dist/skills/generator.js.map +1 -0
- package/dist/skills/graph.d.ts +42 -0
- package/dist/skills/graph.d.ts.map +1 -0
- package/dist/skills/graph.js +217 -0
- package/dist/skills/graph.js.map +1 -0
- package/dist/skills/index.d.ts +13 -0
- package/dist/skills/index.d.ts.map +1 -0
- package/dist/skills/index.js +13 -0
- package/dist/skills/index.js.map +1 -0
- package/dist/skills/linter.d.ts +22 -0
- package/dist/skills/linter.d.ts.map +1 -0
- package/dist/skills/linter.js +201 -0
- package/dist/skills/linter.js.map +1 -0
- package/dist/skills/packer.d.ts +27 -0
- package/dist/skills/packer.d.ts.map +1 -0
- package/dist/skills/packer.js +72 -0
- package/dist/skills/packer.js.map +1 -0
- package/dist/skills/tracker.d.ts +27 -0
- package/dist/skills/tracker.d.ts.map +1 -0
- package/dist/skills/tracker.js +131 -0
- package/dist/skills/tracker.js.map +1 -0
- package/dist/skills/versioner.d.ts +19 -0
- package/dist/skills/versioner.d.ts.map +1 -0
- package/dist/skills/versioner.js +76 -0
- package/dist/skills/versioner.js.map +1 -0
- package/dist/tracing/index.d.ts +8 -0
- package/dist/tracing/index.d.ts.map +1 -0
- package/dist/tracing/index.js +8 -0
- package/dist/tracing/index.js.map +1 -0
- package/dist/tracing/reader.d.ts +18 -0
- package/dist/tracing/reader.d.ts.map +1 -0
- package/dist/tracing/reader.js +34 -0
- package/dist/tracing/reader.js.map +1 -0
- package/dist/tracing/tracer.d.ts +22 -0
- package/dist/tracing/tracer.d.ts.map +1 -0
- package/dist/tracing/tracer.js +105 -0
- package/dist/tracing/tracer.js.map +1 -0
- package/dist/trust/auditor.d.ts +35 -0
- package/dist/trust/auditor.d.ts.map +1 -0
- package/dist/trust/auditor.js +78 -0
- package/dist/trust/auditor.js.map +1 -0
- package/dist/trust/index.d.ts +8 -0
- package/dist/trust/index.d.ts.map +1 -0
- package/dist/trust/index.js +8 -0
- package/dist/trust/index.js.map +1 -0
- package/dist/trust/manager.d.ts +18 -0
- package/dist/trust/manager.d.ts.map +1 -0
- package/dist/trust/manager.js +60 -0
- package/dist/trust/manager.js.map +1 -0
- package/dist/utils/filesystem.d.ts +15 -0
- package/dist/utils/filesystem.d.ts.map +1 -0
- package/dist/utils/filesystem.js +53 -0
- package/dist/utils/filesystem.js.map +1 -0
- package/dist/utils/hash.d.ts +7 -0
- package/dist/utils/hash.d.ts.map +1 -0
- package/dist/utils/hash.js +15 -0
- package/dist/utils/hash.js.map +1 -0
- package/dist/utils/index.d.ts +7 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +7 -0
- package/dist/utils/index.js.map +1 -0
- package/dist/utils/yaml.d.ts +6 -0
- package/dist/utils/yaml.d.ts.map +1 -0
- package/dist/utils/yaml.js +14 -0
- package/dist/utils/yaml.js.map +1 -0
- package/package.json +58 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"debugging-issues.d.ts","sourceRoot":"","sources":["../../../../domains/development-agent/skills/debugging-issues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;CAsJhC,CAAC"}
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Debugging Issues Skill
|
|
3
|
+
*
|
|
4
|
+
* Systematic debugging with root cause investigation.
|
|
5
|
+
*/
|
|
6
|
+
export const DebuggingIssuesSkill = {
|
|
7
|
+
skill_id: 'debugging-issues',
|
|
8
|
+
name: 'Debugging Issues',
|
|
9
|
+
description: 'Systematically investigates bugs and failures to find root causes before proposing fixes. Use when debugging errors, investigating test failures, diagnosing unexpected behavior, or when the user asks to fix a bug, debug, or investigate an issue.',
|
|
10
|
+
tags: ['development', 'debugging', 'investigation'],
|
|
11
|
+
risk_level: 'low',
|
|
12
|
+
required_tools: ['file-system'],
|
|
13
|
+
compatible_runtimes: ['claude-code', 'openclaw', 'manus'],
|
|
14
|
+
feeds_into: ['writing-tests'],
|
|
15
|
+
pipeline_phase: 'process',
|
|
16
|
+
context_model: 'inherit',
|
|
17
|
+
skill_md_content: `# Debugging Issues
|
|
18
|
+
|
|
19
|
+
## Purpose
|
|
20
|
+
|
|
21
|
+
Systematically investigates bugs and failures to find root causes. No fixes until the root cause is understood.
|
|
22
|
+
|
|
23
|
+
## When to use
|
|
24
|
+
|
|
25
|
+
- Investigating error messages or stack traces
|
|
26
|
+
- Diagnosing test failures
|
|
27
|
+
- Understanding unexpected behavior
|
|
28
|
+
- When the user says "fix this bug", "why is this broken", or "debug this"
|
|
29
|
+
|
|
30
|
+
## When NOT to use
|
|
31
|
+
|
|
32
|
+
- For code review (use code-review skill)
|
|
33
|
+
- For writing new features (not a debugging task)
|
|
34
|
+
- When the fix is obvious and doesn't need investigation
|
|
35
|
+
|
|
36
|
+
## Inputs
|
|
37
|
+
|
|
38
|
+
- **symptom**: Error message, failing test, or description of unexpected behavior
|
|
39
|
+
- **context**: When it started, what changed recently, reproduction steps
|
|
40
|
+
- **scope**: Where to look (file paths, modules, or "unknown")
|
|
41
|
+
|
|
42
|
+
## Outputs
|
|
43
|
+
|
|
44
|
+
- **root_cause**: Clear explanation of why the bug happens
|
|
45
|
+
- **evidence**: Specific code paths, line numbers, and data flow that prove the cause
|
|
46
|
+
- **fix_recommendation**: Proposed fix with confidence level
|
|
47
|
+
- **regression_test**: Test case that would catch this bug
|
|
48
|
+
|
|
49
|
+
## Procedure
|
|
50
|
+
|
|
51
|
+
### Step 1: Reproduce and observe
|
|
52
|
+
|
|
53
|
+
- Confirm the bug is reproducible
|
|
54
|
+
- Note the exact error, stack trace, or unexpected output
|
|
55
|
+
- Identify what the correct behavior should be
|
|
56
|
+
|
|
57
|
+
### Step 2: Form hypotheses
|
|
58
|
+
|
|
59
|
+
- List 2-3 most likely causes based on the symptom
|
|
60
|
+
- Rank by probability
|
|
61
|
+
- Identify what evidence would confirm or eliminate each
|
|
62
|
+
|
|
63
|
+
### Step 3: Investigate systematically
|
|
64
|
+
|
|
65
|
+
- Start with the most likely hypothesis
|
|
66
|
+
- Trace the code path from input to failure point
|
|
67
|
+
- Check recent changes (git log, git blame) near the failure
|
|
68
|
+
- Look for related issues (same pattern elsewhere?)
|
|
69
|
+
|
|
70
|
+
### Step 4: Confirm root cause
|
|
71
|
+
|
|
72
|
+
- Identify the exact line(s) causing the issue
|
|
73
|
+
- Explain the causal chain: input -> code path -> failure
|
|
74
|
+
- Verify this explains ALL observed symptoms, not just some
|
|
75
|
+
|
|
76
|
+
### Step 5: Recommend fix
|
|
77
|
+
|
|
78
|
+
- Propose the minimal fix that addresses the root cause
|
|
79
|
+
- Explain why this fix is correct (not just that it works)
|
|
80
|
+
- Suggest a regression test that would catch this bug
|
|
81
|
+
- Note any related code that might have the same issue
|
|
82
|
+
|
|
83
|
+
## Quality checks
|
|
84
|
+
|
|
85
|
+
- [ ] Root cause identified with specific evidence (file, line, data flow)
|
|
86
|
+
- [ ] Fix addresses root cause, not just symptoms
|
|
87
|
+
- [ ] Causal chain explains all observed symptoms
|
|
88
|
+
- [ ] Regression test proposed
|
|
89
|
+
- [ ] No speculative fixes applied without evidence
|
|
90
|
+
|
|
91
|
+
## Guardrail notes
|
|
92
|
+
|
|
93
|
+
Low risk during investigation (read-only). The fix itself may require approval depending on scope. Always present the root cause analysis before applying any fix.
|
|
94
|
+
`,
|
|
95
|
+
bundled_files: [
|
|
96
|
+
{
|
|
97
|
+
path: 'references/REFERENCE.md',
|
|
98
|
+
description: 'Common bug patterns, investigation commands, and root cause analysis templates',
|
|
99
|
+
load_when: 'Investigating unfamiliar bug categories or need investigation command references',
|
|
100
|
+
content: `# Debugging Reference
|
|
101
|
+
|
|
102
|
+
## Common Bug Patterns
|
|
103
|
+
|
|
104
|
+
### State-Related
|
|
105
|
+
- **Stale state**: Component reads cached/outdated value after mutation
|
|
106
|
+
- **Race condition**: Two operations assume exclusive access to shared state
|
|
107
|
+
- **Missing initialization**: Variable used before assignment, default value wrong
|
|
108
|
+
- **State leak**: State from one request/session bleeds into another
|
|
109
|
+
|
|
110
|
+
### Type-Related
|
|
111
|
+
- **Null/undefined access**: Property access on null without guard
|
|
112
|
+
- **Type coercion**: Implicit conversion produces unexpected value (e.g., "5" + 3 = "53")
|
|
113
|
+
- **Schema mismatch**: API response shape differs from expected type
|
|
114
|
+
|
|
115
|
+
### Async-Related
|
|
116
|
+
- **Unhandled rejection**: Promise error not caught
|
|
117
|
+
- **Ordering assumption**: Code assumes async operations complete in call order
|
|
118
|
+
- **Timeout**: Operation takes longer than expected, no timeout configured
|
|
119
|
+
- **Resource leak**: Connection/handle opened but never closed on error path
|
|
120
|
+
|
|
121
|
+
### Integration-Related
|
|
122
|
+
- **API contract change**: Upstream service changed response format
|
|
123
|
+
- **Environment difference**: Works locally, fails in CI/production
|
|
124
|
+
- **Dependency version**: Transitive dependency upgrade changed behavior
|
|
125
|
+
|
|
126
|
+
## Investigation Commands
|
|
127
|
+
|
|
128
|
+
\`\`\`bash
|
|
129
|
+
# Find what changed recently near the failure
|
|
130
|
+
git log --oneline -10 -- <file>
|
|
131
|
+
git blame -L <start>,<end> <file>
|
|
132
|
+
|
|
133
|
+
# Search for similar patterns in codebase
|
|
134
|
+
grep -rn "<error_pattern>" src/
|
|
135
|
+
grep -rn "<function_name>" src/ --include="*.test.*"
|
|
136
|
+
|
|
137
|
+
# Check for the same bug elsewhere
|
|
138
|
+
grep -rn "<buggy_pattern>" src/ | grep -v test | grep -v node_modules
|
|
139
|
+
\`\`\`
|
|
140
|
+
|
|
141
|
+
## Root Cause Report Template
|
|
142
|
+
|
|
143
|
+
\`\`\`
|
|
144
|
+
SYMPTOM: [What the user sees]
|
|
145
|
+
ROOT CAUSE: [Why it happens — exact file:line and mechanism]
|
|
146
|
+
EVIDENCE: [What proves this is the cause, not just a correlate]
|
|
147
|
+
FIX: [Minimal change that addresses the root cause]
|
|
148
|
+
REGRESSION TEST: [Test that catches this bug if it recurs]
|
|
149
|
+
RELATED: [Other code with the same pattern that might also be affected]
|
|
150
|
+
\`\`\`
|
|
151
|
+
`,
|
|
152
|
+
},
|
|
153
|
+
],
|
|
154
|
+
};
|
|
155
|
+
//# sourceMappingURL=debugging-issues.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"debugging-issues.js","sourceRoot":"","sources":["../../../../domains/development-agent/skills/debugging-issues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,uPAAuP;IACpQ,IAAI,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,eAAe,CAAC;IACnD,UAAU,EAAE,KAAc;IAC1B,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,mBAAmB,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC;IACzD,UAAU,EAAE,CAAC,eAAe,CAAC;IAC7B,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,SAAkB;IAEjC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6EnB;IAEC,aAAa,EAAE;QACb;YACE,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,gFAAgF;YAC7F,SAAS,EAAE,kFAAkF;YAC7F,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDd;SACI;KACF;CACF,CAAC"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Documenting Code Skill
|
|
3
|
+
*
|
|
4
|
+
* Generate documentation following user's documentation philosophy.
|
|
5
|
+
*/
|
|
6
|
+
export declare const DocumentingCodeSkill: {
|
|
7
|
+
skill_id: string;
|
|
8
|
+
name: string;
|
|
9
|
+
description: string;
|
|
10
|
+
tags: string[];
|
|
11
|
+
risk_level: "low";
|
|
12
|
+
required_tools: string[];
|
|
13
|
+
compatible_runtimes: string[];
|
|
14
|
+
prerequisites: string[];
|
|
15
|
+
pipeline_phase: string;
|
|
16
|
+
context_model: "inherit";
|
|
17
|
+
skill_md_content: string;
|
|
18
|
+
};
|
|
19
|
+
//# sourceMappingURL=documenting-code.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"documenting-code.d.ts","sourceRoot":"","sources":["../../../../domains/development-agent/skills/documenting-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAsFhC,CAAC"}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Documenting Code Skill
|
|
3
|
+
*
|
|
4
|
+
* Generate documentation following user's documentation philosophy.
|
|
5
|
+
*/
|
|
6
|
+
export const DocumentingCodeSkill = {
|
|
7
|
+
skill_id: 'documenting-code',
|
|
8
|
+
name: 'Documenting Code',
|
|
9
|
+
description: 'Generates documentation following the user\'s documentation philosophy and writing conventions. Use when writing READMEs, API docs, architecture docs, inline documentation, or when the user asks to document, explain, or write docs for code.',
|
|
10
|
+
tags: ['development', 'documentation', 'writing'],
|
|
11
|
+
risk_level: 'low',
|
|
12
|
+
required_tools: ['file-system'],
|
|
13
|
+
compatible_runtimes: ['claude-code', 'openclaw', 'manus'],
|
|
14
|
+
prerequisites: ['code-review'],
|
|
15
|
+
pipeline_phase: 'connect',
|
|
16
|
+
context_model: 'inherit',
|
|
17
|
+
skill_md_content: `# Documenting Code
|
|
18
|
+
|
|
19
|
+
## Purpose
|
|
20
|
+
|
|
21
|
+
Generates documentation that follows the user's documentation philosophy: what to document, how much detail, and what style. Comments explain "why", not "what".
|
|
22
|
+
|
|
23
|
+
## When to use
|
|
24
|
+
|
|
25
|
+
- Writing or updating README files
|
|
26
|
+
- Documenting public APIs or modules
|
|
27
|
+
- Adding architecture decision records
|
|
28
|
+
- When the user asks to "document this", "add docs", or "explain this code"
|
|
29
|
+
|
|
30
|
+
## When NOT to use
|
|
31
|
+
|
|
32
|
+
- For inline comments on obvious code (code should be self-documenting)
|
|
33
|
+
- For generating JSDoc/TSDoc on every function (only public API)
|
|
34
|
+
- When the user wants code reviewed, not documented (use code-review)
|
|
35
|
+
|
|
36
|
+
## Inputs
|
|
37
|
+
|
|
38
|
+
- **target**: File paths, module, or codebase area to document
|
|
39
|
+
- **type**: Documentation type (README, API, architecture, inline, changelog)
|
|
40
|
+
- **audience**: Who reads this (new contributors, API consumers, future maintainers)
|
|
41
|
+
|
|
42
|
+
## Outputs
|
|
43
|
+
|
|
44
|
+
- **documentation**: Markdown files or inline comments following user conventions
|
|
45
|
+
- **structure**: Where docs should live in the project
|
|
46
|
+
|
|
47
|
+
## Procedure
|
|
48
|
+
|
|
49
|
+
### Step 1: Understand the code
|
|
50
|
+
|
|
51
|
+
- Read the target code thoroughly
|
|
52
|
+
- Identify the public API and key abstractions
|
|
53
|
+
- Note non-obvious design decisions and tradeoffs
|
|
54
|
+
|
|
55
|
+
### Step 2: Match user's documentation style
|
|
56
|
+
|
|
57
|
+
Apply the user's documentation philosophy:
|
|
58
|
+
- Comments explain "why", never "what"
|
|
59
|
+
- Self-documenting code through good naming reduces comment need
|
|
60
|
+
- READMEs should have a quick-start that works in under 5 minutes
|
|
61
|
+
- API docs should show usage examples, not just signatures
|
|
62
|
+
|
|
63
|
+
### Step 3: Write documentation
|
|
64
|
+
|
|
65
|
+
For each documentation type:
|
|
66
|
+
|
|
67
|
+
**README**: Quick start first, then architecture, then contributing guide.
|
|
68
|
+
**API docs**: One example per endpoint/function. Show the happy path, then edge cases.
|
|
69
|
+
**Architecture**: Explain the "why" behind structural decisions. Include diagrams if helpful.
|
|
70
|
+
**Inline**: Only where the code's intent isn't obvious from reading it.
|
|
71
|
+
|
|
72
|
+
### Step 4: Verify accuracy
|
|
73
|
+
|
|
74
|
+
- Run any code examples to confirm they work
|
|
75
|
+
- Check that documented APIs match actual signatures
|
|
76
|
+
- Verify file paths and commands are correct
|
|
77
|
+
|
|
78
|
+
## Quality checks
|
|
79
|
+
|
|
80
|
+
- [ ] Quick-start section works end-to-end (if README)
|
|
81
|
+
- [ ] Code examples are runnable and correct
|
|
82
|
+
- [ ] Comments explain "why", not "what"
|
|
83
|
+
- [ ] No documentation for self-evident code
|
|
84
|
+
- [ ] Consistent terminology throughout
|
|
85
|
+
- [ ] File paths and commands verified
|
|
86
|
+
|
|
87
|
+
## Guardrail notes
|
|
88
|
+
|
|
89
|
+
Low risk. Documentation is additive. No approval needed unless modifying existing docs that others maintain.
|
|
90
|
+
`,
|
|
91
|
+
};
|
|
92
|
+
//# sourceMappingURL=documenting-code.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"documenting-code.js","sourceRoot":"","sources":["../../../../domains/development-agent/skills/documenting-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,kPAAkP;IAC/P,IAAI,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,SAAS,CAAC;IACjD,UAAU,EAAE,KAAc;IAC1B,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,mBAAmB,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC;IACzD,aAAa,EAAE,CAAC,aAAa,CAAC;IAC9B,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,SAAkB;IAEjC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEnB;CACA,CAAC"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Development Agent Skills Library
|
|
3
|
+
*
|
|
4
|
+
* Pre-built skills for software development agents.
|
|
5
|
+
*/
|
|
6
|
+
import { CodeReviewSkill } from './code-review.js';
|
|
7
|
+
import { RefactorPlanSkill } from './refactor-plan.js';
|
|
8
|
+
import { WritingTestsSkill } from './writing-tests.js';
|
|
9
|
+
import { DebuggingIssuesSkill } from './debugging-issues.js';
|
|
10
|
+
import { DocumentingCodeSkill } from './documenting-code.js';
|
|
11
|
+
export declare const DevelopmentAgentSkills: ({
|
|
12
|
+
skill_id: string;
|
|
13
|
+
name: string;
|
|
14
|
+
description: string;
|
|
15
|
+
tags: string[];
|
|
16
|
+
risk_level: "low";
|
|
17
|
+
required_tools: string[];
|
|
18
|
+
compatible_runtimes: string[];
|
|
19
|
+
feeds_into: string[];
|
|
20
|
+
pipeline_phase: string;
|
|
21
|
+
context_model: "inherit";
|
|
22
|
+
skill_md_content: string;
|
|
23
|
+
bundled_files: {
|
|
24
|
+
path: string;
|
|
25
|
+
description: string;
|
|
26
|
+
load_when: string;
|
|
27
|
+
content: string;
|
|
28
|
+
}[];
|
|
29
|
+
} | {
|
|
30
|
+
skill_id: string;
|
|
31
|
+
name: string;
|
|
32
|
+
description: string;
|
|
33
|
+
tags: string[];
|
|
34
|
+
risk_level: "med";
|
|
35
|
+
required_tools: string[];
|
|
36
|
+
compatible_runtimes: string[];
|
|
37
|
+
prerequisites: string[];
|
|
38
|
+
pipeline_phase: string;
|
|
39
|
+
context_model: "inherit";
|
|
40
|
+
skill_md_content: string;
|
|
41
|
+
} | {
|
|
42
|
+
skill_id: string;
|
|
43
|
+
name: string;
|
|
44
|
+
description: string;
|
|
45
|
+
tags: string[];
|
|
46
|
+
risk_level: "low";
|
|
47
|
+
required_tools: string[];
|
|
48
|
+
compatible_runtimes: string[];
|
|
49
|
+
prerequisites: string[];
|
|
50
|
+
pipeline_phase: string;
|
|
51
|
+
context_model: "inherit";
|
|
52
|
+
skill_md_content: string;
|
|
53
|
+
})[];
|
|
54
|
+
export { CodeReviewSkill, RefactorPlanSkill, WritingTestsSkill, DebuggingIssuesSkill, DocumentingCodeSkill, };
|
|
55
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../domains/development-agent/skills/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMlC,CAAC;AAEF,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,CAAC"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Development Agent Skills Library
|
|
3
|
+
*
|
|
4
|
+
* Pre-built skills for software development agents.
|
|
5
|
+
*/
|
|
6
|
+
import { CodeReviewSkill } from './code-review.js';
|
|
7
|
+
import { RefactorPlanSkill } from './refactor-plan.js';
|
|
8
|
+
import { WritingTestsSkill } from './writing-tests.js';
|
|
9
|
+
import { DebuggingIssuesSkill } from './debugging-issues.js';
|
|
10
|
+
import { DocumentingCodeSkill } from './documenting-code.js';
|
|
11
|
+
export const DevelopmentAgentSkills = [
|
|
12
|
+
CodeReviewSkill,
|
|
13
|
+
RefactorPlanSkill,
|
|
14
|
+
WritingTestsSkill,
|
|
15
|
+
DebuggingIssuesSkill,
|
|
16
|
+
DocumentingCodeSkill,
|
|
17
|
+
];
|
|
18
|
+
export { CodeReviewSkill, RefactorPlanSkill, WritingTestsSkill, DebuggingIssuesSkill, DocumentingCodeSkill, };
|
|
19
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../domains/development-agent/skills/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,oBAAoB;IACpB,oBAAoB;CACrB,CAAC;AAEF,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,CAAC"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Refactor Plan Skill
|
|
3
|
+
*
|
|
4
|
+
* Propose refactoring following user's engineering standards.
|
|
5
|
+
*/
|
|
6
|
+
export declare const RefactorPlanSkill: {
|
|
7
|
+
skill_id: string;
|
|
8
|
+
name: string;
|
|
9
|
+
description: string;
|
|
10
|
+
tags: string[];
|
|
11
|
+
risk_level: "med";
|
|
12
|
+
required_tools: string[];
|
|
13
|
+
compatible_runtimes: string[];
|
|
14
|
+
prerequisites: string[];
|
|
15
|
+
pipeline_phase: string;
|
|
16
|
+
context_model: "inherit";
|
|
17
|
+
skill_md_content: string;
|
|
18
|
+
};
|
|
19
|
+
//# sourceMappingURL=refactor-plan.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"refactor-plan.d.ts","sourceRoot":"","sources":["../../../../domains/development-agent/skills/refactor-plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CA+G7B,CAAC"}
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Refactor Plan Skill
|
|
3
|
+
*
|
|
4
|
+
* Propose refactoring following user's engineering standards.
|
|
5
|
+
*/
|
|
6
|
+
export const RefactorPlanSkill = {
|
|
7
|
+
skill_id: 'refactor-plan',
|
|
8
|
+
name: 'Refactor Plan',
|
|
9
|
+
description: 'Analyzes code and proposes structured refactoring plans following engineering principles. Use when code has technical debt, architecture needs to evolve, or the user asks to refactor, restructure, or clean up code.',
|
|
10
|
+
tags: ['development', 'refactoring', 'architecture'],
|
|
11
|
+
risk_level: 'med',
|
|
12
|
+
required_tools: ['file-system'],
|
|
13
|
+
compatible_runtimes: ['claude-code', 'openclaw', 'manus'],
|
|
14
|
+
prerequisites: ['code-review'],
|
|
15
|
+
pipeline_phase: 'process',
|
|
16
|
+
context_model: 'inherit',
|
|
17
|
+
skill_md_content: `# Refactor Plan
|
|
18
|
+
|
|
19
|
+
## Purpose
|
|
20
|
+
|
|
21
|
+
Analyze existing code and propose a structured refactoring plan that improves code quality while aligning with the user's engineering principles and standards.
|
|
22
|
+
|
|
23
|
+
## When to use
|
|
24
|
+
|
|
25
|
+
- Code has accumulated technical debt
|
|
26
|
+
- Architecture needs to evolve for new requirements
|
|
27
|
+
- Readability or maintainability needs improvement
|
|
28
|
+
- Preparing for a major feature that requires cleaner foundations
|
|
29
|
+
|
|
30
|
+
## When NOT to use
|
|
31
|
+
|
|
32
|
+
- For cosmetic-only changes (formatting, naming) — use linter
|
|
33
|
+
- When the user wants a code review without changes — use code-review
|
|
34
|
+
- For greenfield development (no existing code to refactor)
|
|
35
|
+
|
|
36
|
+
## Inputs
|
|
37
|
+
|
|
38
|
+
- **target**: File paths or module to refactor
|
|
39
|
+
- **goal**: What the refactoring should achieve (readability, performance, extensibility, etc.)
|
|
40
|
+
- **constraints**: Things that must not change (public API, behavior, etc.)
|
|
41
|
+
- **budget**: Scope limit (small: single file, medium: module, large: cross-cutting)
|
|
42
|
+
|
|
43
|
+
## Outputs
|
|
44
|
+
|
|
45
|
+
- **plan**: Structured refactoring plan with:
|
|
46
|
+
- **assessment**: Current state analysis and identified problems
|
|
47
|
+
- **steps**: Ordered list of refactoring steps, each with:
|
|
48
|
+
- description of the change
|
|
49
|
+
- files affected
|
|
50
|
+
- risk level
|
|
51
|
+
- estimated scope
|
|
52
|
+
- **principle_alignment**: How the refactoring serves user's engineering principles
|
|
53
|
+
- **risks**: What could go wrong and mitigation strategies
|
|
54
|
+
- **testing_strategy**: How to verify the refactoring didn't break anything
|
|
55
|
+
|
|
56
|
+
## Procedure
|
|
57
|
+
|
|
58
|
+
### Step 1: Analyze current state
|
|
59
|
+
|
|
60
|
+
- Read the target code thoroughly
|
|
61
|
+
- Map dependencies (what depends on this code, what it depends on)
|
|
62
|
+
- Identify code smells and structural issues
|
|
63
|
+
- Note what works well (don't refactor unnecessarily)
|
|
64
|
+
|
|
65
|
+
### Step 2: Align with principles
|
|
66
|
+
|
|
67
|
+
- Review user's engineering principles
|
|
68
|
+
- Determine which principles the refactoring should serve
|
|
69
|
+
- Ensure the proposed changes don't violate other principles
|
|
70
|
+
|
|
71
|
+
### Step 3: Design the refactoring
|
|
72
|
+
|
|
73
|
+
- Break into small, independently testable steps
|
|
74
|
+
- Order steps to minimize risk (safest changes first)
|
|
75
|
+
- Identify which steps require approval (behavior changes, API changes)
|
|
76
|
+
- Ensure each step leaves the code in a working state
|
|
77
|
+
|
|
78
|
+
### Step 4: Assess risks
|
|
79
|
+
|
|
80
|
+
- What tests exist? What's the coverage?
|
|
81
|
+
- What downstream dependencies could break?
|
|
82
|
+
- Is there a rollback strategy?
|
|
83
|
+
|
|
84
|
+
### Step 5: Present the plan
|
|
85
|
+
|
|
86
|
+
Structure the plan so the user can approve step-by-step. Each step should be independently executable.
|
|
87
|
+
|
|
88
|
+
## Quality checks
|
|
89
|
+
|
|
90
|
+
- [ ] Current state thoroughly analyzed
|
|
91
|
+
- [ ] All affected files identified
|
|
92
|
+
- [ ] Steps are ordered by risk (safest first)
|
|
93
|
+
- [ ] Each step leaves code in a working state
|
|
94
|
+
- [ ] Testing strategy covers refactored code
|
|
95
|
+
- [ ] Plan aligns with user's engineering principles
|
|
96
|
+
- [ ] Risks identified with mitigation strategies
|
|
97
|
+
|
|
98
|
+
## Guardrail notes
|
|
99
|
+
|
|
100
|
+
Medium risk — the plan itself is read-only, but executing it modifies code. The plan should be reviewed before execution. Each step with risk_level >= medium requires approval.
|
|
101
|
+
|
|
102
|
+
## Progressive Disclosure
|
|
103
|
+
|
|
104
|
+
### Minimal Context (Always Load)
|
|
105
|
+
- Purpose: Propose refactoring plans aligned with engineering principles
|
|
106
|
+
- When to use: Technical debt, architecture evolution, maintainability improvement
|
|
107
|
+
|
|
108
|
+
### On Invoke (Load When Skill is Invoked)
|
|
109
|
+
- Full analysis and planning procedure
|
|
110
|
+
- Risk assessment and testing strategy requirements
|
|
111
|
+
|
|
112
|
+
### On Demand Resources
|
|
113
|
+
- Refactoring pattern catalog
|
|
114
|
+
- Risk mitigation strategies
|
|
115
|
+
`
|
|
116
|
+
};
|
|
117
|
+
//# sourceMappingURL=refactor-plan.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"refactor-plan.js","sourceRoot":"","sources":["../../../../domains/development-agent/skills/refactor-plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,eAAe;IACzB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,wNAAwN;IACrO,IAAI,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,cAAc,CAAC;IACpD,UAAU,EAAE,KAAc;IAC1B,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,mBAAmB,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC;IACzD,aAAa,EAAE,CAAC,aAAa,CAAC;IAC9B,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,SAAkB;IAEjC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkGnB;CACA,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Writing Tests Skill
|
|
3
|
+
*
|
|
4
|
+
* Generate tests following user's testing philosophy and quality bar.
|
|
5
|
+
*/
|
|
6
|
+
export declare const WritingTestsSkill: {
|
|
7
|
+
skill_id: string;
|
|
8
|
+
name: string;
|
|
9
|
+
description: string;
|
|
10
|
+
tags: string[];
|
|
11
|
+
risk_level: "low";
|
|
12
|
+
required_tools: string[];
|
|
13
|
+
compatible_runtimes: string[];
|
|
14
|
+
prerequisites: string[];
|
|
15
|
+
feeds_into: string[];
|
|
16
|
+
pipeline_phase: string;
|
|
17
|
+
context_model: "inherit";
|
|
18
|
+
skill_md_content: string;
|
|
19
|
+
};
|
|
20
|
+
//# sourceMappingURL=writing-tests.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"writing-tests.d.ts","sourceRoot":"","sources":["../../../../domains/development-agent/skills/writing-tests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAuF7B,CAAC"}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Writing Tests Skill
|
|
3
|
+
*
|
|
4
|
+
* Generate tests following user's testing philosophy and quality bar.
|
|
5
|
+
*/
|
|
6
|
+
export const WritingTestsSkill = {
|
|
7
|
+
skill_id: 'writing-tests',
|
|
8
|
+
name: 'Writing Tests',
|
|
9
|
+
description: 'Generates tests following the user\'s testing philosophy, coverage expectations, and quality bar. Use when writing tests for new features, adding regression tests for bugs, improving test coverage, or when the user asks to test, add tests, or verify code.',
|
|
10
|
+
tags: ['development', 'testing', 'quality'],
|
|
11
|
+
risk_level: 'low',
|
|
12
|
+
required_tools: ['file-system'],
|
|
13
|
+
compatible_runtimes: ['claude-code', 'openclaw', 'manus'],
|
|
14
|
+
prerequisites: ['code-review'],
|
|
15
|
+
feeds_into: ['refactor-plan'],
|
|
16
|
+
pipeline_phase: 'verify',
|
|
17
|
+
context_model: 'inherit',
|
|
18
|
+
skill_md_content: `# Writing Tests
|
|
19
|
+
|
|
20
|
+
## Purpose
|
|
21
|
+
|
|
22
|
+
Generates tests that follow the user's testing philosophy, preferred frameworks, naming conventions, and coverage expectations.
|
|
23
|
+
|
|
24
|
+
## When to use
|
|
25
|
+
|
|
26
|
+
- Writing tests for new features or modules
|
|
27
|
+
- Adding regression tests for bug fixes (TDD: write failing test first)
|
|
28
|
+
- Improving test coverage on critical paths
|
|
29
|
+
- When the user asks to "test this", "add tests", or "verify"
|
|
30
|
+
|
|
31
|
+
## When NOT to use
|
|
32
|
+
|
|
33
|
+
- For manual QA or exploratory testing (out of scope)
|
|
34
|
+
- When tests already exist and just need running (use the test runner directly)
|
|
35
|
+
- For performance benchmarking (use profiling tools)
|
|
36
|
+
|
|
37
|
+
## Inputs
|
|
38
|
+
|
|
39
|
+
- **target**: File paths or module to test
|
|
40
|
+
- **focus**: What aspect to test (behavior, edge cases, integration, regression)
|
|
41
|
+
- **framework**: Test framework if known (vitest, jest, mocha, pytest, go test, etc.)
|
|
42
|
+
|
|
43
|
+
## Outputs
|
|
44
|
+
|
|
45
|
+
- **test_files**: One or more test files following project conventions
|
|
46
|
+
- **coverage_summary**: Which critical paths are now covered
|
|
47
|
+
|
|
48
|
+
## Procedure
|
|
49
|
+
|
|
50
|
+
### Step 1: Understand what to test
|
|
51
|
+
|
|
52
|
+
- Read the target code and its public API
|
|
53
|
+
- Identify the behavior contract (what it promises to do)
|
|
54
|
+
- Note edge cases, error paths, and boundary conditions
|
|
55
|
+
- Check existing tests for patterns and conventions
|
|
56
|
+
|
|
57
|
+
### Step 2: Choose test strategy
|
|
58
|
+
|
|
59
|
+
Based on user's testing philosophy:
|
|
60
|
+
- **Unit tests**: For pure functions and isolated logic
|
|
61
|
+
- **Integration tests**: For cross-module interactions and real dependencies
|
|
62
|
+
- **Regression tests**: For specific bugs (write the failing case first)
|
|
63
|
+
|
|
64
|
+
Prefer testing behavior over implementation details. A test that breaks when you refactor internals is worse than no test.
|
|
65
|
+
|
|
66
|
+
### Step 3: Write tests
|
|
67
|
+
|
|
68
|
+
- Follow project naming conventions for test files and test names
|
|
69
|
+
- Use descriptive test names that explain the expected behavior
|
|
70
|
+
- Structure: Arrange (setup) -> Act (execute) -> Assert (verify)
|
|
71
|
+
- One logical assertion per test (multiple expect calls are fine if testing one behavior)
|
|
72
|
+
|
|
73
|
+
### Step 4: Verify tests
|
|
74
|
+
|
|
75
|
+
- Run the test suite to confirm tests pass
|
|
76
|
+
- Intentionally break the target code to verify tests catch it
|
|
77
|
+
- Check that test names read as documentation
|
|
78
|
+
|
|
79
|
+
## Quality checks
|
|
80
|
+
|
|
81
|
+
- [ ] Tests cover the critical path (happy path)
|
|
82
|
+
- [ ] At least one edge case or error path tested
|
|
83
|
+
- [ ] Test names describe expected behavior, not implementation
|
|
84
|
+
- [ ] Tests follow project conventions (naming, file location, framework)
|
|
85
|
+
- [ ] Tests are independent (no shared mutable state between tests)
|
|
86
|
+
- [ ] No implementation details tested (tests survive refactoring)
|
|
87
|
+
|
|
88
|
+
## Guardrail notes
|
|
89
|
+
|
|
90
|
+
Low risk. Tests are additive and don't modify production code. No approval needed.
|
|
91
|
+
`,
|
|
92
|
+
};
|
|
93
|
+
//# sourceMappingURL=writing-tests.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"writing-tests.js","sourceRoot":"","sources":["../../../../domains/development-agent/skills/writing-tests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,eAAe;IACzB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,iQAAiQ;IAC9Q,IAAI,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC;IAC3C,UAAU,EAAE,KAAc;IAC1B,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,mBAAmB,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC;IACzD,aAAa,EAAE,CAAC,aAAa,CAAC;IAC9B,UAAU,EAAE,CAAC,eAAe,CAAC;IAC7B,cAAc,EAAE,QAAQ;IACxB,aAAa,EAAE,SAAkB;IAEjC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEnB;CACA,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* General Agent Domain
|
|
3
|
+
*
|
|
4
|
+
* Broad domain for operators who want one adaptable assistant that can
|
|
5
|
+
* plan, research, execute, and report across mixed workflows.
|
|
6
|
+
*/
|
|
7
|
+
import { DomainDefinition } from '../types.js';
|
|
8
|
+
export declare const GeneralAgentDomain: DomainDefinition;
|
|
9
|
+
//# sourceMappingURL=domain.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../domains/general-agent/domain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,kBAAkB,EAAE,gBA4BhC,CAAC"}
|